|Specify the timeout value (in minutes) that a bootpd or bootpgw process will wait for a BOOTP packet before exiting. If no packets are received for timeout minutes, then the program will exit. A timeout value of zero means "run forever". In standalone mode, this option is forced to zero.|
|Set the debug-level variable that controls the amount of debugging messages generated. For example, -d-4 or -d 4 will set the debugging level to 4. For compatibility with older versions of bootpd, omitting the numeric parameter (i.e., just -d ) will simply increment the debug level by one.|
|Set the current directory used by bootpd while checking the existence and size of client boot files. This is useful when client boot files are specified as relative pathnames, and bootpd needs to use the same current directory as the TFTP server (typically /tftpboot). This option is not recognized by bootpgw.|
|Specify the hostname corresponding to the IP address to listen on. By default, bootpd listens on the IP address corresponding to the machines hostname, as returned by gethostname(3).|
|-i||Force inetd mode. This option is obsolete, but remains for compatibility with older versions of bootpd.|
|-s||Force standalone mode. This option is obsolete, but remains for compatibility with older versions of bootpd.|
|Specify the name of the configuration file from which bootpd loads its database of known clients and client options (bootpd only).|
|Specify the name of the file that bootpd will dump its internal database into when it receives a SIGUSR1 signal (bootpd only). This option is only recognized if bootpd was compiled with the -DDEBUG flag.|
|Specify the name of a BOOTP server to which bootpgw will forward all BOOTREQUEST packets it receives ( bootpgw only).|
Both bootpd and bootpgw operate similarly in that both listen for any packets sent to the bootps port, and both simply forward any BOOTREPLY packets. They differ in their handling of BOOTREQUEST packets.
When bootpgw is started, it determines the address of a BOOTP server whose name is provided as a command line parameter. When 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.
When bootpd is started it reads a configuration file, (normally /etc/bootptab) that initializes the internal database of known clients and client options. This internal database is reloaded from the configuration file when bootpd receives a hangup signal (SIGHUP) or when it discovers that the configuration file has changed.
When bootpd receives a BOOTREQUEST packet, it looks for a database entry matching the client request. If the client is known, 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).
If bootpd is compiled with the -DDEBUG option, receipt of a SIGUSR1 signal causes it to dump its internal database to the file /tmp/bootpd.dump or the dumpfile specified as a command line parameter.
During initialization, both programs determine the UDP port numbers to be used by calling getservbyname(3) (which normally uses /etc/services). Two service names (and port numbers) are used:
bootps BOOTP Server listening port
bootpc BOOTP Client destination port
If the port numbers cannot be determined using getservbyname(3) then the values default to bootps=67 and bootpc=68.
/etc/bootptab Database file read by bootpd. /tmp/bootpd.dump Debugging dump file created by bootpd. /etc/services Internet service numbers. /tftpboot Current directory typically used by the TFTP server and bootpd.
bootptab(5), inetd(8), tftpd(8)
DARPA Internet Request For Comments:
RFC951 Bootstrap Protocol RFC1532 Clarifications and Extensions for the Bootstrap Protocol RFC1533 DHCP Options and BOOTP Vendor Extensions
This distribution is currently maintained by
.An Walter L. Wimer Aq email@example.com .
The original BOOTP server was created by
.An Bill Croft at Stanford University in January 1986.
The current version of bootpd is primarily the work of
.An David Kovar ,
.An Drew D. Perkins , and
.An Walter L. Wimer , at Carnegie Mellon University.
Enhancements and bug-fixes have been contributed by:
(in alphabetical order)
.An Danny Backx Aq firstname.lastname@example.org
.An John Brezak Aq email@example.com
.An Frank da Cruz Aq firstname.lastname@example.org
.An David R. Linn Aq email@example.com
.An Jim McKim Aq firstname.lastname@example.org
.An Gordon W. Ross Aq email@example.com
.An Jason Zions Aq firstname.lastname@example.org .
Individual host entries must not exceed 1024 characters.