Difference between revisions of "Man/arpsend.8"

From OpenVZ Virtuozzo Containers Wiki
< Man
Jump to: navigation, search
(Automated import of articles *** existing text overwritten ***)
(Automated import of articles *** existing text overwritten ***)
 
Line 6: Line 6:
 
== SYNOPSIS ==
 
== SYNOPSIS ==
  
<p style="margin-left:11%; margin-top: 1em">arpsend &lt;
+
<table width="100%" border="0" rules="none" frame="void"
<b>-U -i&nbsp;</b><i>source_ip</i> |&nbsp;<b>-D
+
      cellspacing="0" cellpadding="0">
-e&nbsp;</b><i>target_ip</i>
+
<tr valign="top" align="left">
[<b>-e&nbsp;</b><i>target_ip</i>]&nbsp;... &gt; [<b>-c</b>
+
<td width="11%"></td>
<i>count</i>] [<b>-w</b> <i>timeout</i>]
+
<td width="11%">
<i>interface</i></p>
+
 
 +
<p style="margin-top: 1em"><b>arpsend</b></p></td>
 +
<td width="1%"></td>
 +
<td width="77%">
 +
 
 +
<p style="margin-top: 1em"><b>-D
 +
&minus;e&nbsp;</b><i>target_ip</i> [
 +
<b>&minus;e&nbsp;</b><i>target_ip&nbsp;</i>...]
 +
[<b>&minus;c&nbsp;</b><i>count</i>]
 +
[<b>&minus;w&nbsp;</b><i>timeout</i>] <i>interface</i></p></td></tr>
 +
<tr valign="top" align="left">
 +
<td width="11%"></td>
 +
<td width="11%">
 +
 
 +
<p style="margin-top: 1em"><b>arpsend</b></p></td>
 +
<td width="1%"></td>
 +
<td width="77%">
 +
 
 +
<p style="margin-top: 1em"><b>&minus;U
 +
&minus;i&nbsp;</b><i>source_ip</i>
 +
[<b>&minus;c&nbsp;</b><i>count</i>]
 +
[<b>&minus;w&nbsp;</b><i>timeout</i>] <i>interface</i></p></td></tr>
 +
</table>
  
 
== DESCRIPTION ==
 
== DESCRIPTION ==
Line 31: Line 53:
 
<td width="3%">
 
<td width="3%">
  
<p><b>-D</b></p></td>
+
<p><b>&minus;D</b></p></td>
 
<td width="8%"></td>
 
<td width="8%"></td>
 
<td width="78%">
 
<td width="78%">
Line 42: Line 64:
 
<td width="3%">
 
<td width="3%">
  
<p><b>-U</b></p></td>
+
<p><b>&minus;U</b></p></td>
 
<td width="8%"></td>
 
<td width="8%"></td>
 
<td width="78%">
 
<td width="78%">
Line 53: Line 75:
 
== OPTIONS ==
 
== OPTIONS ==
  
<p style="margin-left:11%; margin-top: 1em"><b>-c</b>
+
<p style="margin-left:11%; margin-top: 1em"><b>&minus;c&nbsp;count</b></p>
<i>count</i></p>
 
  
 
<p style="margin-left:22%;">Number of packets to send.
 
<p style="margin-left:22%;">Number of packets to send.
 
Default is infinity.</p>
 
Default is infinity.</p>
  
<p style="margin-left:11%;"><b>-w</b> <i>interval</i></p>
+
<p style="margin-left:11%;"><b>&minus;w&nbsp;interval</b></p>
  
 
<p style="margin-left:22%;">Interval between packets, in
 
<p style="margin-left:22%;">Interval between packets, in
 
seconds. Default is 1 second.</p>
 
seconds. Default is 1 second.</p>
  
<p style="margin-left:11%;"><b>-i</b>
+
<p style="margin-left:11%;"><b>&minus;i&nbsp;source_ip_address</b></p>
<i>source_ip_address</i></p>
 
  
 
<p style="margin-left:22%;">Set source IP address field in
 
<p style="margin-left:22%;">Set source IP address field in
 
ARP packet.</p>
 
ARP packet.</p>
  
<p style="margin-left:11%;"><b>-e</b>
+
<p style="margin-left:11%;"><b>&minus;e&nbsp;target_ip_address</b></p>
<i>target_ip_address</i></p>
 
  
 
<p style="margin-left:22%;">Set target IP address field in
 
<p style="margin-left:22%;">Set target IP address field in
Line 98: Line 117:
  
 
<p style="margin-left:11%; margin-top: 1em">To send request
 
<p style="margin-left:11%; margin-top: 1em">To send request
on interface <i>eth0</i> to detect any neighbour computers
+
on interface <b>eth0</b> to detect any neighbour computers
with IP <i>192.168.10.200</i>: <tt><br>
+
with IP <b>192.168.10.200</b>:</p>
arpsend -D -e 192.168.10.200 eth0</tt></p>
+
 
 +
<pre style="margin-left:11%; margin-top: 1em">   arpsend -D -e 192.168.10.200 eth0</pre>
  
 
<p style="margin-left:11%; margin-top: 1em">To send request
 
<p style="margin-left:11%; margin-top: 1em">To send request
on interface <i>eth0</i> to update neighbours&rsquo; ARP
+
on interface <b>eth0</b> to update neighbours&rsquo; ARP
caches with IP <i>192.168.10.200</i>: <tt><br>
+
caches with IP <b>192.168.10.200</b>:</p>
arpsend -U -i 192.168.10.200 eth0</tt></p>
+
 
 +
<pre style="margin-left:11%; margin-top: 1em">   arpsend -U -i 192.168.10.200 eth0</pre>
  
 
== NOTES ==
 
== NOTES ==
Line 112: Line 133:
 
use have to be arpable and not be loopback (i.e. <b>/sbin/ip
 
use have to be arpable and not be loopback (i.e. <b>/sbin/ip
 
link show</b> <i>interface</i> should show neither
 
link show</b> <i>interface</i> should show neither
<b>NOARP</b> not <b>LOOPBACK</b> flags in interface
+
<b>NOARP</b> nor <b>LOOPBACK</b> flags in interface
 
parameters).</p>
 
parameters).</p>
  

Latest revision as of 13:11, 11 July 2011

NAME[edit]

arpsend − send ARP requests

SYNOPSIS[edit]

arpsend

-D −e target_ip [ −e target_ip ...] [−c count] [−w timeout] interface

arpsend

−U −i source_ip [−c count] [−w timeout] interface

DESCRIPTION[edit]

Utility arpsend sends ARP packets on device interface to detect or update neighbours’ ARP caches with a given IP.

COMMANDS[edit]

Run utility with one of the following commands:

−D

Send broadcast ARP request to detect neighbours with target_ip. You have to specify target_ip (-e option).

−U

Send broadcast ARP request to update neighbours’ ARP caches with source_ip. You have to specify source_ip (-i option).

OPTIONS[edit]

−c count

Number of packets to send. Default is infinity.

−w interval

Interval between packets, in seconds. Default is 1 second.

−i source_ip_address

Set source IP address field in ARP packet.

−e target_ip_address

Set target IP address field in ARP packet. Note that you can specify -e option multiple times to detect many IP addresses in one utility call.

EXIT STATUS[edit]

arpsend returns 0 upon successful execution. If something goes wrong, it returns an appropriate error code.
1 EXC_USAGE

Usage error

2 EXC_SYSTEM

System error

3 EXC_RECV

ARP reply was received

EXAMPLES[edit]

To send request on interface eth0 to detect any neighbour computers with IP 192.168.10.200:

   arpsend -D -e 192.168.10.200 eth0

To send request on interface eth0 to update neighbours’ ARP caches with IP 192.168.10.200:

   arpsend -U -i 192.168.10.200 eth0

NOTES[edit]

Interface you use have to be arpable and not be loopback (i.e. /sbin/ip link show interface should show neither NOARP nor LOOPBACK flags in interface parameters).

SEE ALSO[edit]

vzctl(8).

LICENSE[edit]

Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL.