mir/isc-dhcp
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/dhcp synced 2025-09-04 16:25:21 +00:00
Code Issues Releases Wiki Activity

Update documentation

Browse Source
This commit is contained in:
Ted Lemon
1997-02-22 10:20:28 +00:00
parent 1039f0dbd6
commit 66b01364eb
8 changed files with 634 additions and 440 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
dhcpd.8
View File

@@ -298,7 +298,7 @@ in dhcpd.conf(5).
.B ETCDIR/dhcpd.conf, DBDIR/dhcpd.leases, RUNDIR/dhcpd.pid, .B ETCDIR/dhcpd.conf, DBDIR/dhcpd.leases, RUNDIR/dhcpd.pid,
.B DBDIR/dhcpd.leases~. .B DBDIR/dhcpd.leases~.
.SH SEE ALSO .SH SEE ALSO
dhcpd.conf(5), dhcpd.leases(5) dhclient(8), dhcrelay(8), dhcpd.conf(5), dhcpd.leases(5)
.SH AUTHOR .SH AUTHOR
.B dhcpd(8) .B dhcpd(8)
was written by Ted Lemon <mellon@vix.com> was written by Ted Lemon <mellon@vix.com>

8
dhcpd.cat8
View File

@@ -105,9 +105,9 @@ CCOOMMMMAANNDD LLIINNEE
unable to identify non-broadcast interfaces, but should unable to identify non-broadcast interfaces, but should
not be required on other systems. If no interface names not be required on other systems. If no interface names
are specified on the command line dhcpd will identify all are specified on the command line dhcpd will identify all
network interfaces which are up, elimininating non- network interfaces which are up, elimininating non-broad-
broadcast interfaces if possible, and listen for DHCP cast interfaces if possible, and listen for DHCP broad-
broadcasts on each interface. casts on each interface.
If dhcpd should listen on a port other than the standard If dhcpd should listen on a port other than the standard
(port 67), the --pp flag may used. It should be followed by (port 67), the --pp flag may used. It should be followed by
@@ -301,7 +301,7 @@ FFIILLEESS
//vvaarr//ddbb//ddhhccppdd..lleeaasseess~~.. //vvaarr//ddbb//ddhhccppdd..lleeaasseess~~..
SSEEEE AALLSSOO SSEEEE AALLSSOO
dhcpd.conf(5), dhcpd.leases(5) dhclient(8), dhcrelay(8), dhcpd.conf(5), dhcpd.leases(5)
AAUUTTHHOORR AAUUTTHHOORR
ddhhccppdd((88)) was written by Ted Lemon <mellon@vix.com> under a ddhhccppdd((88)) was written by Ted Lemon <mellon@vix.com> under a

57
dhcpd.conf.5
View File

@@ -443,6 +443,50 @@ be used for all clients that may boot using the BOOTP protocol.
The group statement is used simply to apply one or more parameters to The group statement is used simply to apply one or more parameters to
a group of declarations. It can be used to group hosts, shared a group of declarations. It can be used to group hosts, shared
networks, subnets, or even other groups. networks, subnets, or even other groups.
.SH REFERENCE: ALLOW and DENY
.PP
The
.I allow
and
.I deny
statements can be used to control the behaviour of dhcpd to various
sorts of requests.
.PP
.PP
.B The
.I unknown-clients
.B keyword
.PP
\fBallow unknown-clients;\fR
\fBdeny unknown-clients;\fR
.PP
The \fBunknown-clients\fR flag is used to tell dhcpd whether
or not to dynamically assign addresses to unknown clients. Dynamic
address assignment to unknown clients is \fBallow\fRed by default.
.PP
.B The
.I bootp
.B keyword
.PP
\fBallow bootp;\fR
\fBdeny bootp;\fR
.PP
The \fBunknown-clients\fR flag is used to tell dhcpd whether
or not to respond to bootp queries. Bootp queries are \fBallow\fRed
by default.
.PP
.B The
.I booting
.B keyword
.PP
\fBallow booting;\fR
\fBdeny booting;\fR
.PP
The \fBbooting\fR flag is used to tell dhcpd whether or not to respond
to queries from a particular client. This keyword only has meaning
when it appears in a host declaration. By default, booting is
\fBallow\fRed, but if it is disabled for a particular client, then
that client will not be able to get and address from the DHCP server.
.SH REFERENCE: PARAMETERS .SH REFERENCE: PARAMETERS
.PP .PP
.B The .B The
@@ -591,19 +635,6 @@ Needless to say, this parameter should be adjusted with extreme
caution. caution.
.PP .PP
.B The .B The
.I boot-unknown-clients
.B statement
.PP
\fBboot-unknown-clients\fR \fIflag\fR\fB;\fR
.PP
The \fIboot-unknown-clients\fR statement is used to tell dhcpd whether
or not to dynamically assign addresses to unknown clients. If
\fIflag\fR is true (the default), then addresses are dynamically
assigned to unknown clients when available. If \fIflag\fR is
false, then addresses are provided only to clients which match at
least one host declaration.
.PP
.B The
.I get-lease-hostnames .I get-lease-hostnames
.B statement .B statement
.PP .PP

346
dhcpd.conf.cat5
View File

@@ -14,10 +14,10 @@ DDEESSCCRRIIPPTTIIOONN
The dhcpd.conf file is a free-form ASCII text file. It The dhcpd.conf file is a free-form ASCII text file. It
is parsed by the recursive-descent parser built into is parsed by the recursive-descent parser built into
dhcpd. The file may contain extra tabs and newlines for dhcpd. The file may contain extra tabs and newlines for
formatting purposes. Keywords in the file are case- formatting purposes. Keywords in the file are case-insen-
insensitive. Comments may be placed anywhere within the sitive. Comments may be placed anywhere within the file
file (except within quotes). Comments begin with the # (except within quotes). Comments begin with the # char-
character and end at the end of the line. acter and end at the end of the line.
The file essentially consists of a list of statements. The file essentially consists of a list of statements.
Statements fall into two broad categories - parameters and Statements fall into two broad categories - parameters and
@@ -268,11 +268,11 @@ dhcpd.conf(5) dhcpd.conf(5)
dhcpd.conf(5) dhcpd.conf(5) dhcpd.conf(5) dhcpd.conf(5)
Imagine that you have a site with a lot of NCD X- Imagine that you have a site with a lot of NCD X-Termi-
Terminals. These terminals come in a variety of models, nals. These terminals come in a variety of models, and
and you want to specify the boot files for each models. you want to specify the boot files for each models. One
One way to do this would be to have host declarations for way to do this would be to have host declarations for each
each server and group them by model: server and group them by model:
group { group {
filename "Xncd19r"; filename "Xncd19r";
@@ -363,8 +363,8 @@ dhcpd.conf(5) dhcpd.conf(5)
The _s_u_b_n_e_t statement is used to provide dhcpd with enough The _s_u_b_n_e_t statement is used to provide dhcpd with enough
information to tell whether or not an IP address is on information to tell whether or not an IP address is on
that subnet. It may also be used to provide subnet- that subnet. It may also be used to provide subnet-spe-
specific parameters and to specify what addresses may be cific parameters and to specify what addresses may be
dynamically allocated to clients booting on that subnet. dynamically allocated to clients booting on that subnet.
Such addresses are specified using the _r_a_n_g_e declaration. Such addresses are specified using the _r_a_n_g_e declaration.
@@ -473,6 +473,42 @@ dhcpd.conf(5) dhcpd.conf(5)
group hosts, shared networks, subnets, or even other group hosts, shared networks, subnets, or even other
groups. groups.
RREEFFEERREENNCCEE:: AALLLLOOWW aanndd DDEENNYY
The _a_l_l_o_w and _d_e_n_y statements can be used to control the
behaviour of dhcpd to various sorts of requests.
TThhee _u_n_k_n_o_w_n_-_c_l_i_e_n_t_s kkeeyywwoorrdd
aallllooww uunnkknnoowwnn--cclliieennttss;;
ddeennyy uunnkknnoowwnn--cclliieennttss;;
The uunnkknnoowwnn--cclliieennttss flag is used to tell dhcpd whether or
not to dynamically assign addresses to unknown clients.
Dynamic address assignment to unknown clients is aalllloowwed
by default.
TThhee _b_o_o_t_p kkeeyywwoorrdd
aallllooww bboooottpp;;
ddeennyy bboooottpp;;
The uunnkknnoowwnn--cclliieennttss flag is used to tell dhcpd whether or
not to respond to bootp queries. Bootp queries are
aalllloowwed by default.
TThhee _b_o_o_t_i_n_g kkeeyywwoorrdd
aallllooww bboooottiinngg;;
ddeennyy bboooottiinngg;;
The bboooottiinngg flag is used to tell dhcpd whether or not to
respond to queries from a particular client. This keyword
only has meaning when it appears in a host declaration.
By default, booting is aalllloowwed, but if it is disabled for
a particular client, then that client will not be able to
get and address from the DHCP server.
RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
TThhee _d_e_f_a_u_l_t_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt TThhee _d_e_f_a_u_l_t_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt
@@ -484,6 +520,18 @@ RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
TThhee _m_a_x_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt TThhee _m_a_x_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt
8
dhcpd.conf(5) dhcpd.conf(5)
mmaaxx--lleeaassee--ttiimmee _t_i_m_e;; mmaaxx--lleeaassee--ttiimmee _t_i_m_e;;
_T_i_m_e should be the maximum length in seconds that will be _T_i_m_e should be the maximum length in seconds that will be
@@ -520,18 +568,6 @@ RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
The _s_e_r_v_e_r_-_n_a_m_e statement can be used to inform the client The _s_e_r_v_e_r_-_n_a_m_e statement can be used to inform the client
of the name of the server from which it is booting. _N_a_m_e of the name of the server from which it is booting. _N_a_m_e
8
dhcpd.conf(5) dhcpd.conf(5)
should be the name that will be provided to the client. should be the name that will be provided to the client.
TThhee _n_e_x_t_-_s_e_r_v_e_r ssttaatteemmeenntt TThhee _n_e_x_t_-_s_e_r_v_e_r ssttaatteemmeenntt
@@ -550,6 +586,18 @@ dhcpd.conf(5) dhcpd.conf(5)
ffiixxeedd--aaddddrreessss _a_d_d_r_e_s_s [,, _a_d_d_r_e_s_s ... ];; ffiixxeedd--aaddddrreessss _a_d_d_r_e_s_s [,, _a_d_d_r_e_s_s ... ];;
9
dhcpd.conf(5) dhcpd.conf(5)
The _f_i_x_e_d_-_a_d_d_r_e_s_s statement is used to assign one or more The _f_i_x_e_d_-_a_d_d_r_e_s_s statement is used to assign one or more
fixed IP addresses to a client. It should only appear in fixed IP addresses to a client. It should only appear in
a _h_o_s_t declaration. If more than one address is supplied, a _h_o_s_t declaration. If more than one address is supplied,
@@ -586,18 +634,6 @@ dhcpd.conf(5) dhcpd.conf(5)
the century. MM is the month expressed as a number from 1 the century. MM is the month expressed as a number from 1
to 12. DD is the day of the month, counting from 1. HH to 12. DD is the day of the month, counting from 1. HH
is the hour, from zero to 23. MM is the minute and SS is is the hour, from zero to 23. MM is the minute and SS is
9
dhcpd.conf(5) dhcpd.conf(5)
the second. The time is always in Greenwich Mean Time the second. The time is always in Greenwich Mean Time
(GMT), not local time. (GMT), not local time.
@@ -617,16 +653,16 @@ dhcpd.conf(5) dhcpd.conf(5)
lose its lease. Needless to say, this parameter should be lose its lease. Needless to say, this parameter should be
adjusted with extreme caution. adjusted with extreme caution.
TThhee _b_o_o_t_-_u_n_k_n_o_w_n_-_c_l_i_e_n_t_s ssttaatteemmeenntt
bboooott--uunnkknnoowwnn--cclliieennttss _f_l_a_g;;
The _b_o_o_t_-_u_n_k_n_o_w_n_-_c_l_i_e_n_t_s statement is used to tell dhcpd 10
whether or not to dynamically assign addresses to unknown
clients. If _f_l_a_g is true (the default), then addresses
are dynamically assigned to unknown clients when avail-
able. If _f_l_a_g is false, then addresses are provided only
to clients which match at least one host declaration.
dhcpd.conf(5) dhcpd.conf(5)
TThhee _g_e_t_-_l_e_a_s_e_-_h_o_s_t_n_a_m_e_s ssttaatteemmeenntt TThhee _g_e_t_-_l_e_a_s_e_-_h_o_s_t_n_a_m_e_s ssttaatteemmeenntt
@@ -652,18 +688,6 @@ dhcpd.conf(5) dhcpd.conf(5)
group { group {
use-host-decl-names on; use-host-decl-names on;
10
dhcpd.conf(5) dhcpd.conf(5)
host joe { host joe {
hardware ethernet 08:00:2b:4c:29:32; hardware ethernet 08:00:2b:4c:29:32;
fixed-address joe.fugue.com; fixed-address joe.fugue.com;
@@ -694,6 +718,18 @@ RREEFFEERREENNCCEE:: OOPPTTIIOONN SSTTAATTEEMMEENNTTSS
The iipp--aaddddrreessss data type can be entered either as an The iipp--aaddddrreessss data type can be entered either as an
explicit IP address (e.g., 239.254.197.10) or as a domain explicit IP address (e.g., 239.254.197.10) or as a domain
11
dhcpd.conf(5) dhcpd.conf(5)
name (e.g., haagen.isc.org). When entering a domain name, name (e.g., haagen.isc.org). When entering a domain name,
be sure that that domain name resolves to a single IP be sure that that domain name resolves to a single IP
address. address.
@@ -717,20 +753,8 @@ RREEFFEERREENNCCEE:: OOPPTTIIOONN SSTTAATTEEMMEENNTTSS
The ddaattaa--ssttrriinngg data type specifies either an NVT ASCII The ddaattaa--ssttrriinngg data type specifies either an NVT ASCII
string enclosed in double quotes, or a series of octets string enclosed in double quotes, or a series of octets
specified in hexadecimal, seperated by colons. For specified in hexadecimal, seperated by colons. For exam-
ple:
11
dhcpd.conf(5) dhcpd.conf(5)
example:
option client-identifier "CLIENT-FOO"; option client-identifier "CLIENT-FOO";
or or
@@ -760,6 +784,18 @@ dhcpd.conf(5) dhcpd.conf(5)
as per RFC 950. If no subnet mask option is provided any- as per RFC 950. If no subnet mask option is provided any-
where in scope, as a last resort dhcpd will use the subnet where in scope, as a last resort dhcpd will use the subnet
mask from the subnet declaration for the network on which mask from the subnet declaration for the network on which
12
dhcpd.conf(5) dhcpd.conf(5)
an address is being assigned. However, _a_n_y subnet-mask an address is being assigned. However, _a_n_y subnet-mask
option declaration that is in scope for the address being option declaration that is in scope for the address being
assigned will override the subnet mask specified in the assigned will override the subnet mask specified in the
@@ -785,17 +821,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nnaammee--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ]; ooppttiioonn nnaammee--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];
12
dhcpd.conf(5) dhcpd.conf(5)
The name-servers option specifies a list of IEN 116 name The name-servers option specifies a list of IEN 116 name
servers available to the client. Servers should be listed servers available to the client. Servers should be listed
in order of preference. in order of preference.
@@ -826,6 +851,17 @@ dhcpd.conf(5) dhcpd.conf(5)
printer servers available to the client. Servers should printer servers available to the client. Servers should
be listed in order of preference. be listed in order of preference.
13
dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iimmpprreessss--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn iimmpprreessss--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
The impress-server option specifies a list of Imagen The impress-server option specifies a list of Imagen
@@ -850,18 +886,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn bboooott--ssiizzee _u_i_n_t_1_6;; ooppttiioonn bboooott--ssiizzee _u_i_n_t_1_6;;
This option specifies the length in 512-octet blocks of This option specifies the length in 512-octet blocks of
13
dhcpd.conf(5) dhcpd.conf(5)
the default boot image for the client. the default boot image for the client.
ooppttiioonn mmeerriitt--dduummpp _s_t_r_i_n_g;; ooppttiioonn mmeerriitt--dduummpp _s_t_r_i_n_g;;
@@ -892,6 +916,18 @@ dhcpd.conf(5) dhcpd.conf(5)
This option specifies whether the client should configure This option specifies whether the client should configure
its IP layer for packet forwarding. A value of 0 means its IP layer for packet forwarding. A value of 0 means
14
dhcpd.conf(5) dhcpd.conf(5)
disable IP forwarding, and a value of 1 means enable IP disable IP forwarding, and a value of 1 means enable IP
forwarding. forwarding.
@@ -916,18 +952,6 @@ dhcpd.conf(5) dhcpd.conf(5)
match one of the filters should be discarded by the match one of the filters should be discarded by the
client. client.
14
dhcpd.conf(5) dhcpd.conf(5)
See STD 3 (RFC1122) for further information. See STD 3 (RFC1122) for further information.
ooppttiioonn mmaaxx--ddggrraamm--rreeaasssseemmbbllyy _u_i_n_t_1_6;; ooppttiioonn mmaaxx--ddggrraamm--rreeaasssseemmbbllyy _u_i_n_t_1_6;;
@@ -958,6 +982,18 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iinntteerrffaaccee--mmttuu _u_i_n_t_1_6;; ooppttiioonn iinntteerrffaaccee--mmttuu _u_i_n_t_1_6;;
This option specifies the MTU to use on this interface. This option specifies the MTU to use on this interface.
15
dhcpd.conf(5) dhcpd.conf(5)
The minimum legal value for the MTU is 68. The minimum legal value for the MTU is 68.
ooppttiioonn aallll--ssuubbnneettss--llooccaall _f_l_a_g;; ooppttiioonn aallll--ssuubbnneettss--llooccaall _f_l_a_g;;
@@ -982,18 +1018,6 @@ dhcpd.conf(5) dhcpd.conf(5)
perform subnet mask discovery using ICMP. A value of 0 perform subnet mask discovery using ICMP. A value of 0
indicates that the client should not perform mask discov- indicates that the client should not perform mask discov-
ery. A value of 1 means that the client should perform ery. A value of 1 means that the client should perform
15
dhcpd.conf(5) dhcpd.conf(5)
mask discovery. mask discovery.
ooppttiioonn mmaasskk--ssuupppplliieerr _f_l_a_g;; ooppttiioonn mmaasskk--ssuupppplliieerr _f_l_a_g;;
@@ -1024,6 +1048,18 @@ dhcpd.conf(5) dhcpd.conf(5)
routes to the same destination are specified, they are routes to the same destination are specified, they are
listed in descending order of priority. listed in descending order of priority.
16
dhcpd.conf(5) dhcpd.conf(5)
The routes consist of a list of IP address pairs. The The routes consist of a list of IP address pairs. The
first address is the destination address, and the second first address is the destination address, and the second
address is the router for the destination. address is the router for the destination.
@@ -1048,18 +1084,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iieeeeee880022--33--eennccaappssuullaattiioonn _f_l_a_g;; ooppttiioonn iieeeeee880022--33--eennccaappssuullaattiioonn _f_l_a_g;;
This option specifies whether or not the client should use This option specifies whether or not the client should use
16
dhcpd.conf(5) dhcpd.conf(5)
Ethernet Version 2 (RFC 894) or IEEE 802.3 (RFC 1042) Ethernet Version 2 (RFC 894) or IEEE 802.3 (RFC 1042)
encapsulation if the interface is an Ethernet. A value of encapsulation if the interface is an Ethernet. A value of
0 indicates that the client should use RFC 894 encapsula- 0 indicates that the client should use RFC 894 encapsula-
@@ -1091,6 +1115,17 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nniiss--ddoommaaiinn _s_t_r_i_n_g;; ooppttiioonn nniiss--ddoommaaiinn _s_t_r_i_n_g;;
17
dhcpd.conf(5) dhcpd.conf(5)
This option specifies the name of the client's NIS (Sun This option specifies the name of the client's NIS (Sun
Network Information Services) domain. The domain is for- Network Information Services) domain. The domain is for-
matted as a character string consisting of characters from matted as a character string consisting of characters from
@@ -1115,17 +1150,6 @@ dhcpd.conf(5) dhcpd.conf(5)
RFC 1001/1002 NBNS name servers listed in order of prefer- RFC 1001/1002 NBNS name servers listed in order of prefer-
ence. ence.
17
dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nneettbbiiooss--dddd--sseerrvveerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn nneettbbiiooss--dddd--sseerrvveerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
The NetBIOS datagram distribution server (NBDD) option The NetBIOS datagram distribution server (NBDD) option
@@ -1157,6 +1181,17 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn xx--ddiissppllaayy--mmaannaaggeerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn xx--ddiissppllaayy--mmaannaaggeerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
18
dhcpd.conf(5) dhcpd.conf(5)
This option specifies a list of systems that are running This option specifies a list of systems that are running
the X Window System Display Manager and are available to the X Window System Display Manager and are available to
the client. Addresses should be listed in order of pref- the client. Addresses should be listed in order of pref-
@@ -1183,6 +1218,37 @@ AAUUTTHHOORR
18
19

2
server/dhcpd.8
View File

@@ -298,7 +298,7 @@ in dhcpd.conf(5).
.B ETCDIR/dhcpd.conf, DBDIR/dhcpd.leases, RUNDIR/dhcpd.pid, .B ETCDIR/dhcpd.conf, DBDIR/dhcpd.leases, RUNDIR/dhcpd.pid,
.B DBDIR/dhcpd.leases~. .B DBDIR/dhcpd.leases~.
.SH SEE ALSO .SH SEE ALSO
dhcpd.conf(5), dhcpd.leases(5) dhclient(8), dhcrelay(8), dhcpd.conf(5), dhcpd.leases(5)
.SH AUTHOR .SH AUTHOR
.B dhcpd(8) .B dhcpd(8)
was written by Ted Lemon <mellon@vix.com> was written by Ted Lemon <mellon@vix.com>

8
server/dhcpd.cat8
View File

@@ -105,9 +105,9 @@ CCOOMMMMAANNDD LLIINNEE
unable to identify non-broadcast interfaces, but should unable to identify non-broadcast interfaces, but should
not be required on other systems. If no interface names not be required on other systems. If no interface names
are specified on the command line dhcpd will identify all are specified on the command line dhcpd will identify all
network interfaces which are up, elimininating non- network interfaces which are up, elimininating non-broad-
broadcast interfaces if possible, and listen for DHCP cast interfaces if possible, and listen for DHCP broad-
broadcasts on each interface. casts on each interface.
If dhcpd should listen on a port other than the standard If dhcpd should listen on a port other than the standard
(port 67), the --pp flag may used. It should be followed by (port 67), the --pp flag may used. It should be followed by
@@ -301,7 +301,7 @@ FFIILLEESS
//vvaarr//ddbb//ddhhccppdd..lleeaasseess~~.. //vvaarr//ddbb//ddhhccppdd..lleeaasseess~~..
SSEEEE AALLSSOO SSEEEE AALLSSOO
dhcpd.conf(5), dhcpd.leases(5) dhclient(8), dhcrelay(8), dhcpd.conf(5), dhcpd.leases(5)
AAUUTTHHOORR AAUUTTHHOORR
ddhhccppdd((88)) was written by Ted Lemon <mellon@vix.com> under a ddhhccppdd((88)) was written by Ted Lemon <mellon@vix.com> under a

57
server/dhcpd.conf.5
View File

@@ -443,6 +443,50 @@ be used for all clients that may boot using the BOOTP protocol.
The group statement is used simply to apply one or more parameters to The group statement is used simply to apply one or more parameters to
a group of declarations. It can be used to group hosts, shared a group of declarations. It can be used to group hosts, shared
networks, subnets, or even other groups. networks, subnets, or even other groups.
.SH REFERENCE: ALLOW and DENY
.PP
The
.I allow
and
.I deny
statements can be used to control the behaviour of dhcpd to various
sorts of requests.
.PP
.PP
.B The
.I unknown-clients
.B keyword
.PP
\fBallow unknown-clients;\fR
\fBdeny unknown-clients;\fR
.PP
The \fBunknown-clients\fR flag is used to tell dhcpd whether
or not to dynamically assign addresses to unknown clients. Dynamic
address assignment to unknown clients is \fBallow\fRed by default.
.PP
.B The
.I bootp
.B keyword
.PP
\fBallow bootp;\fR
\fBdeny bootp;\fR
.PP
The \fBunknown-clients\fR flag is used to tell dhcpd whether
or not to respond to bootp queries. Bootp queries are \fBallow\fRed
by default.
.PP
.B The
.I booting
.B keyword
.PP
\fBallow booting;\fR
\fBdeny booting;\fR
.PP
The \fBbooting\fR flag is used to tell dhcpd whether or not to respond
to queries from a particular client. This keyword only has meaning
when it appears in a host declaration. By default, booting is
\fBallow\fRed, but if it is disabled for a particular client, then
that client will not be able to get and address from the DHCP server.
.SH REFERENCE: PARAMETERS .SH REFERENCE: PARAMETERS
.PP .PP
.B The .B The
@@ -591,19 +635,6 @@ Needless to say, this parameter should be adjusted with extreme
caution. caution.
.PP .PP
.B The .B The
.I boot-unknown-clients
.B statement
.PP
\fBboot-unknown-clients\fR \fIflag\fR\fB;\fR
.PP
The \fIboot-unknown-clients\fR statement is used to tell dhcpd whether
or not to dynamically assign addresses to unknown clients. If
\fIflag\fR is true (the default), then addresses are dynamically
assigned to unknown clients when available. If \fIflag\fR is
false, then addresses are provided only to clients which match at
least one host declaration.
.PP
.B The
.I get-lease-hostnames .I get-lease-hostnames
.B statement .B statement
.PP .PP

346
server/dhcpd.conf.cat5
View File

@@ -14,10 +14,10 @@ DDEESSCCRRIIPPTTIIOONN
The dhcpd.conf file is a free-form ASCII text file. It The dhcpd.conf file is a free-form ASCII text file. It
is parsed by the recursive-descent parser built into is parsed by the recursive-descent parser built into
dhcpd. The file may contain extra tabs and newlines for dhcpd. The file may contain extra tabs and newlines for
formatting purposes. Keywords in the file are case- formatting purposes. Keywords in the file are case-insen-
insensitive. Comments may be placed anywhere within the sitive. Comments may be placed anywhere within the file
file (except within quotes). Comments begin with the # (except within quotes). Comments begin with the # char-
character and end at the end of the line. acter and end at the end of the line.
The file essentially consists of a list of statements. The file essentially consists of a list of statements.
Statements fall into two broad categories - parameters and Statements fall into two broad categories - parameters and
@@ -268,11 +268,11 @@ dhcpd.conf(5) dhcpd.conf(5)
dhcpd.conf(5) dhcpd.conf(5) dhcpd.conf(5) dhcpd.conf(5)
Imagine that you have a site with a lot of NCD X- Imagine that you have a site with a lot of NCD X-Termi-
Terminals. These terminals come in a variety of models, nals. These terminals come in a variety of models, and
and you want to specify the boot files for each models. you want to specify the boot files for each models. One
One way to do this would be to have host declarations for way to do this would be to have host declarations for each
each server and group them by model: server and group them by model:
group { group {
filename "Xncd19r"; filename "Xncd19r";
@@ -363,8 +363,8 @@ dhcpd.conf(5) dhcpd.conf(5)
The _s_u_b_n_e_t statement is used to provide dhcpd with enough The _s_u_b_n_e_t statement is used to provide dhcpd with enough
information to tell whether or not an IP address is on information to tell whether or not an IP address is on
that subnet. It may also be used to provide subnet- that subnet. It may also be used to provide subnet-spe-
specific parameters and to specify what addresses may be cific parameters and to specify what addresses may be
dynamically allocated to clients booting on that subnet. dynamically allocated to clients booting on that subnet.
Such addresses are specified using the _r_a_n_g_e declaration. Such addresses are specified using the _r_a_n_g_e declaration.
@@ -473,6 +473,42 @@ dhcpd.conf(5) dhcpd.conf(5)
group hosts, shared networks, subnets, or even other group hosts, shared networks, subnets, or even other
groups. groups.
RREEFFEERREENNCCEE:: AALLLLOOWW aanndd DDEENNYY
The _a_l_l_o_w and _d_e_n_y statements can be used to control the
behaviour of dhcpd to various sorts of requests.
TThhee _u_n_k_n_o_w_n_-_c_l_i_e_n_t_s kkeeyywwoorrdd
aallllooww uunnkknnoowwnn--cclliieennttss;;
ddeennyy uunnkknnoowwnn--cclliieennttss;;
The uunnkknnoowwnn--cclliieennttss flag is used to tell dhcpd whether or
not to dynamically assign addresses to unknown clients.
Dynamic address assignment to unknown clients is aalllloowwed
by default.
TThhee _b_o_o_t_p kkeeyywwoorrdd
aallllooww bboooottpp;;
ddeennyy bboooottpp;;
The uunnkknnoowwnn--cclliieennttss flag is used to tell dhcpd whether or
not to respond to bootp queries. Bootp queries are
aalllloowwed by default.
TThhee _b_o_o_t_i_n_g kkeeyywwoorrdd
aallllooww bboooottiinngg;;
ddeennyy bboooottiinngg;;
The bboooottiinngg flag is used to tell dhcpd whether or not to
respond to queries from a particular client. This keyword
only has meaning when it appears in a host declaration.
By default, booting is aalllloowwed, but if it is disabled for
a particular client, then that client will not be able to
get and address from the DHCP server.
RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
TThhee _d_e_f_a_u_l_t_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt TThhee _d_e_f_a_u_l_t_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt
@@ -484,6 +520,18 @@ RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
TThhee _m_a_x_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt TThhee _m_a_x_-_l_e_a_s_e_-_t_i_m_e ssttaatteemmeenntt
8
dhcpd.conf(5) dhcpd.conf(5)
mmaaxx--lleeaassee--ttiimmee _t_i_m_e;; mmaaxx--lleeaassee--ttiimmee _t_i_m_e;;
_T_i_m_e should be the maximum length in seconds that will be _T_i_m_e should be the maximum length in seconds that will be
@@ -520,18 +568,6 @@ RREEFFEERREENNCCEE:: PPAARRAAMMEETTEERRSS
The _s_e_r_v_e_r_-_n_a_m_e statement can be used to inform the client The _s_e_r_v_e_r_-_n_a_m_e statement can be used to inform the client
of the name of the server from which it is booting. _N_a_m_e of the name of the server from which it is booting. _N_a_m_e
8
dhcpd.conf(5) dhcpd.conf(5)
should be the name that will be provided to the client. should be the name that will be provided to the client.
TThhee _n_e_x_t_-_s_e_r_v_e_r ssttaatteemmeenntt TThhee _n_e_x_t_-_s_e_r_v_e_r ssttaatteemmeenntt
@@ -550,6 +586,18 @@ dhcpd.conf(5) dhcpd.conf(5)
ffiixxeedd--aaddddrreessss _a_d_d_r_e_s_s [,, _a_d_d_r_e_s_s ... ];; ffiixxeedd--aaddddrreessss _a_d_d_r_e_s_s [,, _a_d_d_r_e_s_s ... ];;
9
dhcpd.conf(5) dhcpd.conf(5)
The _f_i_x_e_d_-_a_d_d_r_e_s_s statement is used to assign one or more The _f_i_x_e_d_-_a_d_d_r_e_s_s statement is used to assign one or more
fixed IP addresses to a client. It should only appear in fixed IP addresses to a client. It should only appear in
a _h_o_s_t declaration. If more than one address is supplied, a _h_o_s_t declaration. If more than one address is supplied,
@@ -586,18 +634,6 @@ dhcpd.conf(5) dhcpd.conf(5)
the century. MM is the month expressed as a number from 1 the century. MM is the month expressed as a number from 1
to 12. DD is the day of the month, counting from 1. HH to 12. DD is the day of the month, counting from 1. HH
is the hour, from zero to 23. MM is the minute and SS is is the hour, from zero to 23. MM is the minute and SS is
9
dhcpd.conf(5) dhcpd.conf(5)
the second. The time is always in Greenwich Mean Time the second. The time is always in Greenwich Mean Time
(GMT), not local time. (GMT), not local time.
@@ -617,16 +653,16 @@ dhcpd.conf(5) dhcpd.conf(5)
lose its lease. Needless to say, this parameter should be lose its lease. Needless to say, this parameter should be
adjusted with extreme caution. adjusted with extreme caution.
TThhee _b_o_o_t_-_u_n_k_n_o_w_n_-_c_l_i_e_n_t_s ssttaatteemmeenntt
bboooott--uunnkknnoowwnn--cclliieennttss _f_l_a_g;;
The _b_o_o_t_-_u_n_k_n_o_w_n_-_c_l_i_e_n_t_s statement is used to tell dhcpd 10
whether or not to dynamically assign addresses to unknown
clients. If _f_l_a_g is true (the default), then addresses
are dynamically assigned to unknown clients when avail-
able. If _f_l_a_g is false, then addresses are provided only
to clients which match at least one host declaration.
dhcpd.conf(5) dhcpd.conf(5)
TThhee _g_e_t_-_l_e_a_s_e_-_h_o_s_t_n_a_m_e_s ssttaatteemmeenntt TThhee _g_e_t_-_l_e_a_s_e_-_h_o_s_t_n_a_m_e_s ssttaatteemmeenntt
@@ -652,18 +688,6 @@ dhcpd.conf(5) dhcpd.conf(5)
group { group {
use-host-decl-names on; use-host-decl-names on;
10
dhcpd.conf(5) dhcpd.conf(5)
host joe { host joe {
hardware ethernet 08:00:2b:4c:29:32; hardware ethernet 08:00:2b:4c:29:32;
fixed-address joe.fugue.com; fixed-address joe.fugue.com;
@@ -694,6 +718,18 @@ RREEFFEERREENNCCEE:: OOPPTTIIOONN SSTTAATTEEMMEENNTTSS
The iipp--aaddddrreessss data type can be entered either as an The iipp--aaddddrreessss data type can be entered either as an
explicit IP address (e.g., 239.254.197.10) or as a domain explicit IP address (e.g., 239.254.197.10) or as a domain
11
dhcpd.conf(5) dhcpd.conf(5)
name (e.g., haagen.isc.org). When entering a domain name, name (e.g., haagen.isc.org). When entering a domain name,
be sure that that domain name resolves to a single IP be sure that that domain name resolves to a single IP
address. address.
@@ -717,20 +753,8 @@ RREEFFEERREENNCCEE:: OOPPTTIIOONN SSTTAATTEEMMEENNTTSS
The ddaattaa--ssttrriinngg data type specifies either an NVT ASCII The ddaattaa--ssttrriinngg data type specifies either an NVT ASCII
string enclosed in double quotes, or a series of octets string enclosed in double quotes, or a series of octets
specified in hexadecimal, seperated by colons. For specified in hexadecimal, seperated by colons. For exam-
ple:
11
dhcpd.conf(5) dhcpd.conf(5)
example:
option client-identifier "CLIENT-FOO"; option client-identifier "CLIENT-FOO";
or or
@@ -760,6 +784,18 @@ dhcpd.conf(5) dhcpd.conf(5)
as per RFC 950. If no subnet mask option is provided any- as per RFC 950. If no subnet mask option is provided any-
where in scope, as a last resort dhcpd will use the subnet where in scope, as a last resort dhcpd will use the subnet
mask from the subnet declaration for the network on which mask from the subnet declaration for the network on which
12
dhcpd.conf(5) dhcpd.conf(5)
an address is being assigned. However, _a_n_y subnet-mask an address is being assigned. However, _a_n_y subnet-mask
option declaration that is in scope for the address being option declaration that is in scope for the address being
assigned will override the subnet mask specified in the assigned will override the subnet mask specified in the
@@ -785,17 +821,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nnaammee--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ]; ooppttiioonn nnaammee--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];
12
dhcpd.conf(5) dhcpd.conf(5)
The name-servers option specifies a list of IEN 116 name The name-servers option specifies a list of IEN 116 name
servers available to the client. Servers should be listed servers available to the client. Servers should be listed
in order of preference. in order of preference.
@@ -826,6 +851,17 @@ dhcpd.conf(5) dhcpd.conf(5)
printer servers available to the client. Servers should printer servers available to the client. Servers should
be listed in order of preference. be listed in order of preference.
13
dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iimmpprreessss--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn iimmpprreessss--sseerrvveerrss _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
The impress-server option specifies a list of Imagen The impress-server option specifies a list of Imagen
@@ -850,18 +886,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn bboooott--ssiizzee _u_i_n_t_1_6;; ooppttiioonn bboooott--ssiizzee _u_i_n_t_1_6;;
This option specifies the length in 512-octet blocks of This option specifies the length in 512-octet blocks of
13
dhcpd.conf(5) dhcpd.conf(5)
the default boot image for the client. the default boot image for the client.
ooppttiioonn mmeerriitt--dduummpp _s_t_r_i_n_g;; ooppttiioonn mmeerriitt--dduummpp _s_t_r_i_n_g;;
@@ -892,6 +916,18 @@ dhcpd.conf(5) dhcpd.conf(5)
This option specifies whether the client should configure This option specifies whether the client should configure
its IP layer for packet forwarding. A value of 0 means its IP layer for packet forwarding. A value of 0 means
14
dhcpd.conf(5) dhcpd.conf(5)
disable IP forwarding, and a value of 1 means enable IP disable IP forwarding, and a value of 1 means enable IP
forwarding. forwarding.
@@ -916,18 +952,6 @@ dhcpd.conf(5) dhcpd.conf(5)
match one of the filters should be discarded by the match one of the filters should be discarded by the
client. client.
14
dhcpd.conf(5) dhcpd.conf(5)
See STD 3 (RFC1122) for further information. See STD 3 (RFC1122) for further information.
ooppttiioonn mmaaxx--ddggrraamm--rreeaasssseemmbbllyy _u_i_n_t_1_6;; ooppttiioonn mmaaxx--ddggrraamm--rreeaasssseemmbbllyy _u_i_n_t_1_6;;
@@ -958,6 +982,18 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iinntteerrffaaccee--mmttuu _u_i_n_t_1_6;; ooppttiioonn iinntteerrffaaccee--mmttuu _u_i_n_t_1_6;;
This option specifies the MTU to use on this interface. This option specifies the MTU to use on this interface.
15
dhcpd.conf(5) dhcpd.conf(5)
The minimum legal value for the MTU is 68. The minimum legal value for the MTU is 68.
ooppttiioonn aallll--ssuubbnneettss--llooccaall _f_l_a_g;; ooppttiioonn aallll--ssuubbnneettss--llooccaall _f_l_a_g;;
@@ -982,18 +1018,6 @@ dhcpd.conf(5) dhcpd.conf(5)
perform subnet mask discovery using ICMP. A value of 0 perform subnet mask discovery using ICMP. A value of 0
indicates that the client should not perform mask discov- indicates that the client should not perform mask discov-
ery. A value of 1 means that the client should perform ery. A value of 1 means that the client should perform
15
dhcpd.conf(5) dhcpd.conf(5)
mask discovery. mask discovery.
ooppttiioonn mmaasskk--ssuupppplliieerr _f_l_a_g;; ooppttiioonn mmaasskk--ssuupppplliieerr _f_l_a_g;;
@@ -1024,6 +1048,18 @@ dhcpd.conf(5) dhcpd.conf(5)
routes to the same destination are specified, they are routes to the same destination are specified, they are
listed in descending order of priority. listed in descending order of priority.
16
dhcpd.conf(5) dhcpd.conf(5)
The routes consist of a list of IP address pairs. The The routes consist of a list of IP address pairs. The
first address is the destination address, and the second first address is the destination address, and the second
address is the router for the destination. address is the router for the destination.
@@ -1048,18 +1084,6 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn iieeeeee880022--33--eennccaappssuullaattiioonn _f_l_a_g;; ooppttiioonn iieeeeee880022--33--eennccaappssuullaattiioonn _f_l_a_g;;
This option specifies whether or not the client should use This option specifies whether or not the client should use
16
dhcpd.conf(5) dhcpd.conf(5)
Ethernet Version 2 (RFC 894) or IEEE 802.3 (RFC 1042) Ethernet Version 2 (RFC 894) or IEEE 802.3 (RFC 1042)
encapsulation if the interface is an Ethernet. A value of encapsulation if the interface is an Ethernet. A value of
0 indicates that the client should use RFC 894 encapsula- 0 indicates that the client should use RFC 894 encapsula-
@@ -1091,6 +1115,17 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nniiss--ddoommaaiinn _s_t_r_i_n_g;; ooppttiioonn nniiss--ddoommaaiinn _s_t_r_i_n_g;;
17
dhcpd.conf(5) dhcpd.conf(5)
This option specifies the name of the client's NIS (Sun This option specifies the name of the client's NIS (Sun
Network Information Services) domain. The domain is for- Network Information Services) domain. The domain is for-
matted as a character string consisting of characters from matted as a character string consisting of characters from
@@ -1115,17 +1150,6 @@ dhcpd.conf(5) dhcpd.conf(5)
RFC 1001/1002 NBNS name servers listed in order of prefer- RFC 1001/1002 NBNS name servers listed in order of prefer-
ence. ence.
17
dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn nneettbbiiooss--dddd--sseerrvveerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn nneettbbiiooss--dddd--sseerrvveerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
The NetBIOS datagram distribution server (NBDD) option The NetBIOS datagram distribution server (NBDD) option
@@ -1157,6 +1181,17 @@ dhcpd.conf(5) dhcpd.conf(5)
ooppttiioonn xx--ddiissppllaayy--mmaannaaggeerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];; ooppttiioonn xx--ddiissppllaayy--mmaannaaggeerr _i_p_-_a_d_d_r_e_s_s [,, _i_p_-_a_d_d_r_e_s_s ... ];;
18
dhcpd.conf(5) dhcpd.conf(5)
This option specifies a list of systems that are running This option specifies a list of systems that are running
the X Window System Display Manager and are available to the X Window System Display Manager and are available to
the client. Addresses should be listed in order of pref- the client. Addresses should be listed in order of pref-
@@ -1183,6 +1218,37 @@ AAUUTTHHOORR
18
19