Annotation of embedaddon/arping/doc/arping.8, revision 1.1.1.2
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.2 ! misho 62: .IP "\-d"
1.1 misho 63: Find duplicate replies\&. Exit with 1 if there are answers from
64: two different MAC addresses\&.
1.1.1.2 ! misho 65: .IP "\-D"
! 66: Display answers as exclamation points and missing packets as dots\&.
1.1 misho 67: Like flood ping on a Cisco\&.
1.1.1.2 ! misho 68: .IP "\-e"
! 69: Like \-a but beep when there is no reply\&.
! 70: .IP "\-F"
! 71: Don\(cq\&t try to be smart about the interface name\&. Even if this
! 72: switch is not given, \-i disables this smartness\&.
! 73: .IP "\-h"
1.1 misho 74: Displays a help message and exits\&.
1.1.1.2 ! misho 75: .IP "\-i \fIinterface\fP"
! 76: Don\(cq\&t guess, use the specified interface\&.
! 77: .IP "\-p"
! 78: Turn on promiscious mode on interface, use this if you don\(cq\&t
! 79: \(dq\&own\(dq\& the MAC address you are using\&.
! 80: .IP "\-q"
1.1 misho 81: Does not display messages, except error messages\&.
1.1.1.2 ! misho 82: .IP "\-r"
1.1 misho 83: Raw output: only the MAC/IP address is displayed for each reply\&.
1.1.1.2 ! misho 84: .IP "\-R"
! 85: Raw output: Like \-r but shows \(dq\&the other one\(dq\&, can be combined with
! 86: \-r\&.
! 87: .IP "\-s \fIMAC\fP"
! 88: Set source MAC address\&. You may need to use \-p with this\&.
! 89: .IP "\-S \fIIP\fP"
! 90: Like \-b and \-0 but with set source address\&.
1.1 misho 91: Note that this may get the arping unanswered if the target does not have
1.1.1.2 ! misho 92: routing to the IP\&. If you don\(cq\&t own the IP you are using, you may need to turn
! 93: on promiscious mode on the interface (with \-p)\&. With this switch you can find
! 94: out what IP\-address a host has without taking an IP\-address yourself\&.
! 95: .IP "\-t \fIMAC\fP"
1.1 misho 96: Set target MAC address to use when pinging IP address\&.
1.1.1.2 ! misho 97: .IP "\-T \fIIP\fP"
! 98: Use \-T as target address when pinging MACs that won\(cq\&t
1.1 misho 99: respond to a broadcast ping but perhaps to a directed broadcast\&.
100: .IP
1.1.1.2 ! misho 101: \fIExample\fP:
! 102: .nf
! 103: .sp
! 104: To check the address of MAC\-A, use knowledge of MAC\-B and IP\-B\&.
1.1 misho 105: .IP
1.1.1.2 ! misho 106: $ arping \-S <IP\-B> \-s <MAC\-B> \-p <MAC\-A>
! 107: .IP "\-u"
1.1 misho 108: Show index=received/sent instead of just index=received when
109: pinging MACs\&.
1.1.1.2 ! misho 110: .IP "\-U"
! 111: Send unsolicited ARP\&. This sets the destination MAC address in
! 112: the ARP frame to the broadcast address\&. Unsolicited ARP is used
! 113: to update the neighbours\(cq\& ARP caches\&.
! 114: .IP
! 115: \fIExample\fP:
! 116: .nf
! 117: .sp
! 118: $ arping \-i <interface> \-U <interface IP>
! 119: .IP "\-v"
1.1 misho 120: Verbose output\&. Use twice for more messages\&.
1.1.1.2 ! misho 121: .IP "\-w"
1.1 misho 122: Time to wait between pings, in microseconds\&.
123:
124: .PP
125: .SH "EXAMPLES"
126: .nf
127: .sp
1.1.1.2 ! misho 128: # \fBarping \-c 3 88\&.1\&.180\&.225\fP
! 129: ARPING 88\&.1\&.180\&.225
! 130: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=0 time=13\&.910 msec
! 131: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=1 time=13\&.935 msec
! 132: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=2 time=13\&.944 msec
1.1 misho 133: .PP
1.1.1.2 ! misho 134: \-\-\- 88\&.1\&.180\&.225 statistics \-\-\-
1.1 misho 135: 3 packets transmitted, 3 packets received, 0% unanswered
136: .PP
1.1.1.2 ! misho 137: # \fBarping \-c 3 00:11:85:4c:01:01\fP
1.1 misho 138: ARPING 00:11:85:4c:01:01
1.1.1.2 ! misho 139: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec
! 140: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec
! 141: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec
1.1 misho 142: .PP
1.1.1.2 ! misho 143: \-\-\- 00:11:85:4c:01:01 statistics \-\-\-
1.1 misho 144: 3 packets transmitted, 3 packets received, 0% unanswered
145: .PP
146: .fi
147: .in
148: .PP
149: .SH "BUGS"
150:
151: .PP
1.1.1.2 ! misho 152: You have to use \-B instead of arpinging 255\&.255\&.255\&.255, and \-b
! 153: instead of \-S 255\&.255\&.255\&.255\&. This is libnets fault\&.
1.1 misho 154: .PP
155: .SH "SEE ALSO"
156:
157: .PP
158: \fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP
159: .PP
160: .SH "AUTHOR"
161:
162: .PP
1.1.1.2 ! misho 163: Arping was written by Thomas Habets <thomas@habets\&.se>\&.
1.1 misho 164: .PP
165: http://www\&.habets\&.pp\&.se/synscan/
166: .PP
167: git clone http://github\&.com/ThomasHabets/arping\&.git
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>