Open main menu

OpenVZ Virtuozzo Containers Wiki β

Changes

Man/arpsend.8

3,427 bytes added, 22:14, 3 June 2011
Automated import of articles
== NAME ==

<p style="margin-left:11%; margin-top: 1em">arpsend &minus;
utility to send ARP requests.</p>

== SYNOPSIS ==

<p style="margin-left:11%; margin-top: 1em">arpsend &lt;
<b>-U -i&nbsp;</b><i>source_ip</i> |&nbsp;<b>-D
-e&nbsp;</b><i>target_ip</i>
[<b>-e&nbsp;</b><i>target_ip</i>]&nbsp;... &gt; [<b>-c</b>
<i>count</i>] [<b>-w</b> <i>timeout</i>]
<i>interface</i></p>

== DESCRIPTION ==

<p style="margin-left:11%; margin-top: 1em">Utility
<b>arpsend</b> sends ARP packets on device <i>interface</i>
to detect or update neighbours&rsquo; ARP caches with a
given IP.</p>

== COMMANDS ==

<p style="margin-left:11%; margin-top: 1em">Run utility
with one of the following commands:</p>

<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">

<p><b>-D</b></p></td>
<td width="8%"></td>
<td width="78%">

<p>Send broadcast ARP request to detect neighbours with
<i>target_ip</i>. You have to specify <i>target_ip</i>
(<b>-e</b> option).</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">

<p><b>-U</b></p></td>
<td width="8%"></td>
<td width="78%">

<p>Send broadcast ARP request to update neighbours&rsquo;
ARP caches with <i>source_ip</i>. You have to specify
<i>source_ip</i> (<b>-i</b> option).</p></td></tr>
</table>

== OPTIONS ==

<p style="margin-left:11%; margin-top: 1em"><b>-c</b>
<i>count</i></p>

<p style="margin-left:22%;">Number of packets to send.
Default is infinity.</p>

<p style="margin-left:11%;"><b>-w</b> <i>interval</i></p>

<p style="margin-left:22%;">Interval between packets, in
seconds. Default is 1 second.</p>

<p style="margin-left:11%;"><b>-i</b>
<i>source_ip_address</i></p>

<p style="margin-left:22%;">Set source IP address field in
ARP packet.</p>

<p style="margin-left:11%;"><b>-e</b>
<i>target_ip_address</i></p>

<p style="margin-left:22%;">Set target IP address field in
ARP packet. Note that you can specify <b>-e</b> option
multiple times to detect many IP addresses in one utility
call.</p>

== DIAGNOSTICS ==

<p style="margin-left:11%; margin-top: 1em"><b>arpsend</b>
returns 0 upon successful execution. If something goes
wrong, it returns an appropriate error code. <br>
1 EXC_USAGE</p>

<p style="margin-left:22%;">Usage error</p>

<p style="margin-left:11%;">2 EXC_SYSTEM</p>

<p style="margin-left:22%;">System error</p>

<p style="margin-left:11%;">3 EXC_RECV</p>

<p style="margin-left:22%;">ARP reply was received</p>

== EXAMPLES ==

<p style="margin-left:11%; margin-top: 1em">To send request
on interface <i>eth0</i> to detect any neighbour computers
with IP <i>192.168.10.200</i>: <tt><br>
arpsend -D -e 192.168.10.200 eth0</tt></p>

<p style="margin-left:11%; margin-top: 1em">To send request
on interface <i>eth0</i> to update neighbours&rsquo; ARP
caches with IP <i>192.168.10.200</i>: <tt><br>
arpsend -U -i 192.168.10.200 eth0</tt></p>

== NOTES ==

<p style="margin-left:11%; margin-top: 1em">Interface you
use have to be arpable and not be loopback (i.e. <b>/sbin/ip
link show</b> <i>interface</i> should show neither
<b>NOARP</b> not <b>LOOPBACK</b> flags in interface
parameters).</p>

== SEE ALSO ==

<p style="margin-left:11%; margin-top: 1em">[[Man/vzctl.8|<b>vzctl</b>(8)]].</p>

== LICENSE ==

<p style="margin-left:11%; margin-top: 1em">Copyright (C)
2000-2011, Parallels, Inc. Licensed under GNU GPL.</p>
2,253
edits