1<refentry id="arping"> 2 3<refmeta> 4<refentrytitle>arping</refentrytitle> 5<manvolnum>8</manvolnum> 6<refmiscinfo>iputils-&snapshot;</refmiscinfo> 7</refmeta> 8 9 10<refnamediv> 11<refname>arping</refname> 12<refpurpose>send ARP REQUEST to a neighbour host</refpurpose> 13</refnamediv> 14 15<refsynopsisdiv> 16<cmdsynopsis> 17<command>arping</command> 18<arg choice="opt"><option>-AbDfhqUV</option></arg> 19<arg choice="opt">-c <replaceable/count/</arg> 20<arg choice="opt">-w <replaceable/deadline/</arg> 21<arg choice="opt">-s <replaceable/source/</arg> 22<arg choice="req">-I <replaceable/interface/</arg> 23<arg choice="req"><replaceable/destination/</arg> 24</cmdsynopsis> 25</refsynopsisdiv> 26 27<refsect1><title>DESCRIPTION</title> 28<para> 29Ping <replaceable/destination/ on device <replaceable/interface/ by ARP packets, 30using source address <replaceable/source/. 31</para> 32</refsect1> 33 34<refsect1><title>OPTIONS</title> 35 36<variablelist> 37 38 <varlistentry> 39 <term><option/-A/</term> 40 <listitem><para> 41The same as <option/-U/, but ARP REPLY packets used instead 42of ARP REQUEST. 43 </para></listitem> 44 </varlistentry> 45 46 <varlistentry> 47 <term><option>-b</option></term> 48 <listitem><para> 49Send only MAC level broadcasts. Normally <command/arping/ starts 50from sending broadcast, and switch to unicast after reply received. 51 </para></listitem> 52 </varlistentry> 53 54 55 <varlistentry> 56 <term><option><anchor id="arping.count">-c <replaceable/count/</option></term> 57 <listitem><para> 58Stop after sending <replaceable/count/ ARP REQUEST 59packets. With 60<link linkend="arping.deadline"><replaceable/deadline/</link> 61option, <command/arping/ waits for 62<replaceable/count/ ARP REPLY packets, until the timeout expires. 63 </para></listitem> 64 </varlistentry> 65 66 <varlistentry> 67 <term><option/-D/</term> 68 <listitem><para> 69Duplicate address detection mode (DAD). See 70<ulink url="http://tools.ietf.org/rfc/rfc2131.txt">RFC2131, 4.4.1</ulink>. 71Returns 0, if DAD succeeded i.e. no replies are received 72 </para></listitem> 73 </varlistentry> 74 75 <varlistentry> 76 <term><option>-f</option></term> 77 <listitem><para> 78Finish after the first reply confirming that target is alive. 79 </para></listitem> 80 </varlistentry> 81 82 <varlistentry> 83 <term><option><anchor id="opt.interface">-I <replaceable/interface/</option></term> 84 <listitem><para> 85Name of network device where to send ARP REQUEST packets. 86 </para></listitem> 87 </varlistentry> 88 89 <varlistentry> 90 <term><option>-h</option></term> 91 <listitem><para> 92Print help page and exit. 93 </para></listitem> 94 </varlistentry> 95 96 97 <varlistentry> 98 <term><option/-q/</term> 99 <listitem><para> 100Quiet output. Nothing is displayed. 101 </para></listitem> 102 </varlistentry> 103 104 <varlistentry> 105 <term><option><anchor id="opt.source">-s <replaceable/source/</option></term> 106 <listitem><para> 107IP source address to use in ARP packets. 108If this option is absent, source address is: 109 <itemizedlist> 110 <listitem><para> 111In DAD mode (with option <option/-D/) set to 0.0.0.0. 112 </para></listitem> 113 <listitem><para> 114In Unsolicited ARP mode (with options <option/-U/ or <option/-A/) 115set to <replaceable/destination/. 116 </para></listitem> 117 <listitem><para> 118Otherwise, it is calculated from routing tables. 119 </para></listitem> 120 </itemizedlist> 121 </para></listitem> 122 </varlistentry> 123 124 <varlistentry> 125 <term><option/-U/</term> 126 <listitem><para> 127Unsolicited ARP mode to update neighbours' ARP caches. 128No replies are expected. 129 </para></listitem> 130 </varlistentry> 131 132 <varlistentry> 133 <term><option>-V</option></term> 134 <listitem><para> 135Print version of the program and exit. 136 </para></listitem> 137 </varlistentry> 138 139 140 <varlistentry> 141 <term><option><anchor id="arping.deadline">-w <replaceable/deadline/</option></term> 142 <listitem><para> 143Specify a timeout, in seconds, before 144<command/arping/ 145exits regardless of how many 146packets have been sent or received. In this case 147<command/arping/ 148does not stop after 149<link linkend="arping.count"><replaceable/count/</link> 150packet are sent, it waits either for 151<link linkend="arping.deadline"><replaceable/deadline/</link> 152expire or until 153<link linkend="arping.count"><replaceable/count/</link> 154probes are answered. 155 </para></listitem> 156 </varlistentry> 157</variablelist> 158</refsect1> 159 160<refsect1><title>SEE ALSO</title> 161<para> 162<link linkend="ping"> 163<citerefentry><refentrytitle/ping/<manvolnum/8/</citerefentry></link>, 164<link linkend="clockdiff"> 165<citerefentry><refentrytitle/clockdiff/<manvolnum/8/</citerefentry></link>, 166<link linkend="tracepath"> 167<citerefentry><refentrytitle/tracepath/<manvolnum/8/</citerefentry></link>. 168</para> 169</refsect1> 170 171<refsect1><title>AUTHOR</title> 172<para> 173<command/arping/ was written by 174<ulink url="mailto:kuznet@ms2.inr.ac.ru">Alexey Kuznetsov 175<kuznet@ms2.inr.ac.ru></ulink>. 176It is now maintained by 177<ulink url="mailto:yoshfuji@skbuff.net">YOSHIFUJI Hideaki 178<yoshfuji@skbuff.net></ulink>. 179</para> 180</refsect1> 181 182<refsect1><title>SECURITY</title> 183<para> 184<command/arping/ requires <constant/CAP_NET_RAW/ capability 185to be executed. It is not recommended to be used as set-uid root, 186because it allows user to modify ARP caches of neighbour hosts. 187</para> 188</refsect1> 189 190<refsect1><title>AVAILABILITY</title> 191<para> 192<command/arping/ is part of <filename/iputils/ package 193and the latest versions are available in source form at 194<ulink url="http://www.skbuff.net/iputils/iputils-current.tar.bz2"> 195http://www.skbuff.net/iputils/iputils-current.tar.bz2</ulink>. 196</para> 197</refsect1> 198 199<![IGNORE[ 200<refsect1><title>COPYING</title> 201<para> 202<literallayout> 203This documentation is free software; you can redistribute 204it and/or modify it under the terms of the GNU General Public 205License Version 2. 206 207This program is distributed in the hope that it will be 208useful, but WITHOUT ANY WARRANTY; without even the implied 209warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 210See the GNU General Public License for more details. 211 212For more details see the file COPYING in the source 213distribution of Linux kernel of version 2.4. 214</literallayout> 215</para> 216</refsect1> 217]]> 218 219 220 221</refentry> 222