summaryrefslogtreecommitdiff
path: root/static/plan9-4e/man8/ping.8
blob: a78ba99c40a3e514373891d005bf975a17bfe782 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
.TH PING 8
.SH NAME
ping, gping, traceroute, hogports \- probe the Internet
.SH SYNOPSIS
.B ping
[
.B -d
] [
.B -i
.I interval
] [
.B -s
.I size
] [
.B -n
.I count
]
.I destination
.PP
.B gping
[
.B -r
] [
.B -l
] [
.B -i
.I interval
]
.I destination
[
.I destination
\&... ]
.PP
.B traceroute
[
.B -dn
][
.B -t
.I tries
]
.I dest
.PP
.B hogports
.B [\fImtpt\fP/]\fIproto\fP!\fIaddress\fP!\fIstartport\fP[-\fIendport\fP]
.SH DESCRIPTION
.I Ping
sends ICMP echo requests to a system and returns the time
for a response.  It can be used to determine the network delay
and whether or not the destination is up.
.PP
The options are:
.TP
.B n
requests that a total of
.I count
messages be sent, default 32.
.TP
.B i
sets the time between messages
to be
.I interval
milliseconds, default 1000 ms.
.TP
.B s
sets the length of the message to be
.I size
bytes, ICMP header included.
The size cannot be smaller than 32 or
larger than 8192.  The default is
64.
.TP
.B d
causes message numbers to be printed
so that one can see the order with which
messages are received and which are lost.
.PP
.I Gping
is a
.I ping
with a graphical display.  It
presents separate graphs for each destination
specified.
.PP
The options are:
.TP
.B r
display round trip time in seconds.
This is the default.
.TP
.B l
display percentage of lost messages.
A message is considered lost if not
replied to in 10 seconds.  The percentage
is an exponentially weighted average.
.TP
.B i
sets the time between messages
to be
.I interval
milliseconds, default 5000 ms.
.PP
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.
.PP
.I Traceroute
displays the IP addresses and average round trip times to all
routers between the machine it is run on and
.IR dest .
It does this by sending packets to
.I dest
with increasing times to live (TTL) in their headers.
Each router that a packet expires at replies with an ICMP
warning message.
The options are:
.TP
.B d
print debugging to standard error
.TP
.B n
just print out IP numbers, don't try to
look up the names of the routers.
.TP
.B t
send
.I tries
packets at each TTL value (default 1).
.PP
.I 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
.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