Annotation of embedaddon/choparp/choparp.8, revision 1.1
1.1 ! misho 1: .\" Copyright (c) 1997 by Takamichi Tateoka. All rights reserved.
! 2: .\"
! 3: .\" Redistribution and use in source and binary forms, with or without
! 4: .\" modification, are permitted provided that the following conditions
! 5: .\" are met:
! 6: .\" 1. Redistributions of source code must retain the above copyright
! 7: .\" notice, this list of conditions and the following disclaimer.
! 8: .\" 2. Redistributions in binary form must reproduce the above copyright
! 9: .\" notice, this list of conditions and the following disclaimer in the
! 10: .\" documentation and/or other materials provided with the distribution.
! 11: .\" 3. All advertising materials mentioning features or use of this software
! 12: .\" must display the following acknowledgement:
! 13: .\" This product includes software developed by Takamichi Tateoka.
! 14: .\" 4. Neither the name of the author may be used to endorse or promote
! 15: .\" products derived from this software without specific prior
! 16: .\" written permission.
! 17: .\"
! 18: .\" THIS SOFTWARE IS PROVIDED BY TAKAMICHI TATEOKA ``AS IS'' AND
! 19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 21: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 28: .\" SUCH DAMAGE.
! 29: .\"
! 30: .Dd October 11, 2002
! 31: .Dt CHOPARP 8
! 32: .Os
! 33: .Sh NAME
! 34: .Nm choparp
! 35: .Nd cheap and omitted proxy ARP
! 36: .Sh SYNOPSIS
! 37: .Nm chpoarp
! 38: .Ar if_name mac_addr
! 39: .Oo Fl Oc Ns Ar net_addr Ns
! 40: .Op / Ns Ar net_mask
! 41: .Ar ...
! 42: .Sh DESCRIPTION
! 43: .Pp
! 44: .Nm choparp
! 45: is a easy-to-use proxy ARP daemon.
! 46: It watches ARP request packets visible on the interface specified by argument
! 47: .Ar if_name ,
! 48: and sends proxy ARP reply to the sender if the ARP request queries the
! 49: MAC address
! 50: .Pq ethernet hardware address
! 51: for the network specified by
! 52: .Ar net_addr Ns / Ar net_mask .
! 53: .Pp
! 54: .Ar mac_addr
! 55: is th MAC address to be published for the specified hosts.
! 56: It is normally the address of
! 57: .Ar if_name .
! 58: The format of
! 59: .Ar mac_addr
! 60: must be 6 colon-separated bytes of hexadecimal value, such as
! 61: .Ad 00:00:01:01:14:46 .
! 62: The keyword
! 63: .Ad auto
! 64: can also be used to use the address of
! 65: .Ar if_name
! 66: from the system configuration
! 67: .Pp
! 68: .Ar net_addr
! 69: must be in dotted quad notation
! 70: .Pq for example Ad 133.138.1.134
! 71: or be a 32 bit hexadecimal value starting with
! 72: .Dq 0x
! 73: .Pq for example Ad 0x858a0186 .
! 74: .Ar net_mask
! 75: can likewise be speficied as a dotted quad or hexadecimal value,
! 76: or alternatively as a mask length. The following address specifications
! 77: are therefore equivalent:
! 78: .Bl -item -offset indent
! 79: .It
! 80: .Ad 192.168.98.0/255.255.254.0
! 81: .It
! 82: .Ad 192.168.98.0/0xfffffe00
! 83: .It
! 84: .Ad 192.168.98.0/23
! 85: .El
! 86: .Pp
! 87: Multiple addresses can be specified.
! 88: Addresses can be
! 89: .Em excluded
! 90: by preceding them with
! 91: .Fl
! 92: .Sh EXAMPLES
! 93: If you have network interface
! 94: .Dq ne0
! 95: with MAC address
! 96: .Dq 00:00:01:01:14:16 ,
! 97: and would like to send proxy ARP reply for 192.168.0.64/26,
! 98: the argument would be as follows:
! 99: .Bd -literal -offset indent
! 100: choparp ne0 00:00:01:01:14:46 192.168.0.64/255.255.255.192
! 101: .Ed
! 102: .Sh BUGS
! 103: Supports Ethernet interfaces only.
! 104: Handles single interface at a time.
! 105: .Pq you can start multiple Nm choparp No for multiple interfaces, though .
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>