xref: /freebsd/usr.sbin/rarpd/rarpd.8 (revision 5129159789cc9d7bc514e4546b88e3427695002d)
1.\" @(#) $FreeBSD$ (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
10.\" this paragraph in its entirety in the documentation or other materials
11.\" provided with the distribution, and (3) all advertising materials mentioning
12.\" features or use of this software display the following acknowledgement:
13.\" ``This product includes software developed by the University of California,
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.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
34services Reverse ARP requests on the Ethernet connected to
35.Ar interface .
36Upon receiving a request,
37.Nm
38maps the target hardware address to an IP address via its name, which
39must be present in both the
40.Xr ethers 5
41and
42.Xr hosts 5
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
48(i.e., the host that
49.Nm
50is running on)
51can "boot" the target; that is, a file or directory matching the glob
52.Pa /tftpboot/\fIipaddr\fP*
53exists, where
54.Em ipaddr
55is the target IP address in hex.
56For example, the IP address 204.216.27.18 will be replied to if any of
57.Pa /tftpboot/CCD81B12 ,
58.Pa /tftpboot/CCD81B12.SUN3 ,
59or
60.Pa /tftpboot/CCD81B12-boot
61exist.
62This requirement can be overridden with the
63.Fl s
64flag (see below).
65
66In normal operation,
67.Nm
68forks a copy of itself and runs in
69the background.  Anomalies and errors are reported via
70.Xr syslog 3 .
71
72.Pp
73The following options are available:
74.Bl -tag -width indent
75.It Fl a
76Listen on all the Ethernets attached to the system.
77If
78.Fl a
79is omitted, an interface must be specified.
80.It Fl f
81Run in the foreground.
82.It Fl s
83Supply a response to any RARP request for which an ethernet to IP address
84mapping exists; do not depend on the existence of
85.Pa /tftpboot/\fIipaddr\fP* .
86.It Fl v
87Enable verbose sysloging.
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
98RFC 903: Finlayson, R.; Mann, T.; Mogul, J.C.; Theimer, M.  Reverse Address
99Resolution Protocol.  1984 June; 4 p.
100.Sh AUTHORS
101.An Craig Leres Aq leres@ee.lbl.gov
102and
103.An Steven McCanne Aq mccanne@ee.lbl.gov .
104Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
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
112can cause a delayed RARP response, so in this situation it is reccommended to
113configure
114.Pa /etc/host.conf
115to read
116.Pa /etc/hosts
117first.
118