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>.  It is
       now maintained by YOSHIFUJI Hideaki <yoshfuji@skbuff.net>.

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	at  http://www.skbuff.net/iputils/iputils-cur-
       rent.tar.bz2.



iputils-071127		       10 December 2007 		     ARPING(8)