Return to arping.yodl CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / arping / doc

arping 2.21

    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) [-0aAbBdDeFhpqrRuUv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)]    \
    7: [-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(seconds) ] [ -W em(seconds) ] [ -V em(vlan) ] [ -Q em(priority) ] [ -g em(group) ] \
    8: <em(host) | -B>
    9: 
   10:     bf(arping) --help
   11: 
   12: manpagedescription()
   13:     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.
   14: 
   15:     One request is sent each second.
   16: 
   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 explanation and an FAQ, see the README file.
   20: 
   21:     em(Note on timing)
   22: 
   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: 
   28:     To get more exact timing on a non-idle system, re-nice arping to -15 or so.
   29: 
   30:     # nice -n -15 arping foobar
   31: 
   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: 
   37: manpageoptions()
   38: 
   39: startdit()
   40:     dit(--help) Show extended help. Not quite as extensive as this manpage,
   41:         but more than -h.
   42:     dit(-0) Use this option to ping with source IP address 0.0.0.0. Use this
   43: 	when you haven't configured your interface yet.
   44: 	Note that this may get the MAC-ping unanswered.
   45: 	This is an alias for -S 0.0.0.0.
   46:     dit(-a) Audible ping.
   47:     dit(-A) Only count addresses matching requested address (This *WILL*
   48: 	break most things you do. Only useful if you are arpinging many
   49: 	hosts at once. See arping-scan-net.sh for an example).
   50:     dit(-b) Like -0 but source broadcast source address (255.255.255.255).
   51: Note that this may get the arping unanswered since it's not normal behavior
   52: for a host.
   53:     dit(-B) Use instead of host if you want to address 255.255.255.255.
   54:     dit(-c em(count)) Only send em(count) requests.
   55:     dit(-C em(count)) Only wait for em(count) replies, regardless of -c and -w.
   56:     dit(-d) Find duplicate replies. Exit with 1 if there are answers from
   57:         two different MAC addresses.
   58:     dit(-D) Display answers as exclamation points and missing packets as dots.
   59:         Like flood ping on a Cisco.
   60:     dit(-e) Like -a but beep when there is no reply.
   61:     dit(-F) Don't try to be smart about the interface name. Even if this
   62: switch is not given, -i disables this smartness.
   63:     dit(-g em(group)) setgid() to this group instead of the nobody group.
   64:     dit(-h) Displays a help message and exits.
   65:     dit(-i em(interface)) Don't guess, use the specified interface.
   66:     dit(-m em(type)) Type of timestamp to use for incoming packets.
   67:         Use -vv when pinging to list available ones.
   68:     dit(-p) Turn on promiscious mode on interface, use this if you don't
   69:             "own" the MAC address you are using.
   70:     dit(-P) Send ARP replies instead of requests. Useful with -U.
   71:     dit(-q) Does not display messages, except error messages.
   72:     dit(-Q em(priority)) 802.1p priority to set. Should be used with 802.1Q tag (-V).
   73:         Defaults to 0.
   74:     dit(-r) Raw output: only the MAC/IP address is displayed for each reply.
   75:     dit(-R) Raw output: Like -r but shows "the other one", can be combined with
   76: -r.
   77:     dit(-s em(MAC)) Set source MAC address. You may need to use -p with this.
   78:     dit(-S em(IP)) Like -b and -0 but with set source address.
   79: Note that this may get the arping unanswered if the target does not have
   80: routing to the IP. If you don't own the IP you are using, you may need to turn
   81: on promiscious mode on the interface (with -p). With this switch you can find
   82: out what IP-address a host has without taking an IP-address yourself.
   83:     dit(-t em(MAC)) Set target MAC address to use when pinging IP address.
   84:     dit(-T em(IP)) Use -T as target address when pinging MACs that won't
   85: respond to a broadcast ping but perhaps to a directed broadcast.
   86: 
   87: em(Example):
   88: mancommand(.nf)
   89: mancommand(.sp)
   90: 	To check the address of MAC-A, use knowledge of MAC-B and IP-B.
   91: 
   92: 	$ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
   93:     dit(-u) Show index=received/sent instead of just index=received when
   94: 	pinging MACs.
   95:     dit(-U) Send unsolicited ARP. This sets the destination MAC address in
   96:     the ARP frame to the broadcast address. Unsolicited ARP is used
   97:     to update the neighbours' ARP caches.
   98: 
   99: 	em(Example):
  100:         mancommand(.nf)
  101:         mancommand(.sp)
  102: 	$ arping -i <interface> -U <interface IP>
  103:     dit(-v) Verbose output. Use twice for more messages.
  104:     dit(-V em(vlan)) VLAN tag to set. Defaults to no VLAN tag.
  105:     dit(-w em(sec)) Specify a timeout before ping exits regardless of how many packets have been sent or received.
  106:     dit(-W em(sec)) Time to wait between pings.
  107: enddit()
  108: 
  109: 
  110: manpagesection(EXAMPLES)
  111: mancommand(.nf)
  112: mancommand(.sp)
  113:   # bf(arping -c 3 88.1.180.225)
  114:   ARPING 88.1.180.225
  115:   60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec
  116:   60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec
  117:   60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=2 time=13.944 msec
  118: 
  119:   --- 88.1.180.225 statistics ---
  120:   3 packets transmitted, 3 packets received,   0% unanswered
  121: 
  122:   # bf(arping -c 3 00:11:85:4c:01:01)
  123:   ARPING 00:11:85:4c:01:01
  124:   60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec
  125:   60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec
  126:   60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=2 time=13.929 msec
  127: 
  128:   --- 00:11:85:4c:01:01 statistics ---
  129:   3 packets transmitted, 3 packets received,   0% unanswered
  130: 
  131:   # bf(arping -C 2 -c 10 -r 88.1.180.225)
  132:   00:11:85:4c:01:01
  133:   00:11:85:4c:01:01
  134: 
  135: mancommand(.fi)
  136: mancommand(.in)
  137: 
  138: 
  139: manpagebugs()
  140: 
  141: 	You have to use -B instead of arpinging 255.255.255.255, and -b
  142: 	instead of -S 255.255.255.255. This is libnets fault.
  143: 
  144: manpageseealso()
  145: 
  146:     bf(ping(8)), bf(arp(8)), bf(rarp(8))
  147: 
  148: manpageauthor()
  149: 
  150:     Arping was written by Thomas Habets <thomas@habets.se>.
  151: 
  152:     http://www.habets.pp.se/synscan/
  153: 
  154:     git clone http://github.com/ThomasHabets/arping.git