summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man8/arping.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/arping.8')
-rw-r--r--upstream/opensuse-leap-15-6/man8/arping.8155
1 files changed, 155 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/arping.8 b/upstream/opensuse-leap-15-6/man8/arping.8
new file mode 100644
index 00000000..af00f474
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man8/arping.8
@@ -0,0 +1,155 @@
+'\" t
+.TH "ARPING" "8" "" "iputils 20221126" "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\&.