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