rarpd.8 (a9695b96ac309ad494cedcf3dd584eeecb8c4f07) rarpd.8 (aa40a0da51cee66314cbf816546067d5177eed92)
1.\" @(#) $Header: /home/ncvs/src/usr.sbin/rarpd/rarpd.8,v 1.4 1996/11/19 23:57:05 wpaul Exp $ (LBL)
1.\" @(#) $Id$ (LBL)
2.\"
3.\" Copyright (c) 1990, 1991, 1993 The Regents of the University of
4.\" California. All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that: (1) source code distributions
8.\" retain the above copyright notice and this paragraph in its entirety, (2)
9.\" distributions including binary code include the above copyright notice and

--- 4 unchanged lines hidden (view full) ---

14.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
15.\" the University nor the names of its contributors may be used to endorse
16.\" or promote products derived from this software without specific prior
17.\" written permission.
18.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
19.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
20.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
21.\"
2.\"
3.\" Copyright (c) 1990, 1991, 1993 The Regents of the University of
4.\" California. All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that: (1) source code distributions
8.\" retain the above copyright notice and this paragraph in its entirety, (2)
9.\" distributions including binary code include the above copyright notice and

--- 4 unchanged lines hidden (view full) ---

14.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
15.\" the University nor the names of its contributors may be used to endorse
16.\" or promote products derived from this software without specific prior
17.\" written permission.
18.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
19.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
20.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
21.\"
22.TH RARPD 8 "19 Jul 1993"
23.SH NAME
24rarpd \- Reverse ARP Daemon
25.SH SYNOPSIS
26.na
27.B rarpd
28[
29.B \-afsv
30]
31[
32.I interface
33]
34.br
35.ad
36.SH DESCRIPTION
37.LP
38.I Rarpd
22.Dd July 19, 1993
23.Dt RARPD 8
24.Os
25.Sh NAME
26.Nm rarpd
27.Nd reverse ARP daemon
28.Sh SYNOPSIS
29.Nm rarpd
30.Op Fl afsv
31.Op Ar interface
32.Sh DESCRIPTION
33.Nm Rarpd
39services Reverse ARP requests on the Ethernet connected to
34services Reverse ARP requests on the Ethernet connected to
40.I interface.
35.Ar interface .
41Upon receiving a request,
36Upon receiving a request,
42.I rarpd
37.Nm
43maps the target hardware address to an IP address via its name, which
44must be present in both the
38maps the target hardware address to an IP address via its name, which
39must be present in both the
45.I ethers(5)
40.Xr ethers 5
46and
41and
47.I hosts(5)
42.Xr hosts 5
48databases.
49If a host does not exist in both databases, the translation cannot
50proceed and a reply will not be sent.
51
52By default, a request is honored only if the server
43databases.
44If a host does not exist in both databases, the translation cannot
45proceed and a reply will not be sent.
46
47By default, a request is honored only if the server
53(i.e., the host that rarpd is running on)
48(i.e., the host that
49.Nm
50is running on)
54can "boot" the target; that is, a file or directory matching the glob
51can "boot" the target; that is, a file or directory matching the glob
55/tftpboot/\fIipaddr\fP*
56exists, where \fIipaddr\fP is the target IP address in hex.
52.Pa /tftpboot/\fIipaddr\fP*
53exists, where
54.Em ipaddr
55is the target IP address in hex.
57For example, the IP address 204.216.27.18 will be replied to if any of
56For example, the IP address 204.216.27.18 will be replied to if any of
58/tftpboot/CCD81B12, /tftpboot/CCD81B12.SUN3, or /tftpboot/CCD81B12-boot
57.Pa /tftpboot/CCD81B12 ,
58.Pa /tftpboot/CCD81B12.SUN3 ,
59or
60.Pa /tftpboot/CCD81B12-boot
59exist.
60This requirement can be overridden with the
61exist.
62This requirement can be overridden with the
61.B \-s
63.Fl s
62flag (see below).
63
64In normal operation,
64flag (see below).
65
66In normal operation,
65.I rarpd
67.Nm
66forks a copy of itself and runs in
67the background. Anomalies and errors are reported via
68forks a copy of itself and runs in
69the background. Anomalies and errors are reported via
68.I syslog(3).
70.Xr syslog 3 .
69
71
70.SH OPTIONS
71.LP
72.TP
73.B \-a
72.Sh OPTIONS
73The following options are available:
74.Bl -tag -width indent
75.It Fl a
74Listen on all the Ethernets attached to the system.
76Listen on all the Ethernets attached to the system.
75If `-a' is omitted, an interface must be specified.
76.TP
77.B \-f
77If
78.Fl a
79is omitted, an interface must be specified.
80.It Fl f
78Run in the foreground.
81Run in the foreground.
79.TP
80.B \-s
82.It Fl s
81Supply a response to any RARP request for which an ethernet to IP address
82mapping exists; do not depend on the existence of
83Supply a response to any RARP request for which an ethernet to IP address
84mapping exists; do not depend on the existence of
83/tftpboot/\fIipaddr\fP*.
84.TP
85.B \-v
85.Pa /tftpboot/\fIipaddr\fP* .
86.It Fl v
86Enable verbose sysloging.
87Enable verbose sysloging.
87
88.SH FILES
89/etc/ethers
90.br
91/etc/hosts
92.br
93/tftpboot
94.SH SEE ALSO
95bpf(4)
96.br
88.El
89.Sh FILES
90.Bl -tag -width /etc/ethers -compact
91.It Pa /etc/ethers
92.It Pa /etc/hosts
93.It Pa /tftpboot
94.El
95.Sh SEE ALSO
96.Xr bpf 4
97.Pp
97RFC 903: Finlayson, R.; Mann, T.; Mogul, J.C.; Theimer, M. Reverse Address
98Resolution Protocol. 1984 June; 4 p.
98RFC 903: Finlayson, R.; Mann, T.; Mogul, J.C.; Theimer, M. Reverse Address
99Resolution Protocol. 1984 June; 4 p.
99.SH AUTHORS
100Craig Leres (leres@ee.lbl.gov) and
101Steven McCanne (mccanne@ee.lbl.gov).
100.Sh AUTHORS
101.An Craig Leres Aq leres@ee.lbl.gov
102and
103.An Steven McCanne Aq mccanne@ee.lbl.gov .
102Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
104Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
103.SH BUGS
104.I rarpd
105can depend on the DNS to resolve the name discovered from /etc/ethers.
106If this name is not in the DNS but is in /etc/hosts, the DNS lookup
105.Sh BUGS
106.Nm Rarpd
107can depend on the DNS to resolve the name discovered from
108.Pa /etc/ethers .
109If this name is not in the DNS but is in
110.Pa /etc/hosts ,
111the DNS lookup
107can cause a delayed RARP response, so in this situation it is reccommended to
112can cause a delayed RARP response, so in this situation it is reccommended to
108configure /etc/host.conf to read /etc/hosts first.
113configure
114.Pa /etc/host.conf
115to read
116.Pa /etc/hosts
117first.