summaryrefslogtreecommitdiff
path: root/usr.sbin/bootpd/bootpd.8
blob: ede101a1057f70b0efea10ec665a25ece7ffdd6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
.\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University
.\"
.\"	$Header: /cvs/OpenBSD/src/usr.sbin/bootpd/Attic/bootpd.8,v 1.10 2003/04/14 06:51:48 jmc Exp $
.\"
.TH BOOTPD 8 "November 06, 1993" "Carnegie Mellon University"
.SH NAME
bootpd, bootpgw \- Internet Boot Protocol server/gateway
.SH SYNOPSIS
.B bootpd
[
.B \-i
.B \-s
.B \-t
timeout
.B \-d
level
.B \-c
chdir\-path
]
[
.I bootptab
[
.I dumpfile
] ]
.br
.B bootpgw
[
.B \-i
.B \-s
.B \-t
timeout
.B \-d
level
] server
.SH DESCRIPTION
.I Bootpd
implements an Internet Bootstrap Protocol (BOOTP) server as defined in
RFC951, RFC1532, and RFC1533.
.I Bootpgw
implements a simple BOOTP gateway which can be used to forward
requests and responses between clients on one subnet and a
BOOTP server (i.e.,
.IR bootpd )
on another subnet. While either
.I bootpd
or
.I bootpgw
will forward BOOTREPLY packets, only
.I bootpgw
will forward BOOTREQUEST packets.
.PP
One host on each network segment is normally configured to run either
.I bootpd
or
.I bootpgw
from
.I inetd
by including one of the following lines in the file
.IR /etc/inetd.conf :
.IP
bootps dgram udp wait root /usr/sbin/bootpd bootpd bootptab
.br
bootps dgram udp wait root /usr/sbin/bootpgw bootpgw server
.PP
This mode of operation is referred to as "inetd mode" and causes
.I bootpd
(or
.IR bootpgw )
to be started only when a boot request arrives.  If it does not
receive another packet within fifteen minutes of the last one
it received, it will exit to conserve system resources.  The
.B \-t
option controls this timeout (see OPTIONS).
.PP
It is also possible to run
.I bootpd
(or
.IR bootpgw )
in "stand-alone mode" (without
.IR inetd )
by simply invoking it from a shell like any other regular command.
Stand-alone mode is particularly useful when
.I bootpd
is used with a large configuration database, where the start up
delay might otherwise prevent timely response to client requests.
(Automatic start up in stand-alone mode can be done by invoking
.I bootpd
from within
.IR /etc/rc.local ,
for example.)
Stand-alone mode is less useful for
.I bootpgw
which
has very little start up delay because
it does not read a configuration file.
.PP
Either program automatically detects whether it was invoked from inetd
or from a shell and automatically selects the appropriate mode.
The
.B \-s
or
.B \-i
option may be used to force stand-alone or inetd mode respectively
(see OPTIONS).
.SH OPTIONS
.TP
.BI \-t \ timeout
Specifies the
.I timeout
value (in minutes) that a
.I bootpd
or
.I bootpgw
process will wait for a BOOTP packet before exiting.
If no packets are received for
.I timeout
minutes, then the program will exit.
A timeout value of zero means "run forever".
In stand-alone mode, this option is forced to zero.
.TP
.BI \-d \ debug\-level
Sets the
.I debug\-level
variable that controls the amount of debugging messages generated.
For example, -d4 or -d 4 will set the debugging level to 4.
For compatibility with older versions of
.IR bootpd ,
omitting the numeric parameter (i.e., just -d) will
simply increment the debug level by one.
.TP
.BI \-c \ chdir\-path
Sets the current directory used by
.I bootpd
while checking the existence and size of client boot files.  This is
useful when client boot files are specified as relative pathnames, and
.I bootpd
needs to use the same current directory as the TFTP server
(typically /tftpboot).  This option is not recognized by
.IR bootpgw .
.TP
.B \-i
Force inetd mode.  This option is obsolete, but remains for
compatibility with older versions of
.IR bootpd .
.TP
.B \-s
Force stand-alone mode.  This option is obsolete, but remains for
compatibility with older versions of
.IR bootpd .
.TP
.I bootptab
Specifies the name of the configuration file from which
.I bootpd
loads its database of known clients and client options
.RI ( bootpd
only).
.TP
.I dumpfile
Specifies the name of the file that
.I bootpd
will dump its internal database into when it receives a
SIGUSR1 signal
.RI ( bootpd
only).  This option is only recognized if
.I bootpd
was compiled with the -DDEBUG flag.
.TP
.I server
Specifies the name of a BOOTP server to which
.I bootpgw
will forward all BOOTREQUEST packets it receives
.RI ( bootpgw
only).
.SH OPERATION
.PP
Both
.I bootpd
and
.I bootpgw
operate similarly in that both listen for any packets sent to the
.I bootps
port, and both simply forward any BOOTREPLY packets.
They differ in their handling of BOOTREQUEST packets.
.PP
When
.I bootpgw
is started, it determines the address of a BOOTP server
whose name is provided as a command line parameter.  When
.I bootpgw
receives a BOOTREQUEST packet, it sets the "gateway address"
and "hop count" fields in the packet and forwards the packet
to the BOOTP server at the address determined earlier.
Requests are forwarded only if they indicate that
the client has been waiting for at least three seconds.
.PP
When
.I bootpd
is started it reads a configuration file, (normally
.IR /etc/bootptab )
that initializes the internal database of known clients and client
options.  This internal database is reloaded
from the configuration file when
.I bootpd
receives a hangup signal (SIGHUP) or when it discovers that the
configuration file has changed.
.PP
When
.I bootpd
receives a BOOTREQUEST packet, it
.\" checks the modification time of the
.\" configuration file and reloads the database if necessary.  Then it
looks for a database entry matching the client request.
If the client is known,
.I bootpd
composes a BOOTREPLY packet using the database entry found above,
and sends the reply to the client (possibly using a gateway).
If the client is unknown, the request is discarded
(with a notice if debug > 0).
.PP
If
.I bootpd
is compiled with the -DDEBUG option, receipt of a SIGUSR1 signal causes
it to dump its internal database to the file
.I /var/run/bootpd.dump
or the dumpfile specified as a command line parameter.
.PP
During initialization, both programs
determine the UDP port numbers to be used by calling
.I getservbyname
(which normally uses
.IR /etc/services).
Two service names (and port numbers) are used:
.IP
bootps \- BOOTP Server listening port
.br
bootpc \- BOOTP Client destination port
.LP
If the port numbers cannot
be determined using
.I getservbyname
then the values default to boopts=67 and bootpc=68.
.SH FILES
.TP 20
/etc/bootptab
Database file read by
.IR bootpd .
.TP
/var/run/bootpd.dump
Debugging dump file created by
.IR bootpd .
.TP
/etc/services
Internet service numbers.
.TP
/tftpboot
Current directory typically used by the TFTP server and
.IR bootpd .

.SH BUGS
Individual host entries must not exceed 1024 characters.

.SH CREDITS
.PP
This distribution is currently maintained by
Walter L. Wimer <walt+@cmu.edu>.
.PP
The original BOOTP server was created by
Bill Croft at Stanford University in January 1986.
.PP
The current version of
.I bootpd
is primarily the work of David Kovar,
Drew D. Perkins, and Walter L. Wimer,
at Carnegie Mellon University.
.TP
Enhancements and bug\-fixes have been contributed by:
(in alphabetical order)
.br
Danny Backx <db@sunbim.be>
.br
John Brezak <brezak@ch.hp.com>
.br
Frank da Cruz <fdc@cc.columbia.edu>
.br
David R. Linn <drl@vuse.vanderbilt.edu>
.br
Jim McKim <mckim@lerc.nasa.gov>
.br
Gordon W. Ross <gwr@mc.com>
.br
Jason Zions <jazz@hal.com>
.SH "SEE ALSO"
.LP
bootptab(5), inetd(8), tftpd(8)
.LP
DARPA Internet Request For Comments:
.TP 10
RFC951
Bootstrap Protocol
.TP 10
RFC1532
Clarifications and Extensions for the Bootstrap Protocol
.TP 10
RFC1533
DHCP Options and BOOTP Vendor Extensions