Annotation of embedaddon/choparp/choparp.8, revision 1.1.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>