Return to choparp.8 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / choparp

Annotation of embedaddon/choparp/choparp.8, revision 1.1.1.1.2.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
1.1.1.1.2.1! misho      37: .Nm choparp
        !            38: .Op Fl v
1.1       misho      39: .Ar if_name mac_addr
                     40: .Oo Fl Oc Ns Ar net_addr Ns
                     41: .Op / Ns Ar net_mask
                     42: .Ar ...
                     43: .Sh DESCRIPTION
                     44: .Pp
                     45: .Nm choparp 
1.1.1.1.2.1! misho      46: is an easy-to-use proxy ARP daemon.
1.1       misho      47: It watches ARP request packets visible on the interface specified by argument
                     48: .Ar if_name ,
                     49: and sends proxy ARP reply to the sender if the ARP request queries the
                     50: MAC address
                     51: .Pq ethernet hardware address
                     52: for the network specified by
                     53: .Ar net_addr Ns / Ar net_mask .
                     54: .Pp
                     55: .Ar mac_addr
1.1.1.1.2.1! misho      56: is the MAC address to be published for the specified hosts.
1.1       misho      57: It is normally the address of
                     58: .Ar if_name .
                     59: The format of
                     60: .Ar mac_addr
                     61: must be 6 colon-separated bytes of hexadecimal value, such as
                     62: .Ad 00:00:01:01:14:46 .
                     63: The keyword
                     64: .Ad auto
                     65: can also be used to use the address of
                     66: .Ar if_name
                     67: from the system configuration
                     68: .Pp
                     69: .Ar net_addr
                     70: must be in dotted quad notation
                     71: .Pq for example Ad 133.138.1.134
                     72: or be a 32 bit hexadecimal value starting with
                     73: .Dq 0x
                     74: .Pq for example Ad 0x858a0186 .
                     75: .Ar net_mask
1.1.1.1.2.1! misho      76: can likewise be specified as a dotted quad or hexadecimal value,
1.1       misho      77: or alternatively as a mask length. The following address specifications
                     78: are therefore equivalent:
                     79: .Bl -item -offset indent
                     80: .It
                     81: .Ad 192.168.98.0/255.255.254.0
                     82: .It
                     83: .Ad 192.168.98.0/0xfffffe00
                     84: .It
                     85: .Ad 192.168.98.0/23
                     86: .El
                     87: .Pp
                     88: Multiple addresses can be specified.
                     89: Addresses can be
                     90: .Em excluded
                     91: by preceding them with
                     92: .Fl
1.1.1.1.2.1! misho      93: .Pp
        !            94: .Fl v
        !            95: option enables verbose mode, showing warning for invalid ARP packets.
        !            96: .Pp
        !            97: .Nm choparp
        !            98: uses the Berkeley Packet Filter
        !            99: .Nm bpf(4)
        !           100: and so the kernel must be compiled with support for the
        !           101: .Nm bpf
        !           102: device.
1.1       misho     103: .Sh EXAMPLES
                    104: If you have network interface
                    105: .Dq ne0
                    106: with MAC address
                    107: .Dq 00:00:01:01:14:16 ,
                    108: and would like to send proxy ARP reply for 192.168.0.64/26,
                    109: the argument would be as follows:
                    110: .Bd -literal -offset indent
                    111: choparp ne0 00:00:01:01:14:46 192.168.0.64/255.255.255.192
                    112: .Ed
                    113: .Sh BUGS
                    114: Supports Ethernet interfaces only.
                    115: Handles single interface at a time.
                    116: .Pq you can start multiple Nm choparp No for multiple interfaces, though .