NAME
dhclient.leases
—
DHCP client lease database
DESCRIPTION
dhclient(8) keeps a persistent database of leases that it has acquired that are still valid. The database is a free-form ASCII file containing one valid declaration per lease. The file is written as a log, so the last declaration is the most recent lease obtained.
The lease file is named /var/db/dhclient.leases.⟨IFNAME⟩, where "IFNAME" represents the network interface dhclient(8) acquired the lease on. For example, if dhclient(8) is configured for the em0 network device, the lease file will be named /var/db/dhclient.leases.em0,
A lease statement has the format
lease
{ lease-declaration;
...; }Where lease-declaration is one of:
bootp
- The lease was acquired using the BOOTP protocol rather than the DHCP protocol.
epoch
- The time(3) when the lease
was obtained. This value is used to convert the values of the DHCP options
dhcp-lease-time
,dhcp-renewal-time
, anddhcp-rebinding-time
to times. A value of 0 will causeepoch
to be set to the current time whendhclient.leases
is processed. expire
daterebind
daterenew
dateexpire
is when dhclient(8) will no longer use the lease to configure the interface.rebind
is when dhclient(8) will begin trying to renew the lease with broadcasts to any server.renew
is when dhclient(8) will begin trying to renew the lease with unicasts to the originating server.Dates are specified in accordance with the strptime(3) format:
%w %Y/%m/%d %T UTCFor example:
renew 1 2017/10/16 14:03:49 UTC
expire
,rebind
,renew
are just comments that are ignored when processingdhclient.leases
. The values used by dhclient(8) are always recalculated based onepoch
whendhclient.leases
is processed.filename
"string"- The boot filename.
fixed-address
ip-address- The IPv4 address of the lease. This is required for all lease statements. The IPv4 address is specified as a dotted quad (e.g. 12.34.56.78).
next-server
ip-address- The IPv4 address of the boot server. The IPv4 address is specified as a dotted quad (e.g. 12.34.56.78).
option
option option-value- The value of option. DHCP options are described in dhcp-options(5).
server-name
"string"- The name of the boot server.
ssid
"string"- The SSID to which the lease applies.
FILES
- /var/db/dhclient.leases.⟨IFNAME⟩
- Persistent database of leases for ⟨IFNAME⟩.
SEE ALSO
dhclient.conf(5), dhcp-options(5), dhcpd.conf(5), dhclient(8), dhcpd(8)