MAN page from PLD arping-2.13-1.i686.rpm

arping

Section: (8)
Updated: 21th June, 2003
Index

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 MACaddress a directed broadcast ICMP Echo request is sent. For moretechnical 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 taskscheduler can't keep up to get exact enough timing.On an idle system the roundtrip times will be pretty much accurate, butwith 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 pingsince arping packets (when pinging IP) doesn't traverse the IP stack whenreceived 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 thiswhen 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 manyhosts 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 behaviorfor a host.

-B

Use instead of host if you want to address 255.255.255.255.

-c count

Only send count requests.

-d

Find duplicate replies. Exit with 1 if there are answers fromtwo 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 thisswitch 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.

-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 haverouting to the IP. If you don't own the IP you are using, you may need to turnon promiscious mode on the interface (with -p). With this switch you can findout 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'trespond 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 whenpinging MACs.
-U
Send unsolicited ARP. This sets the destination MAC address inthe ARP frame to the broadcast address. Unsolicited ARP is usedto update the neighbours' ARP caches.
Example:$ arping -i <interface> -U <interface IP>
-v
Verbose output. Use twice for more messages.
-w
Time to wait between pings, in microseconds.

EXAMPLES

# arping -c 3 88.1.180.225ARPING 88.1.180.22560 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec60 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:01ARPING 00:11:85:4c:01:0160 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec60 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