Debian Codegraph @

man/ping.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.2.
2 .TH PING "1" "April 2026" "GNU inetutils 2.8" "User Commands"
3 .SH NAME
4 ping \- Packets to network hosts
5 .SH SYNOPSIS
6 .B ping
7 [\fI\,OPTION\/\fR...] \fI\,HOST \/\fR...
8 .SH DESCRIPTION
9 Send ICMP ECHO_REQUEST packets to network hosts.
10 .IP
11 Options controlling ICMP request types:
12 .TP
13 \fB\-\-address\fR
14 send ICMP_ADDRESS packets (root only)
15 .TP
16 \fB\-\-echo\fR
17 send ICMP_ECHO packets (default)
18 .TP
19 \fB\-\-mask\fR
20 same as \fB\-\-address\fR
21 .TP
22 \fB\-\-timestamp\fR
23 send ICMP_TIMESTAMP packets
24 .TP
25 \fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
26 send TYPE packets
27 .IP
28 Options valid for all request types:
29 .TP
30 \fB\-c\fR, \fB\-\-count\fR=\fI\,NUMBER\/\fR
31 stop after sending NUMBER packets
32 .TP
33 \fB\-d\fR, \fB\-\-debug\fR
34 set the SO_DEBUG option
35 .TP
36 \fB\-i\fR, \fB\-\-interval\fR=\fI\,NUMBER\/\fR
37 wait NUMBER seconds between sending each packet
38 .TP
39 \fB\-n\fR, \fB\-\-numeric\fR
40 do not resolve host addresses
41 .TP
42 \fB\-r\fR, \fB\-\-ignore\-routing\fR
43 send directly to a host on an attached network
44 .TP
45 \fB\-\-ttl\fR=\fI\,N\/\fR
46 specify N as time\-to\-live
47 .TP
48 \fB\-T\fR, \fB\-\-tos\fR=\fI\,NUM\/\fR
49 set type of service (TOS) to NUM
50 .TP
51 \fB\-v\fR, \fB\-\-verbose\fR
52 verbose output
53 .TP
54 \fB\-w\fR, \fB\-\-timeout\fR=\fI\,N\/\fR
55 stop after N seconds
56 .TP
57 \fB\-W\fR, \fB\-\-linger\fR=\fI\,N\/\fR
58 number of seconds to wait for response
59 .IP
60 Options valid for \fB\-\-echo\fR requests:
61 .TP
62 \fB\-f\fR, \fB\-\-flood\fR
63 flood ping (root only)
64 .TP
65 \fB\-\-ip\-timestamp\fR=\fI\,FLAG\/\fR
66 IP timestamp of type FLAG, which is one of
67 "tsonly" and "tsaddr"
68 .TP
69 \fB\-l\fR, \fB\-\-preload\fR=\fI\,NUMBER\/\fR
70 send NUMBER packets as fast as possible before
71 falling into normal mode of behavior (root only)
72 .TP
73 \fB\-p\fR, \fB\-\-pattern\fR=\fI\,PATTERN\/\fR
74 fill ICMP packet with given pattern (hex)
75 .TP
76 \fB\-q\fR, \fB\-\-quiet\fR
77 quiet output
78 .TP
79 \fB\-R\fR, \fB\-\-route\fR
80 record route
81 .TP
82 \fB\-s\fR, \fB\-\-size\fR=\fI\,NUMBER\/\fR
83 send NUMBER data octets
84 .TP
85 \-?, \fB\-\-help\fR
86 give this help list
87 .TP
88 \fB\-\-usage\fR
89 give a short usage message
90 .TP
91 \fB\-V\fR, \fB\-\-version\fR
92 print program version
93 .PP
94 Mandatory or optional arguments to long options are also mandatory or optional
95 for any corresponding short options.
96 .PP
97 Options marked with (root only) are available only to superuser.
98 .SH AUTHOR
99 Written by Sergey Poznyakoff.
100 .SH "REPORTING BUGS"
101 Report bugs to <bug\[email protected]>.
102 .SH COPYRIGHT
103 Copyright \(co 2026 Free Software Foundation, Inc.
104 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
105 .br
106 This is free software: you are free to change and redistribute it.
107 There is NO WARRANTY, to the extent permitted by law.
108 .SH "SEE ALSO"
109 The full documentation for
110 .B ping
111 is maintained as a Texinfo manual. If the
112 .B info
113 and
114 .B ping
115 programs are properly installed at your site, the command
116 .IP
117 .B info ping
118 .PP
119 should give you access to the complete manual.