Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? PPC
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

PING Networking
Purpose: To check the quality of a network link or verify the connection of a machine to the Internet.
Format: PING [-c | COUNT <count>] [-d | DEBUG] [-i | INTERVAL <interval>]
[-l | LOAD <load>] [-n | NUMERIC | NUMERICONLY] [-q | QUIET]
[-r | RECORDROUTE] [DONTROUTE] [-s | SIZE <padsize>]
[-v | VERBOSE] [BELL] <hostname>
Template: -c=COUNT/K/N, -d=DEBUG/S, -i=INTERVAL/K/N, -l=LOAD/K/N,
-n=NUMERIC=NUMERICONLY/S, -q=QUIET/S,
-r=RECORDROUTE/S, DONTROUTE/S, -s=SIZE/K/N,
-v=VERBOSE/S, BELL/S, HOST/A
Path: C:ping
PING uses the ICMP protocol's ECHO_REQUEST datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway. ECHO_REQUEST datagrams ('pings') have an IP and ICMP header, followed by a 'struct timeval', (making 8 bytes in all) and then an arbitary number of 'pad' bytes used to fill out the packet.

The <hostname> argument is mandatory in order to know which host or gateway to ping, all other arguments have default values. The other arguments are as follows:

-c | COUNT <count> Instructs PING to stop after sending (and receiving) <count> ECHO_RESPONSE packets. If this argument is not specified, it will continue until you stop it using Ctrl+C.
-d | DEBUG Sets the SO_DEBUG option on the socket being used.
-i | INTERVAL <interval> Specifies the wait <interval>, in seconds, between sending each packet. The default is to wait for one second between each packet.
-l | LOAD <load> If LOAD is specified PING sends <load> packets as fast as possible before falling into its normal mode of behaviour.
-n | NUMERIC | NUMERICONLY If specified sends numeric output only. There is no attempt to look up symbolic names for host addresses.
-q | QUIET Quiet output. Nothing is displayed except the summary lines at startup time and when finished.
-r | RECORDROUTE Includes the RECORD_ROUTE option in the ECHO_REQUEST packet and displays the route buffer on return requests. Note that the IP header is only large enough for nine such routes. Many hosts ignore or discard this option.
DONTROUTE Bypass the normal routing tables and send directly to a host on an attached network. If the host is not on a directly attached network, an error is returned. This option can be used to ping a local host through an interface that has no route through it.
-s | SIZE <padsize> Specifies the number of 'pad' bytes to be sent with each request. The default is 56 bytes, which translates into 64 bytes when combined with the 8 bytes of the ICMP header data.
-v | VERBOSE When Verbose output is specified, ICMP packets, other than ECHO_RESPONSE, that are received are listed.
BELL Sets an audible alert when an error occurs.

Example:

  3.OS4:> PING -c 3 192.168.01
  PING 192.168.0.1) (192.168.0.1): 56 data bytes
  64 bytes from 192.168.0.1: icmp_seq=0 ttl=64 time=4.718 ms
  64 bytes from 192.168.0.1: icmp_seq=1 ttl=64 time=0.932 ms
  64 bytes from 192.168.0.1: icmp_seq=2 ttl=64 time=0.919 ms

  --- 192.168.0.1 ping statistics ---
  3 packets transmitted, 3 packets received, 0 duplicates, 0% packet loss
  round-trip min/avg/max = 0.919/2.189/4.718 ms


Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.


Copyright 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.