kernel - TMPFS - Bug fixing pass - directory hierarchy
[dragonfly.git] / usr.sbin / rarpd / rarpd.8
blob9ea3ab03373897d7e46a067b16e595819f95fa9d
1 .\" Copyright (c) 1990, 1991, 1993 The Regents of the University of
2 .\" California. All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that: (1) source code distributions
6 .\" retain the above copyright notice and this paragraph in its entirety, (2)
7 .\" distributions including binary code include the above copyright notice and
8 .\" this paragraph in its entirety in the documentation or other materials
9 .\" provided with the distribution.  Neither the name of
10 .\" the University nor the names of its contributors may be used to endorse
11 .\" or promote products derived from this software without specific prior
12 .\" written permission.
13 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
14 .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
15 .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
16 .\"
17 .\" $FreeBSD: src/usr.sbin/rarpd/rarpd.8,v 1.22 2005/02/09 18:04:41 ru Exp $
18 .\" $DragonFly: src/usr.sbin/rarpd/rarpd.8,v 1.2 2003/06/17 04:30:02 dillon Exp $
19 .\"
20 .Dd November 16, 2001
21 .Dt RARPD 8
22 .Os
23 .Sh NAME
24 .Nm rarpd
25 .Nd reverse ARP daemon
26 .Sh SYNOPSIS
27 .Nm
28 .Fl a
29 .Op Fl dfsv
30 .Op Fl t Ar directory
31 .Nm
32 .Op Fl dfsv
33 .Op Fl t Ar directory
34 .Ar interface
35 .Sh DESCRIPTION
36 The
37 .Nm
38 utility services Reverse ARP requests on the Ethernet connected to
39 .Ar interface .
40 Upon receiving a request,
41 .Nm
42 maps the target hardware address to an IP address via its name, which
43 must be present in both the
44 .Xr ethers 5
45 and
46 .Xr hosts 5
47 databases.
48 If a host does not exist in both databases, the translation cannot
49 proceed and a reply will not be sent.
50 .Pp
51 By default, a request is honored only if the server
52 (i.e., the host that
53 .Nm
54 is running on)
55 can "boot" the target; that is, a file or directory matching the glob
56 .Pa /tftpboot/\fIipaddr\fP*
57 exists, where
58 .Em ipaddr
59 is the target IP address in hex.
60 For example, the IP address 204.216.27.18 will be replied to if any of
61 .Pa /tftpboot/CCD81B12 ,
62 .Pa /tftpboot/CCD81B12.SUN3 ,
64 .Pa /tftpboot/CCD81B12-boot
65 exist.
66 This requirement can be overridden with the
67 .Fl s
68 flag (see below).
69 .Pp
70 In normal operation,
71 .Nm
72 forks a copy of itself and runs in the background.
73 Anomalies and errors are reported via
74 .Xr syslog 3 .
75 .Pp
76 The following options are available:
77 .Bl -tag -width indent
78 .It Fl a
79 Listen on all the Ethernets attached to the system.
81 .Fl a
82 is omitted, an interface must be specified.
83 .It Fl d
85 .Fl f
86 is also specified,
87 .Nm
88 logs messages to
89 .Em stdout
90 and
91 .Em stderr
92 instead of via
93 .Xr syslog 3 .
94 .It Fl f
95 Run in the foreground.
96 .It Fl s
97 Supply a response to any RARP request for which an ethernet to IP address
98 mapping exists; do not depend on the existence of
99 .Pa /tftpboot/\fIipaddr\fP* .
100 .It Fl t
101 Supply an alternate tftp root directory to
102 .Pa /tftpboot ,
103 similar to the
104 .Fl s
105 option of
106 .Xr tftpd 8 .
107 This permits
109 to selectively respond to RARP requests, but use an alternate directory
110 for IP checking.
111 .It Fl v
112 Enable verbose syslogging.
114 .Sh FILES
115 .Bl -tag -width /etc/ethers -compact
116 .It Pa /etc/ethers
117 .It Pa /etc/hosts
118 .It Pa /tftpboot
120 .Sh SEE ALSO
121 .Xr bpf 4
123 .%A "Finlayson, R."
124 .%A "Mann, T."
125 .%A "Mogul, J.C."
126 .%A "Theimer, M."
127 .%T "RFC 903: Reverse Address Resolution Protocol"
128 .%D "June 1984"
129 .%O "4 p"
131 .Sh AUTHORS
132 .An -nosplit
133 .An Craig Leres Aq leres@ee.lbl.gov
135 .An Steven McCanne Aq mccanne@ee.lbl.gov .
136 Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
137 .Sh BUGS
140 utility can depend on the DNS to resolve the name discovered from
141 .Pa /etc/ethers .
142 If this name is not in the DNS but is in
143 .Pa /etc/hosts ,
144 the DNS lookup can cause a delayed RARP response, so in this situation
145 it is recommended to configure
146 .Xr nsswitch.conf 5
147 to read
148 .Pa /etc/hosts
149 first.