Return to arping.yodl CVS log

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

arping 2.13

    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(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 exclamation points and missing packets as dots.
   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: mancommand(.nf)
   81: mancommand(.sp)
   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.
   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>
   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)
  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
  108: 
  109:   --- 88.1.180.225 statistics ---
  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
  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
  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: 
  136:     Arping was written by Thomas Habets <thomas@habets.se>.
  137: 
  138:     http://www.habets.pp.se/synscan/
  139: 
  140:     git clone http://github.com/ThomasHabets/arping.git