--- embedaddon/arping/doc/arping.yodl 2012/02/21 22:16:27 1.1.1.1 +++ embedaddon/arping/doc/arping.yodl 2021/03/16 23:40:57 1.1.1.4 @@ -3,8 +3,9 @@ manpage(arping)(8)(21th June, 2003)(arping)() manpagename(arping)(sends arp and/or ip pings to a given host) manpagesynopsis() - bf(arping) [-abdDeFhpqrRd0uv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)] \ -[-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(us) ] + bf(arping) [-0aAbBdDeFhpqrRuUv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)] \ +[-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(seconds) ] [ -W em(seconds) ] [ -V em(vlan) ] [ -Q em(priority) ] [ -g em(group) ] \ + bf(arping) --help @@ -15,7 +16,7 @@ manpagedescription() 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. + technical explanation and an FAQ, see the README file. em(Note on timing) @@ -51,18 +52,25 @@ Note that this may get the arping unanswered since it' for a host. dit(-B) Use instead of host if you want to address 255.255.255.255. dit(-c em(count)) Only send em(count) requests. + dit(-C em(count)) Only wait for em(count) replies, regardless of -c and -w. dit(-d) Find duplicate replies. Exit with 1 if there are answers from two different MAC addresses. - dit(-D) Display answers as dots and missing packets as exclamation points. + dit(-D) Display answers as exclamation points and missing packets as dots. Like flood ping on a Cisco. dit(-e) Like -a but beep when there is no reply. dit(-F) Don't try to be smart about the interface name. Even if this switch is not given, -i disables this smartness. + dit(-g em(group)) setgid() to this group instead of the nobody group. dit(-h) Displays a help message and exits. dit(-i em(interface)) Don't guess, use the specified interface. + dit(-m em(type)) Type of timestamp to use for incoming packets. + Use -vv when pinging to list available ones. dit(-p) Turn on promiscious mode on interface, use this if you don't "own" the MAC address you are using. + dit(-P) Send ARP replies instead of requests. Useful with -U. dit(-q) Does not display messages, except error messages. + dit(-Q em(priority)) 802.1p priority to set. Should be used with 802.1Q tag (-V). + Defaults to 0. dit(-r) Raw output: only the MAC/IP address is displayed for each reply. dit(-R) Raw output: Like -r but shows "the other one", can be combined with -r. @@ -76,38 +84,54 @@ out what IP-address a host has without taking an IP-ad dit(-T em(IP)) Use -T as target address when pinging MACs that won't respond to a broadcast ping but perhaps to a directed broadcast. -em(Example): \ +em(Example): +mancommand(.nf) +mancommand(.sp) To check the address of MAC-A, use knowledge of MAC-B and IP-B. $ arping -S -s -p dit(-u) Show index=received/sent instead of just index=received when pinging MACs. + dit(-U) Send unsolicited ARP. This sets the destination MAC address in + the ARP frame to the broadcast address. Unsolicited ARP is used + to update the neighbours' ARP caches. + + em(Example): + mancommand(.nf) + mancommand(.sp) + $ arping -i -U dit(-v) Verbose output. Use twice for more messages. - dit(-w) Time to wait between pings, in microseconds. + dit(-V em(vlan)) VLAN tag to set. Defaults to no VLAN tag. + dit(-w em(sec)) Specify a timeout before ping exits regardless of how many packets have been sent or received. + dit(-W em(sec)) Time to wait between pings. enddit() manpagesection(EXAMPLES) mancommand(.nf) mancommand(.sp) - # bf(arping -c 3 88.123.180.225) - 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 + # bf(arping -c 3 88.1.180.225) + ARPING 88.1.180.225 + 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=0 time=13.910 msec + 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=1 time=13.935 msec + 60 bytes from 00:11:85:4c:01:01 (88.1.180.225): index=2 time=13.944 msec - --- 88.123.180.225 statistics --- + --- 88.1.180.225 statistics --- 3 packets transmitted, 3 packets received, 0% unanswered # bf(arping -c 3 00:11:85:4c:01:01) 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 + 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=0 time=13.367 msec + 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=1 time=13.929 msec + 60 bytes from 88.1.180.225 (00:11:85:4c:01:01): icmp_seq=2 time=13.929 msec --- 00:11:85:4c:01:01 statistics --- 3 packets transmitted, 3 packets received, 0% unanswered + # bf(arping -C 2 -c 10 -r 88.1.180.225) + 00:11:85:4c:01:01 + 00:11:85:4c:01:01 + mancommand(.fi) mancommand(.in) @@ -123,7 +147,7 @@ manpageseealso() manpageauthor() - Arping was written by Thomas Habets . + Arping was written by Thomas Habets . http://www.habets.pp.se/synscan/