Annotation of embedaddon/arping/doc/arping.8, revision 1.1
1.1 ! misho 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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to arping.8 CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / arping / doc