Provided by: arping_2.14-1_i386 bug

NAME

       arping - sends arp and/or ip pings to a given host

SYNOPSIS

       arping  [-0aAbBdDeFhpqrRuUv]  [-S host/ip] [-T host/ip] [-s MAC]    [-t
       MAC] [-c count] [-i interface] [ -w us ] <host | -B>

       arping --help

DESCRIPTION

       The arping utility sends ARP and/or ICMP requests to the specified host
       and  displays  the  replies. The host may be specified by its hostname,
       its IP address, or its MAC address.

       One request is sent each second.

       When pinging an IP an ARP who-has query is sent.  When  pinging  a  MAC
       address  a  directed  broadcast  ICMP  Echo  request  is sent. For more
       technical explaination and an FAQ, see the README file.

       Note on timing

       ARP packets are usually replied to (on a LAN) so fast that the OS  task
       scheduler  can’t keep up to get exact enough timing.  On an idle system
       the roundtrip times will be pretty much accurate, but  with  more  load
       the timing gets less exact.

       To get more exact timing on a non-idle system, re-nice arping to -15 or
       so.

       # nice -n -15 arping foobar

       This is not just an issue with arping, it is with normal ping also  (at
       least  it  is  on  my system). But it doesn’t show up as much with ping
       since arping packets (when pinging IP) doesn’t traverse  the  IP  stack
       when received and are therefore replied to faster.

OPTIONS

       --help Show  extended help. Not quite as extensive as this manpage, but
              more than -h.

       -0     Use this option to ping with source IP address 0.0.0.0. Use this
              when  you haven’t configured your interface yet.  Note that this
              may get the MAC-ping  unanswered.   This  is  an  alias  for  -S
              0.0.0.0.

       -a     Audible ping.

       -A     Only  count  addresses  matching  requested address (This *WILL*
              break most things you do. Only useful if you are arpinging  many
              hosts at once. See arping-scan-net.sh for an example).

       -b     Like  -0  but source broadcast source address (255.255.255.255).
              Note that this may get the  arping  unanswered  since  it’s  not
              normal behavior for a host.

       -B     Use instead of host if you want to address 255.255.255.255.

       -c count
              Only send count requests.

       -C count
              Only wait for count replies, regardless of -c and -w.

       -d     Find  duplicate  replies.  Exit with 1 if there are answers from
              two different MAC addresses.

       -D     Display answers as exclamation points  and  missing  packets  as
              dots.  Like flood ping on a Cisco.

       -e     Like -a but beep when there is no reply.

       -F     Don’t  try  to  be  smart about the interface name. Even if this
              switch is not given, -i disables this smartness.

       -h     Displays a help message and exits.

       -i interface
              Don’t guess, use the specified interface.

       -p     Turn on promiscious mode on interface, use  this  if  you  don’t
              "own" the MAC address you are using.

       -P     Send ARP replies instead of requests. Useful with -U.

       -q     Does not display messages, except error messages.

       -r     Raw output: only the MAC/IP address is displayed for each reply.

       -R     Raw  output:  Like -r but shows "the other one", can be combined
              with -r.

       -s MAC Set source MAC address. You may need to use -p with this.

       -S IP  Like -b and -0 but with set source address.  Note that this  may
              get the arping unanswered if the target does not have routing to
              the IP. If you don’t own the IP you are using, you may  need  to
              turn  on  promiscious mode on the interface (with -p). With this
              switch you can find out  what  IP-address  a  host  has  without
              taking an IP-address yourself.

       -t MAC Set target MAC address to use when pinging IP address.

       -T IP  Use -T as target address when pinging MACs that won’t respond to
              a broadcast ping but perhaps to a directed broadcast.

              Example:

              To check the address of MAC-A, use knowledge of MAC-B and IP-B.

              $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>

       -u     Show index=received/sent instead of just index=received when
              pinging MACs.

       -U     Send unsolicited ARP. This sets the destination MAC address in
              the ARP frame to the broadcast address. Unsolicited ARP is used
              to update the neighbours’ ARP caches.

              Example:

              $ arping -i <interface> -U <interface IP>

       -v     Verbose output. Use twice for more messages.

       -w usec
              Time to wait between pings, in microseconds.

       -W sec Same as -w, but in floating point seconds.

EXAMPLES

       # arping -c 3 88.1.180.225
       ARPING 88.1.180.225
       60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec
       60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec
       60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=2 time=13.944 msec

       --- 88.1.180.225 statistics ---
       3 packets transmitted, 3 packets received,   0% unanswered

       # arping -c 3 00:11:85:4c:01:01
       ARPING 00:11:85:4c:01:01
       60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec
       60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec
       60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=2 time=13.929 msec

       --- 00:11:85:4c:01:01 statistics ---
       3 packets transmitted, 3 packets received,   0% unanswered

       # arping -C 2 -c 10 -r 88.1.180.225
       00:11:85:4c:01:01
       00:11:85:4c:01:01

BUGS

       You have to use -B instead of arpinging 255.255.255.255, and -b instead
       of -S 255.255.255.255. This is libnets fault.

SEE ALSO

       ping(8), arp(8), rarp(8)

AUTHOR

       Arping was written by Thomas Habets <thomas@habets.se>.

       http://www.habets.pp.se/synscan/

       git clone http://github.com/ThomasHabets/arping.git