doc/html/ref/net-common-standalone-tests.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Standalone Tests</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="Tests and Demonstrations"
  23 HREF="net-common-tests-and-demonstrations.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Building the Network Tests"
  26 HREF="net-common-building-the-network-tests.html"><LINK
  27 REL="NEXT"
  28 TITLE="Performance Test"
  29 HREF="net-common-performance-test.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="net-common-building-the-network-tests.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 36. Tests and Demonstrations</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="net-common-performance-test.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="NET-COMMON-STANDALONE-TESTS">Standalone Tests</H1
  86 ><TABLE
  87 BORDER="5"
  88 BGCOLOR="#E0E0F0"
  89 WIDTH="70%"
  90 ><TR
  91 ><TD
  92 ><PRE
  93 CLASS="PROGRAMLISTING"
  94 ><SPAN
  95 CLASS="emphasis"
  96 ><I
  97 CLASS="EMPHASIS"
  98 >socket_test</I
  99 ></SPAN
 100 > - trivial test of socket creation API
 101 <SPAN
 102 CLASS="emphasis"
 103 ><I
 104 CLASS="EMPHASIS"
 105 >mbuf_test</I
 106 ></SPAN
 107 > - trivial test of mbuf allocation API</PRE
 108 ></TD
 109 ></TR
 110 ></TABLE
 111 ><P
 112 >These two do not communicate over the net; they just perform
 113 simple API tests then exit.</P
 114 ><TABLE
 115 BORDER="5"
 116 BGCOLOR="#E0E0F0"
 117 WIDTH="70%"
 118 ><TR
 119 ><TD
 120 ><PRE
 121 CLASS="PROGRAMLISTING"
 122 ><SPAN
 123 CLASS="emphasis"
 124 ><I
 125 CLASS="EMPHASIS"
 126 >ftp_test</I
 127 ></SPAN
 128 >      - simple FTP test, connects to &#8220;server&#8221;</PRE
 129 ></TD
 130 ></TR
 131 ></TABLE
 132 ><P
 133 >This test initializes the interface(s) then connects to the
 134 FTP server on the &#8220;server&#8221; machine for for each
 135 active interface in turn, confirms that the connection was successful,
 136 disconnects and exits.  This tests interworking with the server.</P
 137 ><TABLE
 138 BORDER="5"
 139 BGCOLOR="#E0E0F0"
 140 WIDTH="70%"
 141 ><TR
 142 ><TD
 143 ><PRE
 144 CLASS="PROGRAMLISTING"
 145 ><SPAN
 146 CLASS="emphasis"
 147 ><I
 148 CLASS="EMPHASIS"
 149 >ping_test</I
 150 ></SPAN
 151 >      - pings &#8220;server&#8221; and non-existent host to test timeout</PRE
 152 ></TD
 153 ></TR
 154 ></TABLE
 155 ><P
 156 >This test initializes the interface(s) then pings the server
 157 machine in the standard way, then pings address &#8220;32 up&#8221; from
 158 the server in the expectation that there is no machine there.  This
 159 confirms that the successful ping is not a false positive, and tests
 160 the receive timeout.  If there is such a machine, of course the
 161 2nd set of pings succeeds, confirming that we can talk to a machine
 162 not previously mentioned by configuration or by bootp. It then does
 163 the same thing on the other interface, eth1.</P
 164 ><TABLE
 165 BORDER="5"
 166 BGCOLOR="#E0E0F0"
 167 WIDTH="70%"
 168 ><TR
 169 ><TD
 170 ><PRE
 171 CLASS="PROGRAMLISTING"
 172 ><SPAN
 173 CLASS="emphasis"
 174 ><I
 175 CLASS="EMPHASIS"
 176 >dhcp_test</I
 177 ></SPAN
 178 >    - ping test, but also manipulates DHCP leases</PRE
 179 ></TD
 180 ></TR
 181 ></TABLE
 182 ><P
 183 >This test is very similar to the ping test, but in addition,
 184 provided the network package is not configured to do this automatically,
 185 it manually relinquishes and reclaims DHCP leases for all available
 186 interfaces. This tests the external API to DHCP. See section below
 187 describing this.</P
 188 ><TABLE
 189 BORDER="5"
 190 BGCOLOR="#E0E0F0"
 191 WIDTH="70%"
 192 ><TR
 193 ><TD
 194 ><PRE
 195 CLASS="PROGRAMLISTING"
 196 ><SPAN
 197 CLASS="emphasis"
 198 ><I
 199 CLASS="EMPHASIS"
 200 >flood</I
 201 ></SPAN
 202 >        - a flood ping test; use with care</PRE
 203 ></TD
 204 ></TR
 205 ></TABLE
 206 ><P
 207 >This test performs pings on all interfaces as quickly as possible,
 208 and only prints status information periodically. Flood pinging is
 209 bad for network performance; so do not use this test on general
 210 purpose networks unless protected by a switch.</P
 211 ></DIV
 212 ><DIV
 213 CLASS="NAVFOOTER"
 214 ><HR
 215 ALIGN="LEFT"
 216 WIDTH="100%"><TABLE
 217 SUMMARY="Footer navigation table"
 218 WIDTH="100%"
 219 BORDER="0"
 220 CELLPADDING="0"
 221 CELLSPACING="0"
 222 ><TR
 223 ><TD
 224 WIDTH="33%"
 225 ALIGN="left"
 226 VALIGN="top"
 227 ><A
 228 HREF="net-common-building-the-network-tests.html"
 229 ACCESSKEY="P"
 230 >Prev</A
 231 ></TD
 232 ><TD
 233 WIDTH="34%"
 234 ALIGN="center"
 235 VALIGN="top"
 236 ><A
 237 HREF="ecos-ref.html"
 238 ACCESSKEY="H"
 239 >Home</A
 240 ></TD
 241 ><TD
 242 WIDTH="33%"
 243 ALIGN="right"
 244 VALIGN="top"
 245 ><A
 246 HREF="net-common-performance-test.html"
 247 ACCESSKEY="N"
 248 >Next</A
 249 ></TD
 250 ></TR
 251 ><TR
 252 ><TD
 253 WIDTH="33%"
 254 ALIGN="left"
 255 VALIGN="top"
 256 >Building the Network Tests</TD
 257 ><TD
 258 WIDTH="34%"
 259 ALIGN="center"
 260 VALIGN="top"
 261 ><A
 262 HREF="net-common-tests-and-demonstrations.html"
 263 ACCESSKEY="U"
 264 >Up</A
 265 ></TD
 266 ><TD
 267 WIDTH="33%"
 268 ALIGN="right"
 269 VALIGN="top"
 270 >Performance Test</TD
 271 ></TR
 272 ></TABLE
 273 ></DIV
 274 ></BODY
 275 ></HTML
 276 >