arping

ARPING(8)              System Manager's Manual: iputils              ARPING(8)



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.  This
              option is required.

       -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:

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

              o In Unsolicited ARP mode (with options -U or -A) set to  desti-
                nation.

              o 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>.

SECURITY
       arping requires CAP_NET_RAWIO capability to be executed. It is not rec-
       ommended 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  avail-
       able in source  form  for  anonymous  ftp  ftp://ftp.inr.ac.ru/ip-rout-
       ing/iputils-current.tar.gz.



iputils-020927                 27 September 2002                     ARPING(8)