NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR | SECURITY | AVAILABILITY | COLOPHON

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

NAME         top

       arping - send ARP REQUEST to a neighbour host

SYNOPSIS         top

       arping [-AbDfhqUV] [-c count] [-w deadline] [-s source] -I interface
       destination

DESCRIPTION         top

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

OPTIONS         top

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

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

SEE ALSO         top

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

AUTHOR         top

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

SECURITY         top

       arping requires CAP_NET_RAW 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         top

       arping is part of iputils package and the latest versions are
       available in source form at
       http://www.skbuff.net/iputils/iputils-current.tar.bz2.

COLOPHON         top

       This page is part of the iputils (IP utilities) project.  Information
       about the project can be found at ⟨http://www.skbuff.net/iputils/⟩.
       If you have a bug report for this manual page, send it to
       yoshfuji@skbuff.net, netdev@vger.kernel.org.  This page was obtained
       from the project's upstream Git repository 
       ⟨git://git.linux-ipv6.org/gitroot/iputils.git⟩ on 2017-05-03.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

iputils-151218                   03 May 2017                       ARPING(8)

Pages that refer to this page: clockdiff(8)rarpd(8)