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>