'\" t
.TH "ARPING" "8" "" "iputils s20180629" "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 [\-AbDfhqUV] [\-c\ \fIcount\fR] [\-w\ \fIdeadline\fR] [\-s\ \fIsource\fR] [\-I\ \fIinterface\fR] \fIdestination\fR
.br

.SH "DESCRIPTION"
.PP
Ping
\fIdestination\fR
on device
\fIinterface\fR
by ARP packets, using source address
\fIsource\fR\&.
.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\fIcount\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\fIinterface\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\fIsource\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\fIdeadline\fR
.RS 4
Specify a timeout, in seconds, before
\fBarping\fR
exits regardless of how many packets have been sent or received\&. In this case
\fBarping\fR
does not stop after
\fIcount\fR
packet are sent, it waits either for
\fIdeadline\fR
expire or until
\fIcount\fR
probes are answered\&.
.RE
.SH "SEE ALSO"
.PP
\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\&.
