Return to arping.8 CVS log

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

arping v2.15

    1: .TH "arping" "8" "21th June, 2003" "arping" ""
    2: 
    3: .PP 
    4: .SH "NAME"
    5: arping \- sends arp and/or ip pings to a given host
    6: .PP 
    7: .SH "SYNOPSIS"
    8: \fBarping\fP [\-0aAbBdDeFhpqrRuUv] [\-S \fIhost/ip\fP] [\-T \fIhost/ip\fP] [\-s \fIMAC\fP]    [\-t \fIMAC\fP] [\-c \fIcount\fP] [\-i \fIinterface\fP] [ \-w \fIus\fP ] <\fIhost\fP | \-B>
    9: .PP 
   10: \fBarping\fP \-\-help
   11: .PP 
   12: .SH "DESCRIPTION"
   13: The \fIarping\fP utility sends \fBARP\fP and/or \fBICMP\fP requests to the specified \fIhost\fP and displays the replies\&. The \fIhost\fP may be specified by its \fBhostname\fP, its \fBIP\fP address, or its \fBMAC\fP address\&.
   14: .PP 
   15: One request is sent each second\&.
   16: .PP 
   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 explaination and an FAQ, see the README file\&.
   20: .PP 
   21: \fINote on timing\fP
   22: .PP 
   23: ARP packets are usually replied to (on a LAN) so fast that the OS task
   24: scheduler can\(cq\&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: .PP 
   28: To get more exact timing on a non\-idle system, re\-nice arping to \-15 or so\&.
   29: .PP 
   30: # nice \-n \-15 arping foobar
   31: .PP 
   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\(cq\&t show up as much with ping
   34: since arping packets (when pinging IP) doesn\(cq\&t traverse the IP stack when
   35: received and are therefore replied to faster\&.
   36: .PP 
   37: .SH "OPTIONS"
   38: 
   39: .PP 
   40: .IP "\-\-help"
   41: Show extended help\&. Not quite as extensive as this manpage,
   42: but more than \-h\&.
   43: .IP "\-0"
   44: Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this
   45: when you haven\(cq\&t configured your interface yet\&.
   46: Note that this may get the MAC\-ping unanswered\&.
   47: This is an alias for \-S 0\&.0\&.0\&.0\&.
   48: .IP "\-a"
   49: Audible ping\&.
   50: .IP "\-A"
   51: Only count addresses matching requested address (This *WILL*
   52: break most things you do\&. Only useful if you are arpinging many
   53: hosts at once\&. See arping\-scan\-net\&.sh for an example)\&.
   54: .IP "\-b"
   55: Like \-0 but source broadcast source address (255\&.255\&.255\&.255)\&.
   56: Note that this may get the arping unanswered since it\(cq\&s not normal behavior
   57: for a host\&.
   58: .IP "\-B"
   59: Use instead of host if you want to address 255\&.255\&.255\&.255\&.
   60: .IP "\-c \fIcount\fP"
   61: Only send \fIcount\fP requests\&.
   62: .IP "\-C \fIcount\fP"
   63: Only wait for \fIcount\fP replies, regardless of \-c and \-w\&.
   64: .IP "\-d"
   65: Find duplicate replies\&. Exit with 1 if there are answers from
   66: two different MAC addresses\&.
   67: .IP "\-D"
   68: Display answers as exclamation points and missing packets as dots\&.
   69: Like flood ping on a Cisco\&.
   70: .IP "\-e"
   71: Like \-a but beep when there is no reply\&.
   72: .IP "\-F"
   73: Don\(cq\&t try to be smart about the interface name\&. Even if this
   74: switch is not given, \-i disables this smartness\&.
   75: .IP "\-h"
   76: Displays a help message and exits\&.
   77: .IP "\-i \fIinterface\fP"
   78: Don\(cq\&t guess, use the specified interface\&.
   79: .IP "\-m \fItype\fP"
   80: Type of timestamp to use for incoming packets\&.
   81: Use \-vv when pinging to list available ones\&.
   82: .IP "\-p"
   83: Turn on promiscious mode on interface, use this if you don\(cq\&t
   84: \(dq\&own\(dq\& the MAC address you are using\&.
   85: .IP "\-P"
   86: Send ARP replies instead of requests\&. Useful with \-U\&.
   87: .IP "\-q"
   88: Does not display messages, except error messages\&.
   89: .IP "\-r"
   90: Raw output: only the MAC/IP address is displayed for each reply\&.
   91: .IP "\-R"
   92: Raw output: Like \-r but shows \(dq\&the other one\(dq\&, can be combined with
   93: \-r\&.
   94: .IP "\-s \fIMAC\fP"
   95: Set source MAC address\&. You may need to use \-p with this\&.
   96: .IP "\-S \fIIP\fP"
   97: Like \-b and \-0 but with set source address\&.
   98: Note that this may get the arping unanswered if the target does not have
   99: routing to the IP\&. If you don\(cq\&t own the IP you are using, you may need to turn
  100: on promiscious mode on the interface (with \-p)\&. With this switch you can find
  101: out what IP\-address a host has without taking an IP\-address yourself\&.
  102: .IP "\-t \fIMAC\fP"
  103: Set target MAC address to use when pinging IP address\&.
  104: .IP "\-T \fIIP\fP"
  105: Use \-T as target address when pinging MACs that won\(cq\&t
  106: respond to a broadcast ping but perhaps to a directed broadcast\&.
  107: .IP 
  108: \fIExample\fP:
  109: .nf
  110: .sp
  111: To check the address of MAC\-A, use knowledge of MAC\-B and IP\-B\&.
  112: .IP 
  113: $ arping \-S <IP\-B> \-s <MAC\-B> \-p <MAC\-A>
  114: .IP "\-u"
  115: Show index=received/sent instead of just index=received when
  116: pinging MACs\&.
  117: .IP "\-U"
  118: Send unsolicited ARP\&. This sets the destination MAC address in
  119: the ARP frame to the broadcast address\&. Unsolicited ARP is used
  120: to update the neighbours\(cq\& ARP caches\&.
  121: .IP 
  122: \fIExample\fP:
  123: .nf
  124: .sp
  125: $ arping \-i <interface> \-U <interface IP>
  126: .IP "\-v"
  127: Verbose output\&. Use twice for more messages\&.
  128: .IP "\-w \fIusec\fP"
  129: Time to wait between pings, in microseconds\&.
  130: .IP "\-W \fIsec\fP"
  131: Same as \-w, but in floating point seconds\&.
  132: 
  133: .PP 
  134: .SH "EXAMPLES"
  135: .nf
  136: .sp
  137: # \fBarping \-c 3 88\&.1\&.180\&.225\fP
  138: ARPING 88\&.1\&.180\&.225
  139: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=0 time=13\&.910 msec
  140: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=1 time=13\&.935 msec
  141: 60 bytes from 00:11:85:4c:01:01 (88\&.1\&.180\&.225): index=2 time=13\&.944 msec
  142: .PP 
  143: \-\-\- 88\&.1\&.180\&.225 statistics \-\-\-
  144: 3 packets transmitted, 3 packets received,   0% unanswered
  145: .PP 
  146: # \fBarping \-c 3 00:11:85:4c:01:01\fP
  147: ARPING 00:11:85:4c:01:01
  148: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec
  149: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec
  150: 60 bytes from 88\&.1\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec
  151: .PP 
  152: \-\-\- 00:11:85:4c:01:01 statistics \-\-\-
  153: 3 packets transmitted, 3 packets received,   0% unanswered
  154: .PP 
  155: # \fBarping \-C 2 \-c 10 \-r 88\&.1\&.180\&.225\fP
  156: 00:11:85:4c:01:01
  157: 00:11:85:4c:01:01
  158: .PP 
  159: .fi
  160: .in
  161: .PP 
  162: .SH "BUGS"
  163: 
  164: .PP 
  165: You have to use \-B instead of arpinging 255\&.255\&.255\&.255, and \-b
  166: instead of \-S 255\&.255\&.255\&.255\&. This is libnets fault\&.
  167: .PP 
  168: .SH "SEE ALSO"
  169: 
  170: .PP 
  171: \fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP
  172: .PP 
  173: .SH "AUTHOR"
  174: 
  175: .PP 
  176: Arping was written by Thomas Habets <thomas@habets\&.se>\&.
  177: .PP 
  178: http://www\&.habets\&.pp\&.se/synscan/
  179: .PP 
  180: git clone http://github\&.com/ThomasHabets/arping\&.git