NAME
dhclient.conf
—
DHCP client configuration
file
DESCRIPTION
dhclient.conf
is the configuration file
for dhclient(8). It is a free-form ASCII text file made up of
declarations, extra tabs and newlines for formatting purposes and comments.
Keywords in the file are case-insensitive. Comments begin with the
‘#’ character and extend to the end of the current line.
PROTOCOL TIMING DECLARATIONS
backoff-cutoff
seconds;- Sets the maximum number of seconds to wait before retransmitting a packet. The default is 10 seconds.
initial-interval
seconds;- Sets the number of seconds between the first packet transmission and the first retransmission of the packet. The default is 1 second.
link-timeout
seconds;- Sets the number of seconds to wait for a lease before going into the background as a daemon. The default is 10 seconds.
reboot
seconds;- Sets the number of seconds to wait before giving up on reacquiring the previous lease, and how long to attempt unicast renewal requests before falling back to broadcast renewal requests. The default is 1 second.
retry
seconds;- Sets the number of seconds to wait before starting a new attempt to obtain a lease. The default is 1 second.
select-timeout
seconds;- Sets the number of seconds to wait for additional leases after the first
lease arrives. After
select-timeout
seconds the best lease received will be selected. The default is 0 seconds, i.e. immediately use the first acceptable lease received. timeout
seconds;- Sets the number of seconds to wait for a lease. If no lease is received the first valid lease in dhclient.leases(5) will be used. The default is 30 seonds.
DHCP OPTION DECLARATIONS
append
option option-value;- Append option-value to the value of
option in the lease. Each
append
for option overrides any previousappend
,default
,ignore
,prepend
orsupersede
for option.If the option's data cannot be appended to, i.e. it has a fixed size, then
append
will be treated asdefault
. default
option option-value;- If no value for option is present in the lease use
option-value. Each
default
for option overrides any previousappend
,default
,ignore
,prepend
orsupersede
for option. ignore
[option, ...];- Discard values provided for the listed options.
ignore
statements are cumulative, except that an empty list will remove all previously specified options. Eachignore
for option overrides any previousappend
,default
,prepend
orsupersede
for option. prepend
option option-value;- Prepend option-value to the value of
option in the lease. Each
prepend
for option overrides any previousappend
,default
,ignore
,prepend
orsupersede
for option.If the option's data cannot be prepended to, i.e. it has a fixed size, then
prepend
will be treated assupersede
. request
[option, ...];- Ask that any lease contain values for the listed options.
request
statements are cumulative, except that an empty list will remove all previously specified options. The default is to request the options bootfile-name, broadcast-address, classless-static-routes, host-name, domain-name, domain-name-servers, domain-search, routers, subnet-mask, tftp-server-name and time-offset. require
[option, ...];- Discard leases that do not contain the listed options.
require
statements are cumulative, except that an empty list will remove all previously specified options. The default is to require the option subnet-mask. send
option option-value;- Include option-value in requests for a lease. To
include multiple options in requests,
send
can be used multiple times. supersede
option option-value;- Use option-value for the given
option regardless of the value in the lease. Each
supersede
for option overrides any previousappend
,default
,ignore
,prepend
orsupersede
for option. uselease
[option, ...];- Use the unmodified values provided in the lease for any specified
option.
uselease
statements are cumulative. If no option is specified all lease option values will be used unmodified.uselease
for option overrides any previousappend
,default
,ignore
,prepend
orsupersede
for option.
OTHER DECLARATIONS
filename
path;- Use path instead of the
file
field of the DHCP offer when binding a lease. fixed-address
ip-address;- Use ip-address instead of the
yiaddr
field of the DHCP offer when binding a lease. interface
"name" { declaration; ...; }- Apply any declaration only to the named interface.
reject
ip-address;- Discard leases from the specified address. If more than one
reject
is present all leases from any of the addresses will be discarded. next-server
ip-address;- Use ip-address instead of the
siaddr
field of the DHCP offer when binding a lease. server-name
host;- Use host instead of the
sname
field of the DHCP offer when binding a lease.
FILES
- /etc/dhclient.conf
- /etc/examples/dhclient.conf
SEE ALSO
dhclient.leases(5), dhcp-options(5), dhcpd.conf(5), dhclient(8), dhcpd(8)