1ARPING(8)                           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] [-i interval] [-s source]
10              [-I interface] {destination}
11

DESCRIPTION

13       Ping destination on device interface by ARP packets, using source
14       address source.
15
16       arping supports IPv4 addresses only. For IPv6, see ndisc6(8).
17

OPTIONS

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

SEE ALSO

76       ndisc6(8), ping(8), clockdiff(8), tracepath(8).
77

AUTHOR

79       arping was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.
80

SECURITY

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

AVAILABILITY

87       arping is part of iputils package.
88
89
90
91iputils 20221126                                                     ARPING(8)
Impressum