blob: c4cf71ac029c65b909225c6b09da76769c0429c3 [file] [log] [blame] [raw]
.TH arpsend 8 "28 Jun 2011" "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.