DHCLIENT.LEASES(5)

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, and dhcp-rebinding-time to times. A value of 0 will cause epoch to be set to the current time when dhclient.leases is processed.

expire date
rebind date
renew date
    expire 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 UTC

    For example:

        renew 1 2017/10/16 14:03:49 UTC

    expire, rebind, renew are just comments that are ignored when processing dhclient.leases. The values used by dhclient(8) are always recalculated based on epoch when dhclient.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)