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