Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  ARPING (8)


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



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

arping --help


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\(cqt 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\(cqt show up as much with ping since arping packets (when pinging IP) doesn\(cqt traverse the IP stack when received and are therefore replied to faster.


--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 Use this when you haven\(cqt configured your interface yet. Note that this may get the MAC-ping unanswered. This is an alias for -S
-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 for an example).
-b Like -0 but source broadcast source address ( Note that this may get the arping unanswered since it\(cqs not normal behavior for a host.
-B Use instead of host if you want to address
-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\(cqt 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\(cqt guess, use the specified interface.
-m type Type of timestamp to use for incoming packets. Use -vv when pinging to list available ones.
-p Turn on promiscious mode on interface, use this if you don\(cqt \(dqown\(dq 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 \(dqthe other one\(dq, 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\(cqt 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\(cqt respond to a broadcast ping but perhaps to a directed broadcast.

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\(cq ARP caches.

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


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

--- 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 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec 60 bytes from (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec 60 bytes from (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 00:11:85:4c:01:01 00:11:85:4c:01:01


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


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


Arping was written by Thomas Habets <>.

git clone

Search for    or go to Top of page |  Section 8 |  Main Index

arping ARPING (8) 21th June, 2003

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.