Diff for /embedaddon/arping/doc/arping.yodl between versions 1.1.1.1 and 1.1.1.4

version 1.1.1.1, 2012/02/21 22:16:27 version 1.1.1.4, 2021/03/16 23:40:57
Line 3  manpage(arping)(8)(21th June, 2003)(arping)() Line 3  manpage(arping)(8)(21th June, 2003)(arping)()
 manpagename(arping)(sends arp and/or ip pings to a given host)  manpagename(arping)(sends arp and/or ip pings to a given host)
   
 manpagesynopsis()  manpagesynopsis()
    bf(arping) [-abdDeFhpqrRd0uv] [-S em(host/ip)] [-T em(host/ip)] [-s em(MAC)]    \    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(us) ] <em(host) | -B>[-t em(MAC)] [-c em(count)] [-i em(interface)] [ -w em(seconds) ] [ -W em(seconds) ] [ -V em(vlan) ] [ -Q em(priority) ] [ -g em(group) ] \
 <em(host) | -B>
   
     bf(arping) --help      bf(arping) --help
   
Line 15  manpagedescription() Line 16  manpagedescription()
   
     When pinging an IP an ARP who-has query is sent. When pinging a MAC      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      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)      em(Note on timing)
   
Line 51  Note that this may get the arping unanswered since it' Line 52  Note that this may get the arping unanswered since it'
 for a host.  for a host.
     dit(-B) Use instead of host if you want to address 255.255.255.255.      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 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      dit(-d) Find duplicate replies. Exit with 1 if there are answers from
         two different MAC addresses.          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.          Like flood ping on a Cisco.
     dit(-e) Like -a but beep when there is no reply.      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      dit(-F) Don't try to be smart about the interface name. Even if this
 switch is not given, -i disables this smartness.  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(-h) Displays a help message and exits.
     dit(-i em(interface)) Don't guess, use the specified interface.      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      dit(-p) Turn on promiscious mode on interface, use this if you don't
             "own" the MAC address you are using.              "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) 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: 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      dit(-R) Raw output: Like -r but shows "the other one", can be combined with
 -r.  -r.
Line 76  out what IP-address a host has without taking an IP-ad Line 84  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      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.  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.          To check the address of MAC-A, use knowledge of MAC-B and IP-B.
   
         $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>          $ arping -S <IP-B> -s <MAC-B> -p <MAC-A>
     dit(-u) Show index=received/sent instead of just index=received when      dit(-u) Show index=received/sent instead of just index=received when
         pinging MACs.          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 <interface> -U <interface IP>
     dit(-v) Verbose output. Use twice for more messages.      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()  enddit()
   
   
 manpagesection(EXAMPLES)  manpagesection(EXAMPLES)
 mancommand(.nf)  mancommand(.nf)
 mancommand(.sp)  mancommand(.sp)
  # bf(arping -c 3 88.123.180.225)  # bf(arping -c 3 88.1.180.225)
  ARPING 88.123.180.225  ARPING 88.1.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.1.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.1.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  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    3 packets transmitted, 3 packets received,   0% unanswered
   
   # bf(arping -c 3 00:11:85:4c:01:01)    # bf(arping -c 3 00:11:85:4c:01:01)
   ARPING 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.1.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.1.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=2 time=13.929 msec
   
   --- 00:11:85:4c:01:01 statistics ---    --- 00:11:85:4c:01:01 statistics ---
   3 packets transmitted, 3 packets received,   0% unanswered    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(.fi)
 mancommand(.in)  mancommand(.in)
   
Line 123  manpageseealso() Line 147  manpageseealso()
   
 manpageauthor()  manpageauthor()
   
    Arping was written by Thomas Habets <thomas@habets.pp.se>.    Arping was written by Thomas Habets <thomas@habets.se>.
   
     http://www.habets.pp.se/synscan/      http://www.habets.pp.se/synscan/
   

Removed from v.1.1.1.1  
changed lines
  Added in v.1.1.1.4


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>