222 lines
5.9 KiB
Plaintext
222 lines
5.9 KiB
Plaintext
<refentry id="arping">
|
|
|
|
<refmeta>
|
|
<refentrytitle>arping</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
<refmiscinfo>iputils-&snapshot;</refmiscinfo>
|
|
</refmeta>
|
|
|
|
|
|
<refnamediv>
|
|
<refname>arping</refname>
|
|
<refpurpose>send ARP REQUEST to a neighbour host</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>arping</command>
|
|
<arg choice="opt"><option>-AbDfhqUV</option></arg>
|
|
<arg choice="opt">-c <replaceable/count/</arg>
|
|
<arg choice="opt">-w <replaceable/deadline/</arg>
|
|
<arg choice="opt">-s <replaceable/source/</arg>
|
|
<arg choice="req">-I <replaceable/interface/</arg>
|
|
<arg choice="req"><replaceable/destination/</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1><title>DESCRIPTION</title>
|
|
<para>
|
|
Ping <replaceable/destination/ on device <replaceable/interface/ by ARP packets,
|
|
using source address <replaceable/source/.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1><title>OPTIONS</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><option/-A/</term>
|
|
<listitem><para>
|
|
The same as <option/-U/, 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/ starts
|
|
from sending broadcast, and switch to unicast after reply received.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
|
|
<varlistentry>
|
|
<term><option><anchor id="arping.count">-c <replaceable/count/</option></term>
|
|
<listitem><para>
|
|
Stop after sending <replaceable/count/ ARP REQUEST
|
|
packets. With
|
|
<link linkend="arping.deadline"><replaceable/deadline/</link>
|
|
option, <command/arping/ waits for
|
|
<replaceable/count/ ARP REPLY packets, until the timeout expires.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option/-D/</term>
|
|
<listitem><para>
|
|
Duplicate address detection mode (DAD). See
|
|
<ulink url="http://tools.ietf.org/rfc/rfc2131.txt">RFC2131, 4.4.1</ulink>.
|
|
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><anchor id="opt.interface">-I <replaceable/interface/</option></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/</term>
|
|
<listitem><para>
|
|
Quiet output. Nothing is displayed.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option><anchor id="opt.source">-s <replaceable/source/</option></term>
|
|
<listitem><para>
|
|
IP source address to use in ARP packets.
|
|
If this option is absent, source address is:
|
|
<itemizedlist>
|
|
<listitem><para>
|
|
In DAD mode (with option <option/-D/) set to 0.0.0.0.
|
|
</para></listitem>
|
|
<listitem><para>
|
|
In Unsolicited ARP mode (with options <option/-U/ or <option/-A/)
|
|
set to <replaceable/destination/.
|
|
</para></listitem>
|
|
<listitem><para>
|
|
Otherwise, it is calculated from routing tables.
|
|
</para></listitem>
|
|
</itemizedlist>
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option/-U/</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><anchor id="arping.deadline">-w <replaceable/deadline/</option></term>
|
|
<listitem><para>
|
|
Specify a timeout, in seconds, before
|
|
<command/arping/
|
|
exits regardless of how many
|
|
packets have been sent or received. In this case
|
|
<command/arping/
|
|
does not stop after
|
|
<link linkend="arping.count"><replaceable/count/</link>
|
|
packet are sent, it waits either for
|
|
<link linkend="arping.deadline"><replaceable/deadline/</link>
|
|
expire or until
|
|
<link linkend="arping.count"><replaceable/count/</link>
|
|
probes are answered.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1><title>SEE ALSO</title>
|
|
<para>
|
|
<link linkend="ping">
|
|
<citerefentry><refentrytitle/ping/<manvolnum/8/</citerefentry></link>,
|
|
<link linkend="clockdiff">
|
|
<citerefentry><refentrytitle/clockdiff/<manvolnum/8/</citerefentry></link>,
|
|
<link linkend="tracepath">
|
|
<citerefentry><refentrytitle/tracepath/<manvolnum/8/</citerefentry></link>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1><title>AUTHOR</title>
|
|
<para>
|
|
<command/arping/ was written by
|
|
<ulink url="mailto:kuznet@ms2.inr.ac.ru">Alexey Kuznetsov
|
|
<kuznet@ms2.inr.ac.ru></ulink>.
|
|
It is now maintained by
|
|
<ulink url="mailto:yoshfuji@skbuff.net">YOSHIFUJI Hideaki
|
|
<yoshfuji@skbuff.net></ulink>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1><title>SECURITY</title>
|
|
<para>
|
|
<command/arping/ requires <constant/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><title>AVAILABILITY</title>
|
|
<para>
|
|
<command/arping/ is part of <filename/iputils/ package
|
|
and the latest versions are available in source form at
|
|
<ulink url="http://www.skbuff.net/iputils/iputils-current.tar.bz2">
|
|
http://www.skbuff.net/iputils/iputils-current.tar.bz2</ulink>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<![IGNORE[
|
|
<refsect1><title>COPYING</title>
|
|
<para>
|
|
<literallayout>
|
|
This documentation is free software; you can redistribute
|
|
it and/or modify it under the terms of the GNU General Public
|
|
License Version 2.
|
|
|
|
This program is distributed in the hope that it will be
|
|
useful, but WITHOUT ANY WARRANTY; without even the implied
|
|
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
See the GNU General Public License for more details.
|
|
|
|
For more details see the file COPYING in the source
|
|
distribution of Linux kernel of version 2.4.
|
|
</literallayout>
|
|
</para>
|
|
</refsect1>
|
|
]]>
|
|
|
|
|
|
|
|
</refentry>
|