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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- lifted from man+troff by doclifter -->
<refentry id='arping8'>
<refentryinfo>
<title>arping</title>
<productname>iputils</productname>
</refentryinfo>
<refmeta>
<refentrytitle>ARPING</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class='manual'>iputils</refmiscinfo>
</refmeta>
<refnamediv>
<refname>arping</refname>
<refpurpose>send ARP REQUEST to a neighbour host</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>arping</command>
<arg choice='opt'>-AbDfhqUV </arg>
<arg choice='opt'>-c <replaceable>count</replaceable></arg>
<arg choice='opt'>-w <replaceable>deadline</replaceable></arg>
<arg choice='opt'>-i <replaceable>interval</replaceable></arg>
<arg choice='opt'>-s <replaceable>source</replaceable></arg>
<arg choice='opt'>-I <replaceable>interface</replaceable></arg>
<arg choice='plain'><replaceable>destination</replaceable></arg>
<sbr/>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id='description'>
<title>DESCRIPTION</title>
<para>Ping <emphasis remap='I'>destination</emphasis> on device <emphasis remap='I'>interface</emphasis> by ARP packets,
using source address <emphasis remap='I'>source</emphasis>.</para>
</refsect1>
<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
<varlistentry>
<term><option>-A</option></term>
<listitem>
<para>The same as <option>-U</option>, but ARP REPLY packets used instead
of ARP REQUEST.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-b</option></term>
<listitem>
<para>Send only MAC level broadcasts. Normally <command>arping</command> starts
from sending broadcast, and switch to unicast after reply received.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-c </option><emphasis remap='I'>count</emphasis></term>
<listitem>
<para>Stop after sending <emphasis remap='I'>count</emphasis> ARP REQUEST
packets. With <emphasis remap='I'>deadline</emphasis> option, instead wait for
<emphasis remap='I'>count</emphasis> ARP REPLY packets, or until the timeout expires.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-D</option></term>
<listitem><para>Duplicate address detection mode (DAD). See RFC2131, 4.4.1. Returns 0, if DAD succeeded i.e. no replies are received</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-f</option></term>
<listitem><para>Finish after the first reply confirming that target is alive.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-I </option><emphasis remap='I'>interface</emphasis></term>
<listitem><para>Name of network device where to send ARP REQUEST packets.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option></term>
<listitem><para>Print help page and exit.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-q</option></term>
<listitem><para>Quiet output. Nothing is displayed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-s </option><emphasis remap='I'>source</emphasis></term>
<listitem><para>IP source address to use in ARP packets. If this option is absent, source address is:</para>
<variablelist remap='TP'>
<varlistentry>
<listitem><para>• In DAD mode (with option <option>-D</option>) set to 0.0.0.0.</para>
</listitem>
</varlistentry>
<varlistentry>
<listitem><para>• In Unsolicited ARP mode (with options <option>-U</option> or <option>-A</option>)
set to <emphasis remap='I'>destination</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<listitem><para>• Otherwise, it is calculated from routing tables.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-U</option></term>
<listitem><para>Unsolicited ARP mode to update neighbours' ARP caches.
No replies are expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</option></term>
<listitem><para>Print version of the program and exit.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-w </option><emphasis remap='I'>deadline</emphasis></term>
<listitem><para>Specify a timeout, in seconds, before
<command>arping</command>
exits regardless of how many
packets have been sent or received. In this case
<command>arping</command>
does not stop after
<emphasis remap='I'>count</emphasis>
packet are sent, it waits either for
<emphasis remap='I'>deadline</emphasis>
expire or until
<emphasis remap='I'>count</emphasis>
probes are answered.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-i </option><emphasis remap='I'>interval</emphasis></term>
<listitem><para>Specify an interval, in seconds, between packets.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id='see_also'>
<title>SEE ALSO</title>
<para><citerefentry><refentrytitle>ping</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>clockdiff</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>tracepath</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</refsect1>
<refsect1 id='author'>
<title>AUTHOR</title>
<para><command>arping</command> was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.</para>
</refsect1>
<refsect1 id='security'>
<title>SECURITY</title>
<para><command>arping</command> 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.</para>
</refsect1>
<refsect1 id='availability'>
<title>AVAILABILITY</title>
<para><command>arping</command> is part of <emphasis remap='I'>iputils</emphasis> package.</para>
</refsect1>
</refentry>
|
