Return to choparp.8 CVS log

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

choparp

    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 .