1: .TH "arping" "8" "21th June, 2003" "arping" ""
2:
3: .PP
4: .SH "NAME"
5: arping \- sends arp and/or ip pings to a given host
6: .PP
7: .SH "SYNOPSIS"
8: \fBarping\fP [\-0aAbBdDeFhpqrRuUv] [\-S \fIhost/ip\fP] [\-T \fIhost/ip\fP] [\-s \fIMAC\fP] [\-t \fIMAC\fP] [\-c \fIcount\fP] [\-i \fIinterface\fP] [ \-w \fIseconds\fP ] [ \-W \fIseconds\fP ] [ \-V \fIvlan\fP ] [ \-Q \fIpriority\fP ] [ \-g \fIgroup\fP ] <\fIhost\fP | \-B>
9: .PP
10: \fBarping\fP \-\-help
11: .PP
12: .SH "DESCRIPTION"
13: The \fIarping\fP utility sends \fBARP\fP and/or \fBICMP\fP requests to the specified \fIhost\fP and displays the replies\&. The \fIhost\fP may be specified by its \fBhostname\fP, its \fBIP\fP address, or its \fBMAC\fP address\&.
14: .PP
15: One request is sent each second\&.
16: .PP
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: .PP
21: \fINote on timing\fP
22: .PP
23: ARP packets are usually replied to (on a LAN) so fast that the OS task
24: scheduler can\(cq\&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: .PP
28: To get more exact timing on a non\-idle system, re\-nice arping to \-15 or so\&.
29: .PP
30: # nice \-n \-15 arping foobar
31: .PP
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\(cq\&t show up as much with ping
34: since arping packets (when pinging IP) doesn\(cq\&t traverse the IP stack when
35: received and are therefore replied to faster\&.
36: .PP
37: .SH "OPTIONS"
38:
39: .PP
40: .IP "\-\-help"
41: Show extended help\&. Not quite as extensive as this manpage,
42: but more than \-h\&.
43: .IP "\-0"
44: Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this
45: when you haven\(cq\&t configured your interface yet\&.
46: Note that this may get the MAC\-ping unanswered\&.
47: This is an alias for \-S 0\&.0\&.0\&.0\&.
48: .IP "\-a"
49: Audible ping\&.
50: .IP "\-A"
51: Only count addresses matching requested address (This *WILL*
52: break most things you do\&. Only useful if you are arpinging many
53: hosts at once\&. See arping\-scan\-net\&.sh for an example)\&.
54: .IP "\-b"
55: Like \-0 but source broadcast source address (255\&.255\&.255\&.255)\&.
56: Note that this may get the arping unanswered since it\(cq\&s not normal behavior
57: for a host\&.
58: .IP "\-B"
59: Use instead of host if you want to address 255\&.255\&.255\&.255\&.
60: .IP "\-c \fIcount\fP"
61: Only send \fIcount\fP requests\&.
62: .IP "\-C \fIcount\fP"
63: Only wait for \fIcount\fP replies, regardless of \-c and \-w\&.
64: .IP "\-d"
65: Find duplicate replies\&. Exit with 1 if there are answers from
66: two different MAC addresses\&.
67: .IP "\-D"
68: Display answers as exclamation points and missing packets as dots\&.
69: Like flood ping on a Cisco\&.
70: .IP "\-e"
71: Like \-a but beep when there is no reply\&.
72: .IP "\-F"
73: Don\(cq\&t try to be smart about the interface name\&. Even if this
74: switch is not given, \-i disables this smartness\&.
75: .IP "\-g \fIgroup\fP"
76: setgid() to this group instead of the nobody group\&.
77: .IP "\-h"
78: Displays a help message and exits\&.
79: .IP "\-i \fIinterface\fP"
80: Don\(cq\&t guess, use the specified interface\&.
81: .IP "\-m \fItype\fP"
82: Type of timestamp to use for incoming packets\&.
83: Use \-vv when pinging to list available ones\&.
84: .IP "\-p"
85: Turn on promiscious mode on interface, use this if you don\(cq\&t
86: \(dq\&own\(dq\& the MAC address you are using\&.
87: .IP "\-P"
88: Send ARP replies instead of requests\&. Useful with \-U\&.
89: .IP "\-q"
90: Does not display messages, except error messages\&.
91: .IP "\-Q \fIpriority\fP"
92: 802\&.1p priority to set\&. Should be used with 802\&.1Q tag (\-V)\&.
93: Defaults to 0\&.
94: .IP "\-r"
95: Raw output: only the MAC/IP address is displayed for each reply\&.
96: .IP "\-R"
97: Raw output: Like \-r but shows \(dq\&the other one\(dq\&, can be combined with
98: \-r\&.
99: .IP "\-s \fIMAC\fP"
100: Set source MAC address\&. You may need to use \-p with this\&.
101: .IP "\-S \fIIP\fP"
102: Like \-b and \-0 but with set source address\&.
103: Note that this may get the arping unanswered if the target does not have
104: routing to the IP\&. If you don\(cq\&t own the IP you are using, you may need to turn
105: on promiscious mode on the interface (with \-p)\&. With this switch you can find
106: out what IP\-address a host has without taking an IP\-address yourself\&.
107: .IP "\-t \fIMAC\fP"
108: Set target MAC address to use when pinging IP address\&.
109: .IP "\-T \fIIP\fP"
110: Use \-T as target address when pinging MACs that won\(cq\&t
111: respond to a broadcast ping but perhaps to a directed broadcast\&.
112: .IP
113: \fIExample\fP:
114: .nf
115: .sp
116: To check the address of MAC\-A, use knowledge of MAC\-B and IP\-B\&.
117: .IP
118: $ arping \-S <IP\-B> \-s <MAC\-B> \-p <MAC\-A>
119: .IP "\-u"
120: Show index=received/sent instead of just index=received when
121: pinging MACs\&.
122: .IP "\-U"
123: Send unsolicited ARP\&. This sets the destination MAC address in
124: the ARP frame to the broadcast address\&. Unsolicited ARP is used
125: to update the neighbours\(cq\& ARP caches\&.
126: .IP
127: \fIExample\fP:
128: .nf
129: .sp
130: $ arping \-i <interface> \-U <interface IP>
131: .IP "\-v"
132: Verbose output\&. Use twice for more messages\&.
133: .IP "\-V \fIvlan\fP"
134: VLAN tag to set\&. Defaults to no VLAN tag\&.
135: .IP "\-w \fIsec\fP"
136: Specify a timeout before ping exits regardless of how many packets have been sent or received\&.
137: .IP "\-W \fIsec\fP"
138: Time to wait between pings\&.
139:
140: .PP
141: .SH "EXAMPLES"
142: .nf
143: .sp
144: # \fBarping \-c 3 88\&.1\&.180\&.225\fP
145: ARPING 88\&.1\&.180\&.225
146: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=0 time=13\&.910 msec
147: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=1 time=13\&.935 msec
148: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=2 time=13\&.944 msec
149: .PP
150: \-\-\- 88\&.1\&.180\&.225 statistics \-\-\-
151: 3 packets transmitted, 3 packets received, 0% unanswered
152: .PP
153: # \fBarping \-c 3 00:11:85:4c:01:01\fP
154: ARPING 00:11:85:4c:01:01
155: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec
156: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec
157: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec
158: .PP
159: \-\-\- 00:11:85:4c:01:01 statistics \-\-\-
160: 3 packets transmitted, 3 packets received, 0% unanswered
161: .PP
162: # \fBarping \-C 2 \-c 10 \-r 88\&.1\&.180\&.225\fP
163: 00:11:85:4c:01:01
164: 00:11:85:4c:01:01
165: .PP
166: .fi
167: .in
168: .PP
169: .SH "BUGS"
170:
171: .PP
172: You have to use \-B instead of arpinging 255\&.255\&.255\&.255, and \-b
173: instead of \-S 255\&.255\&.255\&.255\&. This is libnets fault\&.
174: .PP
175: .SH "SEE ALSO"
176:
177: .PP
178: \fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP
179: .PP
180: .SH "AUTHOR"
181:
182: .PP
183: Arping was written by Thomas Habets <thomas@habets\&.se>\&.
184: .PP
185: http://www\&.habets\&.pp\&.se/synscan/
186: .PP
187: git clone http://github\&.com/ThomasHabets/arping\&.git
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>