man(1) Manual page archive


     PING(8)                                                   PING(8)

     NAME
          ping, gping, traceroute, hogports - probe the Internet

     SYNOPSIS
          ping [ -d ] [ -i interval ] [ -s size ] [ -n count ]
          destination

          gping [ -r ] [ -l ] [ -i interval ] destination [
          destination ... ]

          traceroute [ -dn ][ -t tries ] dest

          hogports [mtpt/]proto!address!startport[-endport]

     DESCRIPTION
          Ping sends ICMP echo requests to a system and returns the
          time for a response.  It can be used to determine the net-
          work delay and whether or not the destination is up.

          The options are:

          n    requests that a total of count messages be sent,
               default 32.

          i    sets the time between messages to be interval millisec-
               onds, default 1000 ms.

          s    sets the length of the message to be size bytes, ICMP
               header included.  The size cannot be smaller than 32 or
               larger than 8192.  The default is 64.

          d    causes message numbers to be printed so that one can
               see the order with which messages are received and
               which are lost.

          Gping is a ping with a graphical display.  It presents sepa-
          rate graphs for each destination specified.

          The options are:

          r    display round trip time in seconds.  This is the
               default.

          l    display percentage of lost messages.  A message is con-
               sidered lost if not replied to in 10 seconds.  The per-
               centage is an exponentially weighted average.

          i    sets the time between messages to be interval millisec-
               onds, default 5000 ms.

     PING(8)                                                   PING(8)

          Graphs can be dropped and added using the button 3 menu.
          Clicking button 1 on a datapoint displays the value of the
          datapoint and the time it was recorded.

          Traceroute displays the IP addresses and average round trip
          times to all routers between the machine it is run on and
          dest. It does this by sending packets to dest with increas-
          ing times to live (TTL) in their headers.  Each router that
          a packet expires at replies with an ICMP warning message.
          The options are:

          d    print debugging to standard error

          n    just print out IP numbers, don't try to look up the
               names of the routers.

          t    send tries packets at each TTL value (default 1).

          Hogports announces on a range of ports to keep them from
          other processes.  For example, to keep anyone from making a
          vncserver visible on the network mounted at /net.alt:

               ip/hogports /net.alt/tcp!*!5900-5950

     SOURCE
          /sys/src/cmd/ip/ping.c
          /sys/src/cmd/ip/gping.c
          /sys/src/cmd/ip/traceroute.c
          /sys/src/cmd/ip/hogports.c