Return to arping.8 CVS log

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

arping

    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 [-abdDeFhpqrRd0uv] [-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\&'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\&'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: .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\&'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\&'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 "-d"
   63: Find duplicate replies\&. Exit with 1 if there are answers from
   64: two different MAC addresses\&.
   65: .IP "-D"
   66: Display answers as dots and missing packets as exclamation points\&.
   67: Like flood ping on a Cisco\&.
   68: .IP "-e"
   69: Like -a but beep when there is no reply\&.
   70: .IP "-F"
   71: Don\&'t try to be smart about the interface name\&. Even if this
   72: switch is not given, -i disables this smartness\&.
   73: .IP "-h"
   74: Displays a help message and exits\&.
   75: .IP "-i \fIinterface\fP"
   76: Don\&'t guess, use the specified interface\&.
   77: .IP "-p"
   78: Turn on promiscious mode on interface, use this if you don\&'t
   79: "own" the MAC address you are using\&.
   80: .IP "-q"
   81: Does not display messages, except error messages\&.
   82: .IP "-r"
   83: Raw output: only the MAC/IP address is displayed for each reply\&.
   84: .IP "-R"
   85: Raw output: Like -r but shows "the other one", can be combined with
   86: -r\&.
   87: .IP "-s \fIMAC\fP"
   88: Set source MAC address\&. You may need to use -p with this\&.
   89: .IP "-S \fIIP\fP"
   90: Like -b and -0 but with set source address\&.
   91: Note that this may get the arping unanswered if the target does not have
   92: routing to the IP\&. If you don\&'t own the IP you are using, you may need to turn
   93: on promiscious mode on the interface (with -p)\&. With this switch you can find
   94: out what IP-address a host has without taking an IP-address yourself\&.
   95: .IP "-t \fIMAC\fP"
   96: Set target MAC address to use when pinging IP address\&.
   97: .IP "-T \fIIP\fP"
   98: Use -T as target address when pinging MACs that won\&'t
   99: respond to a broadcast ping but perhaps to a directed broadcast\&.
  100: .IP 
  101: \fIExample\fP:                                                                To check the address of MAC-A, use knowledge of MAC-B and IP-B\&.
  102: .IP 
  103: $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
  104: .IP "-u"
  105: Show index=received/sent instead of just index=received when
  106: pinging MACs\&.
  107: .IP "-v"
  108: Verbose output\&. Use twice for more messages\&.
  109: .IP "-w"
  110: Time to wait between pings, in microseconds\&.
  111: 
  112: .PP 
  113: .SH "EXAMPLES"
  114: .nf
  115: .sp
  116: # \fBarping -c 3 88\&.123\&.180\&.225\fP
  117: ARPING 88\&.123\&.180\&.225
  118: 60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=0 time=13\&.910 msec
  119: 60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=1 time=13\&.935 msec
  120: 60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=2 time=13\&.944 msec
  121: .PP 
  122: --- 88\&.123\&.180\&.225 statistics ---
  123: 3 packets transmitted, 3 packets received,   0% unanswered
  124: .PP 
  125: # \fBarping -c 3 00:11:85:4c:01:01\fP
  126: ARPING 00:11:85:4c:01:01
  127: 60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec
  128: 60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec
  129: 60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec
  130: .PP 
  131: --- 00:11:85:4c:01:01 statistics ---
  132: 3 packets transmitted, 3 packets received,   0% unanswered
  133: .PP 
  134: .fi
  135: .in
  136: .PP 
  137: .SH "BUGS"
  138: 
  139: .PP 
  140: You have to use -B instead of arpinging 255\&.255\&.255\&.255, and -b
  141: instead of -S 255\&.255\&.255\&.255\&. This is libnets fault\&.
  142: .PP 
  143: .SH "SEE ALSO"
  144: 
  145: .PP 
  146: \fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP
  147: .PP 
  148: .SH "AUTHOR"
  149: 
  150: .PP 
  151: Arping was written by Thomas Habets <thomas@habets\&.pp\&.se>\&.
  152: .PP 
  153: http://www\&.habets\&.pp\&.se/synscan/
  154: .PP 
  155: git clone http://github\&.com/ThomasHabets/arping\&.git