NAME
dhcpleased.conf – DHCP client configuration file
DESCRIPTION
The dhcpleased(8) daemon is a dynamic host configuration protocol client daemon.
The dhcpleased.conf config file is divided into the following main sections:
- Macros
-
Definitions of variables that can be used later, simplifying the configuration file.
- Interfaces
-
If an interface requires non-default options, they can be defined in this section. Most configurations do not require this.
Macros
A macro is defined with a command of the form name=value. The macro name can contain letters, digits, and underscores and cannot be a reserved word (for example, interface). Within unquoted arguments, the string $name is later expanded to value.
Interfaces
A list of interfaces to overwrite defaults:
- interface name {option ...}
-
interface options are as follows:
- ignore dns
-
Ignore nameservers from leases on this interface. The default is to not ignore nameservers.
- ignore routes
-
Ignore routes from leases on this interface. The default is to not ignore routes.
- ignore server-ip
-
Ignore leases from server-ip. This option can be listed multiple times. The default is to not ignore servers.
- prefer ipv6
-
Send the IPv6-Only preferred option to the server. If the server responds with the option, no lease is configured.
- send client id client-id
-
Send the DHCP client identifier option with a value of client-id. If client-id consists of a series of octets of two-digit hexadecimal numbers separated by colons, the first octet is used as the type and the rest as value. The MAC address 00:53:FF:AA:BB:CC would be configured as:
send client id "01:00:53:FF:AA:BB:CC"
Otherwise the string client-id is sent verbatim. The default is to send the interface's MAC address as client identifier.
When client-id is not a hardware address, it is supposed to be sent as hardware type 0 but the majority of DHCP clients and servers do not implement this and neither does dhcpleased.conf. If a server is encountered that requires this, a 0 byte can be encoded as \0. The client identifier “foobar” with hardware type 0 would be configured as:
send client id "\0foobar"
- send host name host-name
-
Send the DHCP client host name option with a value of host-name. The default is to send the name of the host.
- send no host name
-
Do not send a DHCP host name option. The default is to send a DHCP host name option with the name of the host.
- send vendor class id vendor-class-id
-
Send the DHCP vendor class identifier option with a value of vendor-class-id. The default is to not send a vendor class identifier.
FILES
- /etc/dhcpleased.conf
-
dhcpleased(8) configuration file.