dhclient.leases(5) - OpenBSD manual pages

NAME

dhclient.leases — DHCP client lease database

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"