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
147
148
149
150
151
152
153
154
155
|
'\" t
.TH "ARPING" "8" "" "iputils 20240117" "iputils"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
arping \- send ARP REQUEST to a neighbour host
.SH "SYNOPSIS"
.HP \w'\fBarping\fR\ 'u
\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}
.SH "DESCRIPTION"
.PP
Ping
\fIdestination\fR
on device
\fIinterface\fR
by ARP packets, using source address
\fIsource\fR\&.
.PP
arping supports IPv4 addresses only\&. For IPv6, see
\fBndisc6\fR(8)\&.
.SH "OPTIONS"
.PP
\fB\-A\fR
.RS 4
The same as
\fB\-U\fR, but ARP REPLY packets used instead of ARP REQUEST\&.
.RE
.PP
\fB\-b\fR
.RS 4
Send only MAC level broadcasts\&. Normally
\fBarping\fR
starts from sending broadcast, and switch to unicast after reply received\&.
.RE
.PP
\fB\-c \fR\fB\fIcount\fR\fR
.RS 4
Stop after sending
\fIcount\fR
ARP REQUEST packets\&. With
\fIdeadline\fR
option, instead wait for
\fIcount\fR
ARP REPLY packets, or until the timeout expires\&.
.RE
.PP
\fB\-D\fR
.RS 4
Duplicate address detection mode (DAD)\&. See RFC2131, 4\&.4\&.1\&. Returns 0, if DAD succeeded i\&.e\&. no replies are received\&.
.RE
.PP
\fB\-f\fR
.RS 4
Finish after the first reply confirming that target is alive\&.
.RE
.PP
\fB\-I \fR\fB\fIinterface\fR\fR
.RS 4
Name of network device where to send ARP REQUEST packets\&.
.RE
.PP
\fB\-h\fR
.RS 4
Print help page and exit\&.
.RE
.PP
\fB\-q\fR
.RS 4
Quiet output\&. Nothing is displayed\&.
.RE
.PP
\fB\-s \fR\fB\fIsource\fR\fR
.RS 4
IP source address to use in ARP packets\&. If this option is absent, source address is:
.PP
.RS 4
\(bu In DAD mode (with option
\fB\-D\fR) set to 0\&.0\&.0\&.0\&.
.RE
.PP
.RS 4
\(bu In Unsolicited ARP mode (with options
\fB\-U\fR
or
\fB\-A\fR) set to
\fIdestination\fR\&.
.RE
.PP
.RS 4
\(bu Otherwise, it is calculated from routing tables\&.
.RE
.RE
.PP
\fB\-U\fR
.RS 4
Unsolicited ARP mode to update neighbours\*(Aq ARP caches\&. No replies are expected\&.
.RE
.PP
\fB\-V\fR
.RS 4
Print version of the program and exit\&.
.RE
.PP
\fB\-w \fR\fB\fIdeadline\fR\fR
.RS 4
Specify a timeout, in seconds, before
\fBarping\fR
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
\fIcount\fR
option, exit with status 0 if
\fIcount\fR
replies are received before the deadline expiration, otherwise status 1\&.
.RE
.PP
\fB\-i \fR\fB\fIinterval\fR\fR
.RS 4
Specify an interval, in seconds, between packets\&.
.RE
.SH "SEE ALSO"
.PP
\fBndisc6\fR(8),
\fBping\fR(8),
\fBclockdiff\fR(8),
\fBtracepath\fR(8)\&.
.SH "AUTHOR"
.PP
\fBarping\fR
was written by Alexey Kuznetsov <kuznet@ms2\&.inr\&.ac\&.ru>\&.
.SH "SECURITY"
.PP
\fBarping\fR
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\&.
.SH "AVAILABILITY"
.PP
\fBarping\fR
is part of
\fIiputils\fR
package\&.
|
