1ARPING(8)              System Manager's Manual: iputils              ARPING(8)
2
3
4

NAME

6       arping - send ARP REQUEST to a neighbour host
7

SYNOPSIS

9       arping  [  -AbDfhqUV]   [  -c  count]  [ -w deadline]  [ -s source]  -I
10       interface destination
11
12

DESCRIPTION

14       Ping destination on device  interface  by  ARP  packets,  using  source
15       address source.
16

OPTIONS

18       -A     The  same  as  -U,  but  ARP  REPLY  packets used instead of ARP
19              REQUEST.
20
21       -b     Send only MAC level  broadcasts.  Normally  arping  starts  from
22              sending broadcast, and switch to unicast after reply received.
23
24       -c count
25              Stop  after  sending  count  ARP  REQUEST packets. With deadline
26              option, arping waits for count  ARP  REPLY  packets,  until  the
27              timeout expires.
28
29       -D     Duplicate  address  detection  mode  (DAD).  See RFC2131, 4.4.1.
30              Returns 0, if DAD succeeded i.e. no replies are received
31
32       -f     Finish after the first reply confirming that target is alive.
33
34       -I interface
35              Name of network device where to send ARP REQUEST  packets.  This
36              option is required.
37
38       -h     Print help page and exit.
39
40       -q     Quiet output. Nothing is displayed.
41
42       -s source
43              IP  source  address  to  use  in ARP packets.  If this option is
44              absent, source address is:
45
46              · In DAD mode (with option -D) set to 0.0.0.0.
47
48              · In Unsolicited ARP mode (with options -U or -A) set to  desti‐
49                nation.
50
51              · Otherwise, it is calculated from routing tables.
52
53       -U     Unsolicited  ARP  mode  to  update  neighbours'  ARP caches.  No
54              replies are expected.
55
56       -V     Print version of the program and exit.
57
58       -w deadline
59              Specify a timeout, in seconds, before arping exits regardless of
60              how many packets have been sent or received. In this case arping
61              does not stop after count packet are sent, it waits  either  for
62              deadline expire or until count probes are answered.
63

SEE ALSO

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

AUTHOR

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

SECURITY

72       arping requires CAP_NET_RAWIO capability to be executed. It is not rec‐
73       ommended  to  be used as set-uid root, because it allows user to modify
74       ARP caches of neighbour hosts.
75

AVAILABILITY

77       arping is part of iputils package and the latest versions  are   avail‐
78       able   in  source  form  at  http://www.skbuff.net/iputils/iputils-cur‐
79       rent.tar.bz2.
80
81
82
83iputils-070202                   06 April 2007                       ARPING(8)
Impressum