Annotation of embedaddon/arping/doc/arping.yodl, revision 1.1.1.2
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()
1.1.1.2 ! misho 6: bf(arping) [-0aAbBdDeFhpqrRuUv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)] \
1.1 misho 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.
1.1.1.2 ! misho 56: dit(-D) Display answers as exclamation points and missing packets as dots.
1.1 misho 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:
1.1.1.2 ! misho 79: em(Example):
! 80: mancommand(.nf)
! 81: mancommand(.sp)
1.1 misho 82: To check the address of MAC-A, use knowledge of MAC-B and IP-B.
83:
84: $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
85: dit(-u) Show index=received/sent instead of just index=received when
86: pinging MACs.
1.1.1.2 ! misho 87: dit(-U) Send unsolicited ARP. This sets the destination MAC address in
! 88: the ARP frame to the broadcast address. Unsolicited ARP is used
! 89: to update the neighbours' ARP caches.
! 90:
! 91: em(Example):
! 92: mancommand(.nf)
! 93: mancommand(.sp)
! 94: $ arping -i <interface> -U <interface IP>
1.1 misho 95: dit(-v) Verbose output. Use twice for more messages.
96: dit(-w) Time to wait between pings, in microseconds.
97: enddit()
98:
99:
100: manpagesection(EXAMPLES)
101: mancommand(.nf)
102: mancommand(.sp)
1.1.1.2 ! misho 103: # bf(arping -c 3 88.1.180.225)
! 104: ARPING 88.1.180.225
! 105: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec
! 106: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec
! 107: 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=2 time=13.944 msec
1.1 misho 108:
1.1.1.2 ! misho 109: --- 88.1.180.225 statistics ---
1.1 misho 110: 3 packets transmitted, 3 packets received, 0% unanswered
111:
112: # bf(arping -c 3 00:11:85:4c:01:01)
113: ARPING 00:11:85:4c:01:01
1.1.1.2 ! misho 114: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec
! 115: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec
! 116: 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=2 time=13.929 msec
1.1 misho 117:
118: --- 00:11:85:4c:01:01 statistics ---
119: 3 packets transmitted, 3 packets received, 0% unanswered
120:
121: mancommand(.fi)
122: mancommand(.in)
123:
124:
125: manpagebugs()
126:
127: You have to use -B instead of arpinging 255.255.255.255, and -b
128: instead of -S 255.255.255.255. This is libnets fault.
129:
130: manpageseealso()
131:
132: bf(ping(8)), bf(arp(8)), bf(rarp(8))
133:
134: manpageauthor()
135:
1.1.1.2 ! misho 136: Arping was written by Thomas Habets <thomas@habets.se>.
1.1 misho 137:
138: http://www.habets.pp.se/synscan/
139:
140: 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