8:arping

From Linux Man Pages

Jump to: navigation, search
      arping - send ARP REQUEST to a neighbour host
      
      arping [ -AbDfhqUV]  [ -c count]  [ -w deadline]  [ -s source]  -I interface destination

Contents

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 pack-
             ets, 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:
 
             � 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.

RELATED

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

SECURITY

      arping requires CAP_NET_RAWIO 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 for anonymous ftp
      ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

CATEGORY

Personal tools