| .TH arpsend 8 "18 Mar 2012" "OpenVZ" "Containers" |
| .SH NAME |
| arpsend \- send ARP requests |
| .SH SYNOPSIS |
| .SY arpsend |
| .B -D |
| .BI \-e\ target_ip |
| [ |
| .BI \-e\ target_ip \fR\ ...] |
| .OP \-c count |
| .OP \-w timeout |
| .I interface |
| .YS |
| .SY arpsend |
| .B \-U |
| .BI \-i\ source_ip |
| .OP \-c count |
| .OP \-w timeout |
| .I interface |
| .YS |
| .SH DESCRIPTION |
| Utility \fBarpsend\fR sends ARP packets on device \fIinterface\fR to detect |
| or update neighbours' ARP caches with a given IP. |
| .SH COMMANDS |
| Run utility with one of the following commands: |
| .TP |
| .B \-D |
| Send broadcast ARP request to detect neighbours with |
| \fItarget_ip\fR. You have to specify \fItarget_ip\fR (\fB-e\fR option). |
| .TP |
| .B \-U |
| Send broadcast ARP request to update neighbours' ARP caches with |
| \fIsource_ip\fR. You have to specify \fIsource_ip\fR (\fB-i\fR option). |
| .SH OPTIONS |
| .TP |
| .BI \-c\ count |
| Number of packets to send. Default is infinity. |
| .TP |
| .BI \-w\ interval |
| Interval between packets, in seconds. Default is 1 second. |
| .TP |
| .BI \-i\ source_ip_address |
| Set source IP address field in ARP packet. |
| .TP |
| .BI \-e\ target_ip_address |
| Set target IP address field in ARP packet. Note that you can specify |
| \fB-e\fR option multiple times to detect many IP addresses in one utility call. |
| .SH EXIT STATUS |
| \fBarpsend\fR returns 0 upon successful execution. If something goes wrong, it |
| returns an appropriate error code. |
| .IP "1 EXC_USAGE" |
| Usage error |
| .IP "2 EXC_SYSTEM" |
| System error |
| .IP "3 EXC_RECV" |
| ARP reply was received |
| .SH EXAMPLES |
| To send request on interface \fBeth0\fR to detect any neighbour |
| computers with IP \fB192.168.10.200\fR: |
| .PP |
| .EX |
| arpsend -D -e 192.168.10.200 eth0\fR |
| .EE |
| .PP |
| To send request on interface \fBeth0\fR to update neighbours' |
| ARP caches with IP \fB192.168.10.200\fR: |
| .PP |
| .EX |
| arpsend -U -i 192.168.10.200 eth0 |
| .EE |
| .SH NOTES |
| Interface you use have to be arpable and not be loopback (i.e. |
| \fB/sbin/ip link show \fIinterface\fR should show neither \fBNOARP\fR |
| nor \fBLOOPBACK\fR flags in interface parameters). |
| .SH SEE ALSO |
| .BR vzctl (8). |
| .SH LICENSE |
| Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL. |