Annotation of embedaddon/arping/doc/arping.8, revision 1.1.1.3
1.1 misho 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"
1.1.1.2 misho 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 \fIus\fP ] <\fIhost\fP | \-B>
1.1 misho 9: .PP
1.1.1.2 misho 10: \fBarping\fP \-\-help
1.1 misho 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
1.1.1.2 misho 17: When pinging an IP an ARP who\-has query is sent\&. When pinging a MAC
1.1 misho 18: address a directed broadcast ICMP Echo request is sent\&. For more
19: technical explaination 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
1.1.1.2 misho 24: scheduler can\(cq\&t keep up to get exact enough timing\&.
1.1 misho 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
1.1.1.2 misho 28: To get more exact timing on a non\-idle system, re\-nice arping to \-15 or so\&.
1.1 misho 29: .PP
1.1.1.2 misho 30: # nice \-n \-15 arping foobar
1.1 misho 31: .PP
32: This is not just an issue with arping, it is with normal ping also
1.1.1.2 misho 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
1.1 misho 35: received and are therefore replied to faster\&.
36: .PP
37: .SH "OPTIONS"
38:
39: .PP
1.1.1.2 misho 40: .IP "\-\-help"
1.1 misho 41: Show extended help\&. Not quite as extensive as this manpage,
1.1.1.2 misho 42: but more than \-h\&.
43: .IP "\-0"
1.1 misho 44: Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this
1.1.1.2 misho 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"
1.1 misho 49: Audible ping\&.
1.1.1.2 misho 50: .IP "\-A"
1.1 misho 51: Only count addresses matching requested address (This *WILL*
52: break most things you do\&. Only useful if you are arpinging many
1.1.1.2 misho 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
1.1 misho 57: for a host\&.
1.1.1.2 misho 58: .IP "\-B"
1.1 misho 59: Use instead of host if you want to address 255\&.255\&.255\&.255\&.
1.1.1.2 misho 60: .IP "\-c \fIcount\fP"
1.1 misho 61: Only send \fIcount\fP requests\&.
1.1.1.3 ! misho 62: .IP "\-C \fIcount\fP"
! 63: Only wait for \fIcount\fP replies, regardless of \-c and \-w\&.
1.1.1.2 misho 64: .IP "\-d"
1.1 misho 65: Find duplicate replies\&. Exit with 1 if there are answers from
66: two different MAC addresses\&.
1.1.1.2 misho 67: .IP "\-D"
68: Display answers as exclamation points and missing packets as dots\&.
1.1 misho 69: Like flood ping on a Cisco\&.
1.1.1.2 misho 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 "\-h"
1.1 misho 76: Displays a help message and exits\&.
1.1.1.2 misho 77: .IP "\-i \fIinterface\fP"
78: Don\(cq\&t guess, use the specified interface\&.
1.1.1.3 ! misho 79: .IP "\-m \fItype\fP"
! 80: Type of timestamp to use for incoming packets\&.
! 81: Use \-vv when pinging to list available ones\&.
1.1.1.2 misho 82: .IP "\-p"
83: Turn on promiscious mode on interface, use this if you don\(cq\&t
84: \(dq\&own\(dq\& the MAC address you are using\&.
1.1.1.3 ! misho 85: .IP "\-P"
! 86: Send ARP replies instead of requests\&. Useful with \-U\&.
1.1.1.2 misho 87: .IP "\-q"
1.1 misho 88: Does not display messages, except error messages\&.
1.1.1.2 misho 89: .IP "\-r"
1.1 misho 90: Raw output: only the MAC/IP address is displayed for each reply\&.
1.1.1.2 misho 91: .IP "\-R"
92: Raw output: Like \-r but shows \(dq\&the other one\(dq\&, can be combined with
93: \-r\&.
94: .IP "\-s \fIMAC\fP"
95: Set source MAC address\&. You may need to use \-p with this\&.
96: .IP "\-S \fIIP\fP"
97: Like \-b and \-0 but with set source address\&.
1.1 misho 98: Note that this may get the arping unanswered if the target does not have
1.1.1.2 misho 99: routing to the IP\&. If you don\(cq\&t own the IP you are using, you may need to turn
100: on promiscious mode on the interface (with \-p)\&. With this switch you can find
101: out what IP\-address a host has without taking an IP\-address yourself\&.
102: .IP "\-t \fIMAC\fP"
1.1 misho 103: Set target MAC address to use when pinging IP address\&.
1.1.1.2 misho 104: .IP "\-T \fIIP\fP"
105: Use \-T as target address when pinging MACs that won\(cq\&t
1.1 misho 106: respond to a broadcast ping but perhaps to a directed broadcast\&.
107: .IP
1.1.1.2 misho 108: \fIExample\fP:
109: .nf
110: .sp
111: To check the address of MAC\-A, use knowledge of MAC\-B and IP\-B\&.
1.1 misho 112: .IP
1.1.1.2 misho 113: $ arping \-S <IP\-B> \-s <MAC\-B> \-p <MAC\-A>
114: .IP "\-u"
1.1 misho 115: Show index=received/sent instead of just index=received when
116: pinging MACs\&.
1.1.1.2 misho 117: .IP "\-U"
118: Send unsolicited ARP\&. This sets the destination MAC address in
119: the ARP frame to the broadcast address\&. Unsolicited ARP is used
120: to update the neighbours\(cq\& ARP caches\&.
121: .IP
122: \fIExample\fP:
123: .nf
124: .sp
125: $ arping \-i <interface> \-U <interface IP>
126: .IP "\-v"
1.1 misho 127: Verbose output\&. Use twice for more messages\&.
1.1.1.3 ! misho 128: .IP "\-w \fIusec\fP"
1.1 misho 129: Time to wait between pings, in microseconds\&.
1.1.1.3 ! misho 130: .IP "\-W \fIsec\fP"
! 131: Same as \-w, but in floating point seconds\&.
1.1 misho 132:
133: .PP
134: .SH "EXAMPLES"
135: .nf
136: .sp
1.1.1.2 misho 137: # \fBarping \-c 3 88\&.1\&.180\&.225\fP
138: ARPING 88\&.1\&.180\&.225
139: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=0 time=13\&.910 msec
140: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=1 time=13\&.935 msec
141: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=2 time=13\&.944 msec
1.1 misho 142: .PP
1.1.1.2 misho 143: \-\-\- 88\&.1\&.180\&.225 statistics \-\-\-
1.1 misho 144: 3 packets transmitted, 3 packets received, 0% unanswered
145: .PP
1.1.1.2 misho 146: # \fBarping \-c 3 00:11:85:4c:01:01\fP
1.1 misho 147: ARPING 00:11:85:4c:01:01
1.1.1.2 misho 148: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec
149: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec
150: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec
1.1 misho 151: .PP
1.1.1.2 misho 152: \-\-\- 00:11:85:4c:01:01 statistics \-\-\-
1.1 misho 153: 3 packets transmitted, 3 packets received, 0% unanswered
1.1.1.3 ! misho 154: .PP
! 155: # \fBarping \-C 2 \-c 10 \-r 88\&.1\&.180\&.225\fP
! 156: 00:11:85:4c:01:01
! 157: 00:11:85:4c:01:01
1.1 misho 158: .PP
159: .fi
160: .in
161: .PP
162: .SH "BUGS"
163:
164: .PP
1.1.1.2 misho 165: You have to use \-B instead of arpinging 255\&.255\&.255\&.255, and \-b
166: instead of \-S 255\&.255\&.255\&.255\&. This is libnets fault\&.
1.1 misho 167: .PP
168: .SH "SEE ALSO"
169:
170: .PP
171: \fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP
172: .PP
173: .SH "AUTHOR"
174:
175: .PP
1.1.1.2 misho 176: Arping was written by Thomas Habets <thomas@habets\&.se>\&.
1.1 misho 177: .PP
178: http://www\&.habets\&.pp\&.se/synscan/
179: .PP
180: git clone http://github\&.com/ThomasHabets/arping\&.git
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to arping.8 CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / arping / doc