Debian Codegraph @

upstream/opensuse-tumbleweed/man8/arping.8

raw
1 '\" t
2 .TH "ARPING" "8" "" "iputils 20250605" "iputils"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 arping \- send ARP REQUEST to a neighbour host
24 .SH "SYNOPSIS"
25 .HP \w'\fBarping\fR\ 'u
26 \fBarping\fR [\fB\-AbDfhqUV\fR] [\fB\-c\ \fR\fB\fIcount\fR\fR] [\fB\-w\ \fR\fB\fIdeadline\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-s\ \fR\fB\fIsource\fR\fR] [\fB\-I\ \fR\fB\fIinterface\fR\fR] {destination}
27 .SH "DESCRIPTION"
28 .PP
29 Ping
30 \fIdestination\fR
31 on device
32 \fIinterface\fR
33 by ARP packets, using source address
34 \fIsource\fR\&.
35 .PP
36 arping supports IPv4 addresses only\&. For IPv6, see
37 \fBndisc6\fR(8)\&.
38 .SH "OPTIONS"
39 .PP
40 \fB\-A\fR
41 .RS 4
42 The same as
43 \fB\-U\fR, but ARP REPLY packets used instead of ARP REQUEST\&.
44 .RE
45 .PP
46 \fB\-b\fR
47 .RS 4
48 Send only MAC level broadcasts\&. Normally
49 \fBarping\fR
50 starts from sending broadcast, and switch to unicast after reply received\&.
51 .RE
52 .PP
53 \fB\-c \fR\fB\fIcount\fR\fR
54 .RS 4
55 Stop after sending
56 \fIcount\fR
57 ARP REQUEST packets\&. With
58 \fIdeadline\fR
59 option, instead wait for
60 \fIcount\fR
61 ARP REPLY packets, or until the timeout expires\&.
62 .RE
63 .PP
64 \fB\-D\fR
65 .RS 4
66 Duplicate address detection mode (DAD)\&. See RFC2131, 4\&.4\&.1\&. Returns 0, if DAD succeeded i\&.e\&. no replies are received\&.
67 .RE
68 .PP
69 \fB\-f\fR
70 .RS 4
71 Finish after the first reply confirming that target is alive\&.
72 .RE
73 .PP
74 \fB\-I \fR\fB\fIinterface\fR\fR
75 .RS 4
76 Name of network device where to send ARP REQUEST packets\&.
77 .RE
78 .PP
79 \fB\-h\fR
80 .RS 4
81 Print help page and exit\&.
82 .RE
83 .PP
84 \fB\-q\fR
85 .RS 4
86 Quiet output\&. Nothing is displayed\&.
87 .RE
88 .PP
89 \fB\-s \fR\fB\fIsource\fR\fR
90 .RS 4
91 IP source address to use in ARP packets\&. If this option is absent, source address is:
92 .PP
93 .RS 4
94 \(bu In DAD mode (with option
95 \fB\-D\fR) set to 0\&.0\&.0\&.0\&.
96 .RE
97 .PP
98 .RS 4
99 \(bu In Unsolicited ARP mode (with options
100 \fB\-U\fR
101 or
102 \fB\-A\fR) set to
103 \fIdestination\fR\&.
104 .RE
105 .PP
106 .RS 4
107 \(bu Otherwise, it is calculated from routing tables\&.
108 .RE
109 .RE
110 .PP
111 \fB\-U\fR
112 .RS 4
113 Unsolicited ARP mode to update neighbours\*(Aq ARP caches\&. No replies are expected\&.
114 .RE
115 .PP
116 \fB\-V\fR
117 .RS 4
118 Print version of the program and exit\&.
119 .RE
120 .PP
121 \fB\-w \fR\fB\fIdeadline\fR\fR
122 .RS 4
123 Specify a timeout, in seconds, before
124 \fBarping\fR
125 exits regardless of how many packets have been sent or received\&. If any replies are received, exit with status 0, otherwise status 1\&. When combined with the
126 \fIcount\fR
127 option, exit with status 0 if
128 \fIcount\fR
129 replies are received before the deadline expiration, otherwise status 1\&.
130 .RE
131 .PP
132 \fB\-i \fR\fB\fIinterval\fR\fR
133 .RS 4
134 Specify an interval, in seconds, between packets\&.
135 .RE
136 .SH "SEE ALSO"
137 .PP
138 \fBndisc6\fR(8),
139 \fBping\fR(8),
140 \fBclockdiff\fR(8),
141 \fBtracepath\fR(8)\&.
142 .SH "AUTHOR"
143 .PP
144 \fBarping\fR
145 was written by Alexey Kuznetsov <kuznet@ms2\&.inr\&.ac\&.ru>\&.
146 .SH "SECURITY"
147 .PP
148 \fBarping\fR
149 requires CAP_NET_RAW capability to be executed\&. It is not recommended to be used as set\-uid root, because it allows user to modify ARP caches of neighbour hosts\&.
150 .SH "AVAILABILITY"
151 .PP
152 \fBarping\fR
153 is part of
154 \fIiputils\fR
155 package\&.