summaryrefslogtreecommitdiff
path: root/arping.yodl
blob: 8ec0c1061d54893a6fc388f7a80e658169a23ee5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
manpage(arping)(8)(21th June, 2003)(arping)()

manpagename(arping)(sends arp and/or ip pings to a given host)

manpagesynopsis()
    bf(arping) [-abhpqrRd0uv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)]    \
[-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(us) ] <em(host) | -B>

manpagedescription()
    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.

    One request is sent each second.

    When pinging an IP an ARP who-has query is sent. When pinging a MAC
    address a directed broadcast ICMP Echo request is sent. For more
    technical explaination and an FAQ, see the README file.

    em(Important note on timing)

    ARP packets are usually replied to (on a LAN) so fast that the OS task
    scheduler can't keep up to get exact enough timing.
    On an idle system the roundtrip times will be pretty much accurate, but
    with more load the timing gets less exact.

    To get more exact timing on a non-idle system, re-nice arping to -15 or so.

    # nice -n -15 arping foobar

    This is not just an issue with arping, it is with normal ping also
    (at least it is on my system). But it doesn't show up as much with ping
    since arping packets (when pinging IP) doesn't traverse the IP stack when
    received and are therefore replied to faster.

manpageoptions()

startdit()

    dit(-0) Use this option to ping with source IP address 0.0.0.0. Use this
	when you haven't configured your interface yet.
	Note that this may get the MAC-ping unanswered.
	This is an alias for -S 0.0.0.0.
    dit(-a) Audible ping.
    dit(-A) Only count addresses matching requested address (This *WILL*
	break most things you do. Only useful if you are arpinging many
	hosts at once. See arping-scan-net.sh for an example).
    dit(-b) Like -0 but source broadcast source address (255.255.255.255).
Note that this may get the arping unanswered since it's not normal behavior
for a host.
    dit(-B) Use instead of host if you want to address 255.255.255.255.
    dit(-c em(count)) Only send em(count) requests.
    dit(-d) Find duplicate replies.
    dit(-F) Don't try to be smart about the interface name. (even if this
switch is not given, -i overrides smartness.
    dit(-h) Displays a help message and exits.
    dit(-i em(interface)) Use the specified interface.
    dit(-q) Does not display messages, except error messages.
    dit(-r) Raw output: only the MAC/IP address is displayed for each reply.
    dit(-R) Raw output: Like -r but shows "the other one", can be combined with
-r.
    dit(-s em(MAC)) Set source MAC address. You may need to use -p with this.
    dit(-S em(IP)) Like -b and -0 but with set source address.
Note that this may get the arping unanswered if the target does not have
routing to the IP. If you don't own the IP you are using, you may need to turn
on promiscious mode on the interface (with -p). With this switch you can find
out what IP-address a host has without taking an IP-address yourself.
    dit(-t em(MAC)) Set target MAC address to use when pinging IP address.
    dit(-T em(IP)) Use -T as target address when pinging MACs that won't
respond to a broadcast ping but perhaps to a directed broadcast.

em(Example):                                                                \
	To check the address of MAC-A, use knowledge of MAC-B and IP-B.

	$ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
    dit(-p) Turn on promiscious mode on interface, use this if you don't
            "own" the MAC address you are using.
    dit(-u) Show index=received/sent instead of just index=received when
	pinging MACs.
    dit(-v) Verbose output. Use twice for more messages.
    dit(-w) (arping 2.x only) Time to wait between pings, in microseconds.
enddit()

manpagebugs()

	You have to use -B instead of arpinging 255.255.255.255, and -b
	instead of -S 255.255.255.255. This is libnets fault.

manpageseealso()

    bf(ping(8)), bf(arp(8)), bf(rarp(8))

manpageauthor()

    Arping was written by Thomas Habets <thomas@habets.pp.se>.