freebsd-dev/libexec/bootpd/bootptab.5

410 lines
10 KiB
Groff
Raw Normal View History

1994-09-30 05:45:07 +00:00
.\" Copyright (c) 1988, 1989, 1991 Carnegie Mellon University
.\"
1998-02-03 07:30:22 +00:00
.\" $Id$
1994-09-30 05:45:07 +00:00
.\"
1998-02-03 07:30:22 +00:00
.Dd October 31, 1991
.Dt BOOTPTAB 5
.Os "Carnegie Mellon University"
.Sh NAME
.Nm bootptab
.Nd Internet Bootstrap Protocol server database
.Sh DESCRIPTION
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Nm
1994-09-30 05:45:07 +00:00
file is the configuration database file for
1998-02-03 07:30:22 +00:00
.Xr bootpd 8 ,
1994-09-30 05:45:07 +00:00
the Internet Bootstrap Protocol server.
It's format is similar to that of
1998-02-03 07:30:22 +00:00
.Xr termcap 5
1994-09-30 05:45:07 +00:00
in which two-character case-sensitive tag symbols are used to
represent host parameters. These parameter declarations are separated by
colons (:), with a general format of:
1998-02-03 07:30:22 +00:00
.Pp
.Dl "hostname:tg=value. . . :tg=value. . . :tg=value. . . ."
.Pp
1994-09-30 05:45:07 +00:00
where
1998-02-03 07:30:22 +00:00
.Em hostname
1994-09-30 05:45:07 +00:00
is the actual name of a bootp client (or a "dummy entry"), and
1998-02-03 07:30:22 +00:00
.Em tg
1994-09-30 05:45:07 +00:00
is a two-character tag symbol. Dummy entries have an invalid hostname
(one with a "." as the first character) and are used to provide
default values used by other entries via the
1998-02-03 07:30:22 +00:00
.Em tc=.dummy-entry
1994-09-30 05:45:07 +00:00
mechanism. Most tags must be followed by an equals-sign
and a value as above. Some may also appear in a boolean form with no
value (i.e.
1998-02-03 07:30:22 +00:00
.Em :tg: Ns ).
1994-09-30 05:45:07 +00:00
The currently recognized tags are:
1998-02-03 07:30:22 +00:00
.Pp
.Bl -tag -width xxx -compact
.It bf
Bootfile
.It bs
Bootfile size in 512-octet blocks
.It cs
Cookie server address list
.It df
Merit dump file
.It dn
Domain name
.It ds
Domain name server address list
.It ef
Extension file
.It gw
Gateway address list
.It ha
Host hardware address
.It hd
Bootfile home directory
.It hn
Send client's hostname to client
.It ht
Host hardware type (see Assigned Numbers RFC)
.It im
Impress server address list
.It ip
Host IP address
.It lg
Log server address list
.It lp
LPR server address list
.It ns
IEN-116 name server address list
.It nt
NTP (time) Server (RFC 1129)
.It ra
Reply address override
.It rl
Resource location protocol server address list
.It rp
Root path to mount as root
.It sa
TFTP server address client should use
.It sm
Host subnet mask
.It sw
Swap server address
.It tc
Table continuation (points to similar "template" host entry)
.It td
TFTP root directory used by "secure" TFTP servers
.It to
Time offset in seconds from UTC
.It ts
Time server address list
.It vm
Vendor magic cookie selector
.It yd
YP (NIS) domain name
.It ys
YP (NIS) server address
.El
.Pp
1994-09-30 05:45:07 +00:00
There is also a generic tag,
1998-02-03 07:30:22 +00:00
.Pf T Em n ,
1994-09-30 05:45:07 +00:00
where
1998-02-03 07:30:22 +00:00
.Em n
1994-09-30 05:45:07 +00:00
is an RFC1084 vendor field tag number. Thus it is possible to immediately
take advantage of future extensions to RFC1084 without being forced to modify
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
first. Generic data may be represented as either a stream of hexadecimal
1998-02-03 07:30:22 +00:00
numbers or as a quoted string of
.Tn ASCII
characters. The length of the generic
1994-09-30 05:45:07 +00:00
data is automatically determined and inserted into the proper field(s) of the
RFC1084-style bootp reply.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The following tags take a whitespace-separated list of IP addresses:
1998-02-03 07:30:22 +00:00
.Em cs ,
.Em ds ,
.Em gw ,
.Em im ,
.Em lg ,
.Em lp ,
.Em ns ,
.Em nt ,
.Em ra ,
.Em rl ,
1994-09-30 05:45:07 +00:00
and
1998-02-03 07:30:22 +00:00
.Em ts .
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Em ip ,
.Em sa ,
.Em sw ,
.Em sm ,
1994-09-30 05:45:07 +00:00
and
1998-02-03 07:30:22 +00:00
.Em ys
1994-09-30 05:45:07 +00:00
tags each take a single IP address.
All IP addresses are specified in standard Internet "dot" notation
and may use decimal, octal, or hexadecimal numbers
(octal numbers begin with 0, hexadecimal numbers begin with '0x' or '0X').
Any IP addresses may alternatively be specified as a hostname, causing
1998-02-03 07:30:22 +00:00
.Nm bootpd
to lookup the IP address for that host name using
.Xr gethostbyname 3 .
1994-09-30 05:45:07 +00:00
If the
1998-02-03 07:30:22 +00:00
.Em ip
1994-09-30 05:45:07 +00:00
tag is not specified,
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
will determine the IP address using the entry name as the host name.
(Dummy entries use an invalid host name to avoid automatic IP lookup.)
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Em ht
1994-09-30 05:45:07 +00:00
tag specifies the hardware type code as either an unsigned decimal, octal, or
hexadecimal integer or one of the following symbolic names:
1998-02-03 07:30:22 +00:00
.Em ethernet
1994-09-30 05:45:07 +00:00
or
1998-02-03 07:30:22 +00:00
.Em ether
1994-09-30 05:45:07 +00:00
for 10Mb Ethernet,
1998-02-03 07:30:22 +00:00
.Em ethernet3
1994-09-30 05:45:07 +00:00
or
1998-02-03 07:30:22 +00:00
.Em ether3
1994-09-30 05:45:07 +00:00
for 3Mb experimental Ethernet,
1998-02-03 07:30:22 +00:00
.Em ieee802 ,
.Em tr ,
1994-09-30 05:45:07 +00:00
or
1998-02-03 07:30:22 +00:00
.Em token-ring
1994-09-30 05:45:07 +00:00
for IEEE 802 networks,
1998-02-03 07:30:22 +00:00
.Em pronet
1994-09-30 05:45:07 +00:00
for Proteon ProNET Token Ring, or
1998-02-03 07:30:22 +00:00
.Em chaos ,
.Em arcnet ,
1994-09-30 05:45:07 +00:00
or
1998-02-03 07:30:22 +00:00
.Em ax.25
1994-09-30 05:45:07 +00:00
for Chaos, ARCNET, and AX.25 Amateur Radio networks, respectively.
The
1998-02-03 07:30:22 +00:00
.Em ha
1994-09-30 05:45:07 +00:00
tag takes a hardware address which may be specified as a host name
or in numeric form. Note that the numeric form
1998-02-03 07:30:22 +00:00
.Em must
1994-09-30 05:45:07 +00:00
be specified in hexadecimal; optional periods and/or a leading '0x' may be
included for readability. The
1998-02-03 07:30:22 +00:00
.Em ha
1994-09-30 05:45:07 +00:00
tag must be preceded by the
1998-02-03 07:30:22 +00:00
.Em ht
1994-09-30 05:45:07 +00:00
tag (either explicitly or implicitly; see
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
below).
If the hardware address is not specified and the type is specified
as either "ethernet" or "ieee802", then
1998-02-03 07:30:22 +00:00
.Nm bootpd
will try to determine the hardware address using
.Xr ether_hostton 3 .
.Pp
The hostname, home directory, and bootfile are
.Tn ASCII
strings which may be
1994-09-30 05:45:07 +00:00
optionally surrounded by double quotes ("). The client's request and the
values of the
1998-02-03 07:30:22 +00:00
.Em hd
1994-09-30 05:45:07 +00:00
and
1998-02-03 07:30:22 +00:00
.Em bf
1994-09-30 05:45:07 +00:00
symbols determine how the server fills in the bootfile field of the bootp
reply packet.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
If the client provides a file name it is left as is.
Otherwise, if the
1998-02-03 07:30:22 +00:00
.Em bf
1994-09-30 05:45:07 +00:00
option is specified its value is copied into the reply packet.
If the
1998-02-03 07:30:22 +00:00
.Em hd
1994-09-30 05:45:07 +00:00
option is specified as well, its value is prepended to the
boot file copied into the reply packet.
The existence of the boot file is checked only if the
1998-02-03 07:30:22 +00:00
.Em bs Ns =auto
1994-09-30 05:45:07 +00:00
option is used (to determine the boot file size).
A reply may be sent whether or not the boot file exists.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
Some newer versions of
1998-02-03 07:30:22 +00:00
.Xr tftpd 8
1994-09-30 05:45:07 +00:00
provide a security feature to change their root directory using
the
1998-02-03 07:30:22 +00:00
.Xr chroot 2
1994-09-30 05:45:07 +00:00
system call.
The
1998-02-03 07:30:22 +00:00
.Em td
1994-09-30 05:45:07 +00:00
tag may be used to inform
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
of this special root directory used by
1998-02-03 07:30:22 +00:00
.Nm tftpd .
1994-09-30 05:45:07 +00:00
(One may alternatively use the
1998-02-03 07:30:22 +00:00
.Nm bootpd
.Fl c Ar chdir
option.)
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Em hd
1994-09-30 05:45:07 +00:00
tag is actually relative to the root directory specified by the
1998-02-03 07:30:22 +00:00
.Em td
1994-09-30 05:45:07 +00:00
tag.
For example, if the real absolute path to your BOOTP client bootfile is
1998-02-03 07:30:22 +00:00
.Pa /tftpboot/bootfiles/bootimage ,
and
.Nm tftpd
uses
.Pa /tftpboot
as its "secure" directory, then specify the following in
.Pa bootptab :
.Pp
.Dl :td=/tftpboot:hd=/bootfiles:bf=bootimage:
.Pp
If your bootfiles are located directly in
.Pa /tftpboot ,
use:
.Pp
.Dl :td=/tftpboot:hd=/:bf=bootimage:
.Pp
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Em sa
1994-09-30 05:45:07 +00:00
tag may be used to specify the IP address of the particular TFTP server
you wish the client to use. In the absence of this tag,
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
will tell the client to perform TFTP to the same machine
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
is running on.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The time offset
1998-02-03 07:30:22 +00:00
.Em to
1994-09-30 05:45:07 +00:00
may be either a signed decimal integer specifying the client's
time zone offset in seconds from UTC, or the keyword
1998-02-03 07:30:22 +00:00
.Em auto
1994-09-30 05:45:07 +00:00
which uses the server's time zone offset. Specifying the
1998-02-03 07:30:22 +00:00
.Em to
1994-09-30 05:45:07 +00:00
symbol as a boolean has the same effect as specifying
1998-02-03 07:30:22 +00:00
.Em auto
1994-09-30 05:45:07 +00:00
as its value.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The bootfile size
1998-02-03 07:30:22 +00:00
.Em bs
1994-09-30 05:45:07 +00:00
may be either a decimal, octal, or hexadecimal integer specifying the size of
the bootfile in 512-octet blocks, or the keyword
1998-02-03 07:30:22 +00:00
.Em auto
1994-09-30 05:45:07 +00:00
which causes the server to automatically calculate the bootfile size at each
request. As with the time offset, specifying the
1998-02-03 07:30:22 +00:00
.Em bs
1994-09-30 05:45:07 +00:00
symbol as a boolean has the same effect as specifying
1998-02-03 07:30:22 +00:00
.Em auto
1994-09-30 05:45:07 +00:00
as its value.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The vendor magic cookie selector (the
1998-02-03 07:30:22 +00:00
.Em vm
1994-09-30 05:45:07 +00:00
tag) may take one of the following keywords:
1998-02-03 07:30:22 +00:00
.Em auto
1994-09-30 05:45:07 +00:00
(indicating that vendor information is determined by the client's request),
1998-02-03 07:30:22 +00:00
.Em rfc1048
1994-09-30 05:45:07 +00:00
or
1998-02-03 07:30:22 +00:00
.Em rfc1084
1994-09-30 05:45:07 +00:00
(which always forces an RFC1084-style reply), or
1998-02-03 07:30:22 +00:00
.Em cmu
1994-09-30 05:45:07 +00:00
(which always forces a CMU-style reply).
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
The
1998-02-03 07:30:22 +00:00
.Em hn
1994-09-30 05:45:07 +00:00
tag is strictly a boolean tag; it does not take the usual equals-sign and
value. It's presence indicates that the hostname should be sent to RFC1084
clients.
1998-02-03 07:30:22 +00:00
.Nm Bootpd
1994-09-30 05:45:07 +00:00
attempts to send the entire hostname as it is specified in the configuration
file; if this will not fit into the reply packet, the name is shortened to
just the host field (up to the first period, if present) and then tried.
In no case is an arbitrarily-truncated hostname sent (if nothing reasonable
will fit, nothing is sent).
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
Often, many host entries share common values for certain tags (such as name
servers, etc.). Rather than repeatedly specifying these tags, a full
specification can be listed for one host entry and shared by others via the
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
(table continuation) mechanism.
Often, the template entry is a dummy host which doesn't actually exist and
never sends bootp requests. This feature is similar to the
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
feature of
1998-02-03 07:30:22 +00:00
.Xr termcap 5
1994-09-30 05:45:07 +00:00
for similar terminals. Note that
1998-02-03 07:30:22 +00:00
.Nm bootpd
1994-09-30 05:45:07 +00:00
allows the
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
tag symbol to appear anywhere in the host entry, unlike
1998-02-03 07:30:22 +00:00
.Pa termcap
1994-09-30 05:45:07 +00:00
which requires it to be the last tag. Information explicitly specified for a
host always overrides information implied by a
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
tag symbol, regardless of its location within the entry. The
value of the
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
tag may be the hostname or IP address of any host entry
previously listed in the configuration file.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
Sometimes it is necessary to delete a specific tag after it has been inferred
via
1998-02-03 07:30:22 +00:00
.Em tc .
1994-09-30 05:45:07 +00:00
This can be done using the construction
1998-02-03 07:30:22 +00:00
.Em tag Ns @
1994-09-30 05:45:07 +00:00
which removes the effect of
1998-02-03 07:30:22 +00:00
.Em tag
1994-09-30 05:45:07 +00:00
as in
1998-02-03 07:30:22 +00:00
.Xr termcap 5 .
1994-09-30 05:45:07 +00:00
For example, to completely undo an IEN-116 name server specification, use
1998-02-03 07:30:22 +00:00
.Em :ns@:
at an appropriate place in the configuration entry. After removal
1994-09-30 05:45:07 +00:00
with
1998-02-03 07:30:22 +00:00
.Em @ ,
1994-09-30 05:45:07 +00:00
a tag is eligible to be set again through the
1998-02-03 07:30:22 +00:00
.Em tc
1994-09-30 05:45:07 +00:00
mechanism.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
Blank lines and lines beginning with "#" are ignored in the configuration
file. Host entries are separated from one another by newlines; a single host
entry may be extended over multiple lines if the lines end with a backslash
(\\). It is also acceptable for lines to be longer than 80 characters. Tags
may appear in any order, with the following exceptions: the hostname must be
the very first field in an entry, and the hardware type must precede the
hardware address.
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
An example
1998-02-03 07:30:22 +00:00
.Pa /etc/bootptab
1994-09-30 05:45:07 +00:00
file follows:
1998-02-03 07:30:22 +00:00
.Pp
1994-09-30 05:45:07 +00:00
.nf
# Sample bootptab file (domain=andrew.cmu.edu)
.default:\\
:hd=/usr/boot:bf=null:\\
:ds=netserver, lancaster:\\
:ns=pcs2, pcs1:\\
:ts=pcs2, pcs1:\\
:sm=255.255.255.0:\\
:gw=gw.cs.cmu.edu:\\
:hn:to=-18000:
carnegie:ht=6:ha=7FF8100000AF:tc=.default:
baldwin:ht=1:ha=0800200159C3:tc=.default:
wylie:ht=1:ha=00DD00CADF00:tc=.default:
arnold:ht=1:ha=0800200102AD:tc=.default:
bairdford:ht=1:ha=08002B02A2F9:tc=.default:
bakerstown:ht=1:ha=08002B0287C8:tc=.default:
# Special domain name server and option tags for next host
butlerjct:ha=08002001560D:ds=128.2.13.42:\\
:T37=0x12345927AD3BCF:\\
:T99="Special ASCII string":\\
:tc=.default:
gastonville:ht=6:ha=7FFF81000A47:tc=.default:
hahntown:ht=6:ha=7FFF81000434:tc=.default:
hickman:ht=6:ha=7FFF810001BA:tc=.default:
lowber:ht=1:ha=00DD00CAF000:tc=.default:
mtoliver:ht=1:ha=00DD00FE1600:tc=.default:
.fi
1998-02-03 07:30:22 +00:00
.Sh FILES
.Bl -tag -width /etc/bootptab -compact
.It /etc/bootptab
.El
.Sh "SEE ALSO"
.Xr bootpd 8 ,
.Xr tftpd 8
.Pp
1994-09-30 05:45:07 +00:00
DARPA Internet Request For Comments RFC951, RFC1048, RFC1084, Assigned Numbers