diff options
author | Thomas Habets <thomas@habets.pp.se> | 2009-09-30 13:15:46 +0200 |
---|---|---|
committer | Thomas Habets <thomas@habets.pp.se> | 2009-09-30 13:15:46 +0200 |
commit | 0544518573e291f97c2d6a198ed342b28d2fe9f0 (patch) | |
tree | 559f499fe397b978f472691f21f6a29a7cbc460b | |
parent | d6c90136015a91e22a377e50360b3764ba590722 (diff) | |
download | arping-0544518573e291f97c2d6a198ed342b28d2fe9f0.tar.gz |
More build system fixing
-rw-r--r-- | Makefile.in | 4 | ||||
-rw-r--r-- | doc/arping.8 | 152 | ||||
-rw-r--r-- | src/Makefile.am | 1 | ||||
-rw-r--r-- | src/memcmp.c | 1 |
4 files changed, 155 insertions, 3 deletions
diff --git a/Makefile.in b/Makefile.in index c3de8ad..7ae5cab 100644 --- a/Makefile.in +++ b/Makefile.in @@ -35,8 +35,8 @@ target_triplet = @target@ subdir = . DIST_COMMON = README $(am__configure_deps) $(srcdir)/Makefile.am \ $(srcdir)/Makefile.in $(srcdir)/config.h.in \ - $(top_srcdir)/configure COPYING INSTALL config.guess \ - config.sub depcomp install-sh missing + $(top_srcdir)/configure INSTALL config.guess config.sub \ + depcomp install-sh missing ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ diff --git a/doc/arping.8 b/doc/arping.8 new file mode 100644 index 0000000..72b38a5 --- /dev/null +++ b/doc/arping.8 @@ -0,0 +1,152 @@ +.TH "arping" "8" "21th June, 2003" "arping" "" + +.PP +.SH "NAME" +arping \- sends arp and/or ip pings to a given host +.PP +.SH "SYNOPSIS" +\fBarping\fP [-abdDFhpqrRd0uv] [-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> +.PP +\fBarping\fP --help +.PP +.SH "DESCRIPTION" +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\&. +.PP +One request is sent each second\&. +.PP +When pinging an IP an ARP who-has query is sent\&. When pinging a MAC +address a directed broadcast ICMP Echo request is sent\&. For more +technical explaination and an FAQ, see the README file\&. +.PP +\fINote on timing\fP +.PP +ARP packets are usually replied to (on a LAN) so fast that the OS task +scheduler can\&'t keep up to get exact enough timing\&. +On an idle system the roundtrip times will be pretty much accurate, but +with more load the timing gets less exact\&. +.PP +To get more exact timing on a non-idle system, re-nice arping to -15 or so\&. +.PP +# nice -n -15 arping foobar +.PP +This is not just an issue with arping, it is with normal ping also +(at least it is on my system)\&. But it doesn\&'t show up as much with ping +since arping packets (when pinging IP) doesn\&'t traverse the IP stack when +received and are therefore replied to faster\&. +.PP +.SH "OPTIONS" + +.PP +.IP "--help" +Show extended help\&. Not quite as extensive as this manpage, +but more than -h\&. +.IP "-0" +Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this +when you haven\&'t configured your interface yet\&. +Note that this may get the MAC-ping unanswered\&. +This is an alias for -S 0\&.0\&.0\&.0\&. +.IP "-a" +Audible ping\&. +.IP "-A" +Only count addresses matching requested address (This *WILL* +break most things you do\&. Only useful if you are arpinging many +hosts at once\&. See arping-scan-net\&.sh for an example)\&. +.IP "-b" +Like -0 but source broadcast source address (255\&.255\&.255\&.255)\&. +Note that this may get the arping unanswered since it\&'s not normal behavior +for a host\&. +.IP "-B" +Use instead of host if you want to address 255\&.255\&.255\&.255\&. +.IP "-c \fIcount\fP" +Only send \fIcount\fP requests\&. +.IP "-d" +Find duplicate replies\&. +.IP "-D" +Display answers as dots and missing packets as exclamation points\&. +Like flood ping on a Cisco\&. +.IP "-F" +Don\&'t try to be smart about the interface name\&. Even if this +switch is not given, -i disables this smartness\&. +.IP "-h" +Displays a help message and exits\&. +.IP "-i \fIinterface\fP" +Don\&'t guess, use the specified interface\&. +.IP "-p" +Turn on promiscious mode on interface, use this if you don\&'t +"own" the MAC address you are using\&. +.IP "-q" +Does not display messages, except error messages\&. +.IP "-r" +Raw output: only the MAC/IP address is displayed for each reply\&. +.IP "-R" +Raw output: Like -r but shows "the other one", can be combined with +-r\&. +.IP "-s \fIMAC\fP" +Set source MAC address\&. You may need to use -p with this\&. +.IP "-S \fIIP\fP" +Like -b and -0 but with set source address\&. +Note that this may get the arping unanswered if the target does not have +routing to the IP\&. If you don\&'t own the IP you are using, you may need to turn +on promiscious mode on the interface (with -p)\&. With this switch you can find +out what IP-address a host has without taking an IP-address yourself\&. +.IP "-t \fIMAC\fP" +Set target MAC address to use when pinging IP address\&. +.IP "-T \fIIP\fP" +Use -T as target address when pinging MACs that won\&'t +respond to a broadcast ping but perhaps to a directed broadcast\&. +.IP +\fIExample\fP: To check the address of MAC-A, use knowledge of MAC-B and IP-B\&. +.IP +$ arping -S <IP-B> -s <MAC-B> -p <MAC-A> +.IP "-u" +Show index=received/sent instead of just index=received when +pinging MACs\&. +.IP "-v" +Verbose output\&. Use twice for more messages\&. +.IP "-w" +Time to wait between pings, in microseconds\&. + +.PP +.SH "EXAMPLES" +.nf +.sp +# \fBarping -c 3 88\&.123\&.180\&.225\fP +ARPING 88\&.123\&.180\&.225 +60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=0 time=13\&.910 msec +60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=1 time=13\&.935 msec +60 bytes from 00:11:85:4c:01:01 (88\&.123\&.180\&.225): index=2 time=13\&.944 msec +.PP +--- 88\&.123\&.180\&.225 statistics --- +3 packets transmitted, 3 packets received, 0% unanswered +.PP +# \fBarping -c 3 00:11:85:4c:01:01\fP +ARPING 00:11:85:4c:01:01 +60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=0 time=13\&.367 msec +60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=1 time=13\&.929 msec +60 bytes from 88\&.123\&.180\&.225 (00:11:85:4c:01:01): icmp_seq=2 time=13\&.929 msec +.PP +--- 00:11:85:4c:01:01 statistics --- +3 packets transmitted, 3 packets received, 0% unanswered +.PP +.fi +.in +.PP +.SH "BUGS" + +.PP +You have to use -B instead of arpinging 255\&.255\&.255\&.255, and -b +instead of -S 255\&.255\&.255\&.255\&. This is libnets fault\&. +.PP +.SH "SEE ALSO" + +.PP +\fBping(8)\fP, \fBarp(8)\fP, \fBrarp(8)\fP +.PP +.SH "AUTHOR" + +.PP +Arping was written by Thomas Habets <thomas@habets\&.pp\&.se>\&. +.PP +http://www\&.habets\&.pp\&.se/synscan/ +.PP +git clone http://github\&.com/ThomasHabets/arping\&.git diff --git a/src/Makefile.am b/src/Makefile.am index bb68a9a..2f71ae4 100644 --- a/src/Makefile.am +++ b/src/Makefile.am @@ -6,4 +6,3 @@ sbin_PROGRAMS = arping arping_SOURCES = arping.c arping_LDADD = $(LIBOBJS) - diff --git a/src/memcmp.c b/src/memcmp.c new file mode 100644 index 0000000..77ab5e3 --- /dev/null +++ b/src/memcmp.c @@ -0,0 +1 @@ +#error "Your system doesn't seem to have memcmp(), that's very odd" |