1: manpage(arping)(8)(21th June, 2003)(arping)()
2:
3: manpagename(arping)(sends arp and/or ip pings to a given host)
4:
5: manpagesynopsis()
6: bf(arping) [-0aAbBdDeFhpqrRuUv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)] \
7: [-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(seconds) ] [ -W em(seconds) ] [ -V em(vlan) ] [ -Q em(priority) ] [ -g em(group) ] \
8: <em(host) | -B>
9:
10: bf(arping) --help
11:
12: manpagedescription()
13: The em(arping) utility sends bf(ARP) and/or bf(ICMP) requests to the specified em(host) and displays the replies. The em(host) may be specified by its bf(hostname), its bf(IP) address, or its bf(MAC) address.
14:
15: One request is sent each second.
16:
17: When pinging an IP an ARP who-has query is sent. When pinging a MAC
18: address a directed broadcast ICMP Echo request is sent. For more
19: technical explanation and an FAQ, see the README file.
20:
21: em(Note on timing)
22:
23: ARP packets are usually replied to (on a LAN) so fast that the OS task
24: scheduler can't keep up to get exact enough timing.
25: On an idle system the roundtrip times will be pretty much accurate, but
26: with more load the timing gets less exact.
27:
28: To get more exact timing on a non-idle system, re-nice arping to -15 or so.
29:
30: # nice -n -15 arping foobar
31:
32: This is not just an issue with arping, it is with normal ping also
33: (at least it is on my system). But it doesn't show up as much with ping
34: since arping packets (when pinging IP) doesn't traverse the IP stack when
35: received and are therefore replied to faster.
36:
37: manpageoptions()
38:
39: startdit()
40: dit(--help) Show extended help. Not quite as extensive as this manpage,
41: but more than -h.
42: dit(-0) Use this option to ping with source IP address 0.0.0.0. Use this
43: when you haven't configured your interface yet.
44: Note that this may get the MAC-ping unanswered.
45: This is an alias for -S 0.0.0.0.
46: dit(-a) Audible ping.
47: dit(-A) Only count addresses matching requested address (This *WILL*
48: break most things you do. Only useful if you are arpinging many
49: hosts at once. See arping-scan-net.sh for an example).
50: dit(-b) Like -0 but source broadcast source address (255.255.255.255).
51: Note that this may get the arping unanswered since it's not normal behavior
52: for a host.
53: dit(-B) Use instead of host if you want to address 255.255.255.255.
54: dit(-c em(count)) Only send em(count) requests.
55: dit(-C em(count)) Only wait for em(count) replies, regardless of -c and -w.
56: dit(-d) Find duplicate replies. Exit with 1 if there are answers from
57: two different MAC addresses.
58: dit(-D) Display answers as exclamation points and missing packets as dots.
59: Like flood ping on a Cisco.
60: dit(-e) Like -a but beep when there is no reply.
61: dit(-F) Don't try to be smart about the interface name. Even if this
62: switch is not given, -i disables this smartness.
63: dit(-g em(group)) setgid() to this group instead of the nobody group.
64: dit(-h) Displays a help message and exits.
65: dit(-i em(interface)) Don't guess, use the specified interface.
66: dit(-m em(type)) Type of timestamp to use for incoming packets.
67: Use -vv when pinging to list available ones.
68: dit(-p) Turn on promiscious mode on interface, use this if you don't
69: "own" the MAC address you are using.
70: dit(-P) Send ARP replies instead of requests. Useful with -U.
71: dit(-q) Does not display messages, except error messages.
72: dit(-Q em(priority)) 802.1p priority to set. Should be used with 802.1Q tag (-V).
73: Defaults to 0.
74: dit(-r) Raw output: only the MAC/IP address is displayed for each reply.
75: dit(-R) Raw output: Like -r but shows "the other one", can be combined with
76: -r.
77: dit(-s em(MAC)) Set source MAC address. You may need to use -p with this.
78: dit(-S em(IP)) Like -b and -0 but with set source address.
79: Note that this may get the arping unanswered if the target does not have
80: routing to the IP. If you don't own the IP you are using, you may need to turn
81: on promiscious mode on the interface (with -p). With this switch you can find
82: out what IP-address a host has without taking an IP-address yourself.
83: dit(-t em(MAC)) Set target MAC address to use when pinging IP address.
84: dit(-T em(IP)) Use -T as target address when pinging MACs that won't
85: respond to a broadcast ping but perhaps to a directed broadcast.
86:
87: em(Example):
88: mancommand(.nf)
89: mancommand(.sp)
90: To check the address of MAC-A, use knowledge of MAC-B and IP-B.
91:
92: $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
93: dit(-u) Show index=received/sent instead of just index=received when
94: pinging MACs.
95: dit(-U) Send unsolicited ARP. This sets the destination MAC address in
96: the ARP frame to the broadcast address. Unsolicited ARP is used
97: to update the neighbours' ARP caches.
98:
99: em(Example):
100: mancommand(.nf)
101: mancommand(.sp)
102: $ arping -i <interface> -U <interface IP>
103: dit(-v) Verbose output. Use twice for more messages.
104: dit(-V em(vlan)) VLAN tag to set. Defaults to no VLAN tag.
105: dit(-w em(sec)) Specify a timeout before ping exits regardless of how many packets have been sent or received.
106: dit(-W em(sec)) Time to wait between pings.
107: enddit()
108:
109:
110: manpagesection(EXAMPLES)
111: mancommand(.nf)
112: mancommand(.sp)
113: # bf(arping -c 3 88.1.180.225)
114: ARPING 88.1.180.225
115: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec
116: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec
117: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=2 time=13.944 msec
118:
119: --- 88.1.180.225 statistics ---
120: 3 packets transmitted, 3 packets received, 0% unanswered
121:
122: # bf(arping -c 3 00:11:85:4c:01:01)
123: ARPING 00:11:85:4c:01:01
124: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec
125: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec
126: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=2 time=13.929 msec
127:
128: --- 00:11:85:4c:01:01 statistics ---
129: 3 packets transmitted, 3 packets received, 0% unanswered
130:
131: # bf(arping -C 2 -c 10 -r 88.1.180.225)
132: 00:11:85:4c:01:01
133: 00:11:85:4c:01:01
134:
135: mancommand(.fi)
136: mancommand(.in)
137:
138:
139: manpagebugs()
140:
141: You have to use -B instead of arpinging 255.255.255.255, and -b
142: instead of -S 255.255.255.255. This is libnets fault.
143:
144: manpageseealso()
145:
146: bf(ping(8)), bf(arp(8)), bf(rarp(8))
147:
148: manpageauthor()
149:
150: Arping was written by Thomas Habets <thomas@habets.se>.
151:
152: http://www.habets.pp.se/synscan/
153:
154: git clone http://github.com/ThomasHabets/arping.git
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>