home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / comms / a / freenet / !FreeNet_Docs_Ping < prev    next >
Encoding:
Text File  |  1994-12-03  |  10.8 KB  |  279 lines
  1. December 11, 1993                   PING                        (BSD 4.4)
  2.  
  3. This following is a hand translation of the man page that comes with the
  4. BSD 4.4 ping. The original man page is also included for those with the
  5. means to do a better formatting job. - Adam
  6.  
  7.          ***************** VERY IMPORTANT *****************
  8.  
  9. DO NOT USE THE FLOOD PING OR PRELOAD PING FACILITIES UNLESS YOU ARE
  10. AUTHORISED TO DO SO, AND ONLY THEN WHEN THERE IS A *VERY* GOOD REASON.
  11. USE OF THESE TWO FACILITIES WILL PUT A VERY HEAVY STRAIN ON A NETWORK.
  12.  
  13.  
  14.  ------------------
  15.  
  16.  Copyright (c) 1985, 1991, 1993
  17.     The Regents of the University of California.  All rights reserved.
  18.  
  19.  This product includes software developed by the University of
  20.  California, Berkeley and its contributors.
  21.  
  22.  THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND
  23.  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25.  ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26.  FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27.  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28.  OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29.  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30.  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31.  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32.  SUCH DAMAGE.
  33.  
  34.  ------------------
  35.  
  36.  
  37. ping - send ICMP ECHO_REQUEST packets to network hosts
  38.  
  39. ping -dfLnqRrv
  40.   -c <count> -I <ifaddr> -i <wait> -l <preload> -p <pattern> -s <packetsize>
  41.   -t <ttl> <host>
  42.  
  43. DESCRIPTION
  44.  
  45. Ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to elicit
  46. an ICMP ECHO_RESPONSE from a host or gateway.
  47.  
  48. ECHO_REQUEST datagrams ("pings") have an IP and ICMP header, followed by
  49. a struct timeval and then an arbitrary number of "pad" bytes used to
  50. fill out the packet.
  51.  
  52. The options are as follows:
  53.  
  54.   c <count>   Stop after sending (and receiving) <count> ECHO_RESPONSE
  55.               packets.
  56.  
  57.   d           Set the SO_DEBUG option on the socket being used.
  58.  
  59.   f           Flood ping.
  60.               Outputs packets as fast as they come back or one hundred
  61.               times per second, whichever is more. For every
  62.               ECHO_REQUEST sent a period "." is printed, while for every
  63.               ECHO_REPLY received a backspace is printed. This provides
  64.               a rapid display of how many packets are being dropped.
  65.               Only the super-user may use this option.
  66.  
  67.               This can be very hard on a network and should be used with
  68.               caution.
  69.  
  70.   *****       DO NOT USE THIS UNLESS YOU ARE AUTHORISED TO DO SO AND HAVE
  71.               A VERY GOOD REASON. - Adam
  72.  
  73.  
  74.   i <wait>    Wait <wait> seconds between sending each packet.
  75.               The default is to wait for one second between each packet.
  76.               This option is incompatible with the f option.
  77.  
  78.   l <preload> If preload is specified, ping sends that many packets as
  79.               fast as possible before falling into its normal mode of
  80.               behavior.
  81.               
  82.   *****       AVOID THIS TOO! - Adam
  83.  
  84.   n           Numeric output only.
  85.               No attempt will be made to lookup symbolic names for host
  86.               addresses.
  87.  
  88.   p <pattern> You may specify up to 16 "pad" bytes to fill out the
  89.               packet you send.
  90.  
  91.               This is useful for diagnosing data-dependent problems in a
  92.               network. For example, -p ff will cause the sent packet to
  93.               be filled with all ones.
  94.  
  95.   q           Quiet output.
  96.               Nothing is displayed except the summary lines at startup
  97.               time and when finished.
  98.  
  99.   R           Record route.
  100.               Includes the RECORD_ROUTE option in the ECHO_REQUEST
  101.               packet and displays the route buffer on returned packets.
  102.  
  103.               Note that the IP header is only large enough for nine such
  104.               routes. Many hosts ignore or discard this option.
  105.  
  106.   r           Bypass the normal routing tables and send directly to a
  107.               host on an attached network.
  108.  
  109.               If the host is not on a directly-attached network, an
  110.               error is returned. This option can be used to ping a local
  111.               host through an interface that has no route through it
  112.               (e.g., after the interface was dropped by routed).
  113.  
  114.   s <size>    Specifies the number of data bytes to be sent.  
  115.               The default is 56, which translates into 64 ICMP data
  116.               bytes when combined with the 8 bytes of ICMP header data.
  117.  
  118.   v           Verbose output.
  119.               ICMP packets other than ECHO_RESPONSE that are received
  120.               are listed.
  121.  
  122.  
  123. In addition, the following options may be used for multicast pings:
  124.  
  125.   I <ifaddr>  Transmit using the specified interface address.
  126.  
  127.   L           Disable the loopback, so the transmitting host doesn't see
  128.               the ICMP requests.
  129.  
  130.   t <ttl>     Use the specified time-to-live.
  131.  
  132. Note: these have no effect available in this Risc OS release as
  133. multicasting is not supported. However, should multicasting be
  134. supportted in future, I will re-enable this code. - Adam
  135.  
  136.  
  137. When using ping for fault isolation, it should first be run on the local
  138. host, to verify that the local network interface is up and running.
  139.  
  140. Then, hosts and gateways further and further away should be "pinged".
  141. Round-trip times and packet loss statistics are computed. If duplicate
  142. packets are received, they are not included in the packet loss
  143. calculation, although the round trip time of these packets is used in
  144. calculating the minimum/average/maximum round-trip time numbers. When
  145. the specified number of packets have been sent (and received) or if the
  146. program is terminated with ESCAPE a brief summary is displayed.
  147.  
  148. This program is intended for use in network testing, measurement and
  149. management. Because of the load it can impose on the network, it is
  150. unwise to use ping during normal operations or from automated scripts.
  151.  
  152.  
  153. ICMP PACKET DETAILS
  154.  
  155. An IP header without options is 20 bytes. An ICMP ECHO_REQUEST packet
  156. contains an additional 8 bytes worth of ICMP header followed by an
  157. arbitrary amount of data. When a packetsize is given, this indicated the
  158. size of this extra piece of data (the default is 56). Thus the amount of
  159. data received inside of an IP packet of type ICMP ECHO_REPLY will always
  160. be 8 bytes more than the requested data space (the ICMP header).
  161.  
  162. If the data space is at least eight bytes large, ping uses the first
  163. eight bytes of this space to include a timestamp which it uses in the
  164. computation of round trip times. If less than eight bytes of pad are
  165. specified, no round trip times are given.
  166.  
  167.  
  168. DUPLICATE AND DAMAGED PACKETS
  169.  
  170. Ping will report duplicate and damaged packets. Duplicate packets should
  171. never occur, and seem to be caused by inappropriate link-level
  172. retransmissions. Duplicates may occur in many situations and are rarely
  173. (if ever) a good sign, although the presence of low levels of duplicates
  174. may not always be cause for alarm.
  175.  
  176. Damaged packets are obviously serious cause for alarm and often indicate
  177. broken hardware somewhere in the ping packet's path (in the network or
  178. in the hosts).
  179.  
  180.  
  181. TRYING DIFFERENT DATA PATTERNS
  182.  
  183. The (inter)network layer should never treat packets differently
  184. depending on the data contained in the data portion. Unfortunately,
  185. data-dependent problems have been known to sneak into networks and
  186. remain undetected for long periods of time. In many cases the particular
  187. pattern that will have problems is something that doesn't have
  188. sufficient "transitions", such as all ones or all zeros, or a pattern
  189. right at the edge, such as almost all zeros. It isn't necessarily enough
  190. to specify a data pattern of all zeros (for example) on the command line
  191. because the pattern that is of interest is at the data link level, and
  192. the relationship between what you type and what the controllers transmit
  193. can be complicated.
  194.  
  195. This means that if you have a data-dependent problem you will probably
  196. have to do a lot of testing to find it. If you are lucky, you may manage
  197. to find a file that either can't be sent across your network or that
  198. takes much longer to transfer than other similar length files. You can
  199. then examine this file for repeated patterns that you can test using the
  200. p option of ping.
  201.  
  202. TTL DETAILS
  203.  
  204. The TTL value of an IP packet represents the maximum number of IP routers
  205. that the packet can go through before being thrown away.
  206. In current practice you can expect each router in the Internet to decrement
  207. the TTL field by exactly one.
  208.  
  209. The TCP/IP specification states that the TTL field for TCP packets should
  210. be set to 60, but many systems use smaller values (4.3 BSD uses 30, 4.2 used
  211. 15).
  212.  
  213. The maximum possible value of this field is 255, and most Unix systems set
  214. the TTL field of ICMP ECHO_REQUEST packets to 255.
  215. This is why you will find you can "ping" some hosts, but not reach them
  216. with telnet or ftp.
  217.  
  218. In normal operation ping prints the ttl value from the packet it receives.
  219. When a remote system receives a ping packet, it can do one of three things
  220. with the TTL field in its response:
  221.  
  222.   o  Not change it; this is what Berkeley Unix systems did before the
  223.      4.3 tahoe release.
  224.  
  225.   o  In this case the TTL value in the received packet will be 255 minus
  226.      the number of routers in the round-trip path.
  227.  
  228.   o  Set it to 255; this is what current Berkeley Unix systems do. In
  229.      this case the TTL value in the received packet will be 255 minus
  230.      the number of routers in the path from the remote system to the
  231.      pinging host.
  232.  
  233.   o  Set it to some other value. Some machines use the same value for
  234.      ICMP packets that they use for TCP packets, for example either 30
  235.      or 60. Others may use completely wild values.
  236.  
  237.  
  238. BUGS
  239.  
  240. Many Hosts and Gateways ignore the RECORD_ROUTE option.
  241.  
  242. The maximum IP header length is too small for options like RECORD_ROUTE
  243. to be completely useful. There's not much that that can be done about
  244. this, however.
  245.  
  246. Flood pinging is not recommended in general, and flood pinging the
  247. broadcast address should only be done under very controlled conditions.
  248.  
  249.  
  250. SEE ALSO
  251.  
  252. netstat, ifconfig, routed.
  253.  
  254.  
  255. HISTORY
  256.  
  257. The command appeared in BSD 4.3.
  258.  
  259.  ------------------
  260.  
  261.          ***************** VERY IMPORTANT *****************
  262.  
  263. DO NOT USE THE FLOOD PING OR PRELOAD PING FACILITIES UNLESS YOU ARE
  264. AUTHORISED TO DO SO, AND ONLY THEN WHEN THERE IS A *VERY* GOOD REASON.
  265. USE OF THESE TWO FACILITIES WILL PUT A VERY HEAVY STRAIN ON A NETWORK.
  266.  
  267.  ------------------
  268.  
  269. Ported to Risc OS by Adam Goodfellow. 03 Dec 1994.
  270.  
  271. Other Acorn TCP/IP compatible ports from NetBSD 4.4:
  272.     traceroute    Route tracing utility *
  273.     resolve        cacheing resolver
  274.  
  275.  
  276. * this requires the internet module to be patched in order to fix a
  277. bug/defficiency with raw IP sockets in NetBSD 4.3. This patch is
  278. included with traceroute.
  279.