trusty (8) arping.8.gz

Provided by: iputils-arping_20121221-4ubuntu1.1_amd64 bug

NAME
       arping - send ARP REQUEST to a neighbour host


SYNOPSIS
       arping [-AbDfhqUV] [-c count] [-w deadline] [-s source] -I interface destination


DESCRIPTION
       Ping destination on device interface by ARP packets, using source address source.


OPTIONS
       -A     The same as -U, but ARP REPLY packets used instead of ARP REQUEST.

       -b     Send  only  MAC  level  broadcasts.  Normally  arping starts from sending broadcast, and switch to
              unicast after reply received.

       -c count
              Stop after sending count ARP REQUEST packets. With deadline option, arping  waits  for  count  ARP
              REPLY packets, until the timeout expires.

       -D     Duplicate  address  detection mode (DAD). See RFC2131, 4.4.1.  Returns 0, if DAD succeeded i.e. no
              replies are received

       -f     Finish after the first reply confirming that target is alive.

       -I interface
              Name of network device where to send ARP REQUEST packets.

       -h     Print help page and exit.

       -q     Quiet output. Nothing is displayed.

       -s source
              IP source address to use in ARP packets.  If this option is absent, source address is:

              • In DAD mode (with option -D) set to 0.0.0.0.

              • In Unsolicited ARP mode (with options -U or -A) set to destination.

              • Otherwise, it is calculated from routing tables.

       -U     Unsolicited ARP mode to update neighbours' ARP caches.  No replies are expected.

       -V     Print version of the program and exit.

       -w deadline
              Specify a timeout, in seconds, before arping exits regardless of how many packets have  been  sent
              or  received.  In  this case arping does not stop after count packet are sent, it waits either for
              deadline expire or until count probes are answered.


SEE ALSO
       ping(8), clockdiff(8), tracepath(8).


AUTHOR
       arping was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.  It is now maintained by YOSHIFUJI Hideaki
       <yoshfuji@skbuff.net>.


SECURITY
       arping  requires CAP_NET_RAW capability to be executed. It is not recommended to be used as set-uid root,
       because it allows user to modify ARP caches of neighbour hosts.


AVAILABILITY
       arping  is  part  of  iputils  package  and  the  latest  versions  are   available  in  source  form  at
       http://www.skbuff.net/iputils/iputils-current.tar.bz2.