.TH PING 8.SH NAMEping, gping, traceroute, hogports \- probe the Internet.SH SYNOPSIS.B ip/ping[.B -6aflqr] [.B -i.I interval] [.B -n.I count] [.B -s.I size] [.B -w.I waittime].I destination.PP.B ip/gping[.B -r] [.B -l] [.B -i.I interval].I destination[.I destination\&... ].PP.B ip/traceroute[.B -dn][.B -a.I n][.B -h.I nbuck][.B -t.I sttl].I dest.PP.B ip/hogports.B [\fImtpt\fP/]\fIproto\fP!\fIaddress\fP!\fIstartport\fP[-\fIendport\fP].SH DESCRIPTION.I Pingsends ICMP echo request messages to a system.It can be used to determine the network delayand whether or not the destination is up.By default, a line is written to standard output foreach request.If a reply is received the line contains the requestid (starting at 0 and incrementing), the round trip timefor this request, the average round trip time, and the timeto live in the reply packet.  If no reply is received the linecontains the word "lost", the request id, and the average roundtrip time..PPIf a reply is received for each request,.I pingreturns successfully. Otherwise it returns an error status of"lost messages"..PPThe options are:.TP.B 6force the use of IPv6's ICMP,.BR icmpv6 ,instead of IPv4's ICMP..I Pingtries to determine which version of IP to use automatically..TP.B aadds the IP source and destination addresses to each report..TP.B fsend messages as fast as possible (flood)..TP.B isets the time between messagesto be.I intervalmilliseconds, default 1000 ms..TP.B lcauses only lost messages to be reported..TP.B nrequests that a total of.I countmessages be sent, default 32..TP.B qsuppresses any output (i.e. be quiet)..TP.B rrandomizes the delay with a minimum extra delay of 0 ms and amaximum extra delay of the selected interval..TP.B ssets the length of the message to be.I sizebytes, ICMP header included.The size cannot be smaller than 32 orlarger than 8192.  The default is 64..TP.B wsets the additional time in milliseconds to waitafter all packets are sent..PP.I Gpingis a.I pingwith a graphical display.  Itpresents separate graphs for each destinationspecified..PPThe options are:.TP.B rdisplay round trip time in seconds.This is the default..TP.B ldisplay percentage of lost messages.A message is considered lost if notreplied to in 10 seconds.  The percentageis an exponentially weighted average..TP.B isets the time between messagesto be.I intervalmilliseconds, default 5000 ms..PPGraphs can be dropped and added usingthe button 3 menu.  Clicking button 1on a datapoint displays the value of thedatapoint and the time it was recorded..PP.I Traceroutedisplays the IP addresses and average round trip times to allrouters between the machine it is run on and.IR dest .It does this by sending packets to.I destwith increasing times to live (TTL) in their headers.Each router that a packet expires at replies with an ICMPwarning message.The options are:.TP.B dprint debugging to standard error.TP.B njust print out IP numbers, don't try tolook up the names of the routers..TP.B amake.I nattempts at each TTL value (default 3)..TP.B tset the starting TTL value to.I sttl(default 1)..TP.B hprint out a histogram of times from requestto response at each TTL value.  The histogramcontains.I nbuckbuckets..PD.PP.I Hogportsannounces on a range of ports to keep them from other processes.For example, to keep anyone from making a vncserver visible onthe network mounted at.BR /net.alt :.EX 	ip/hogports /net.alt/tcp!*!5900-5950.EE.SH SOURCE.B /sys/src/cmd/ip/ping.c.br.B /sys/src/cmd/ip/gping.c.br.B /sys/src/cmd/ip/traceroute.c.br.B /sys/src/cmd/ip/hogports.c.SH SEE ALSO.IR ip (3)