Configuration File
Upon startup,
dhcpv6d
reads the configuration file,
/etc/dhcpv6tab,
or a file specified with the
-c
option to build its internal database, and then listens
for DHCPv6 messages from the client.
The configuration file contains the following sections:
- 1.
DHCPv6 client default settings
- 2.
DHCPv6 pool group settings
- 3.
DHCPv6 relay settings
- 4.
DHCPv6 device group settings
- 5.
DHCPv6 address pool settings
- 6.
DHCPv6 relay interface mapping settings
- 7.
DHCPv6 client duid (DHCP Unique Identifier) group settings
Blank lines and lines beginning with "#" in the configuration file are
ignored. Entries are separated from one another by a semicolon.
Multiple entries of a group
can be extended over multiple lines if the lines end with a
backslash \.
A final semicolon ;
followed by a new line indicates the end of a group.
IP addresses are specified in the standard IPv6 notation (colon notation) and
can use hexadecimal numbers.
The binary hexadecimal format of a tag can be represented with each byte separated by
a colon (:) and without `0x'
prefixed to the hexadecimal number.
For example: The tag
0x12a131469
can be represented as
1:2a:13:14:69.
Alternatively, the prefix length can be specified along with the subnet
prefixes with a slash (/).
Example: For the prefix
5ffe:305:1002:1::,
the prefix length of 64 can be specified as
5ffe:305:1002:1::/64.
The tags for the DHCPv6 client default settings are as listed below. These
tags are applicable to all the addresses that the server assigns to the
DHCPv6 client.
- DHCP_CLIENT_DEFAULT_SETTINGS;
This tag specifies the client's default settings.
- client-settings-name=client-settings-name-in-string-format;
This tag specifies the name of the group default settings.
- DNS-server-address=List-of-IP-addresses-in-IPv6-Address-Format;
This tag specifies the list of DNS nameservers available to the
client. Multiple nameserver addresses are separated by white spaces.
- DNS-server-domain-list=string-format;
This tag specifies the list of names of the client's DNS domain.
DNS-server-domain-list
is formatted as a character string consisting of characters from the
NVT-ASCII character set.
- NIS-server-domain-list=string-format;
This tag specifies the list of names of the client's NIS domain.
NIS-server-domain-list
is formatted as a character string consisting of characters from the
NVT-ASCII character set.
- NIS-server-address=List-of-IP-addresses-in-IPv6-Address-Format;
This tag specifies the list of NIS servers
available to the client. Multiple addresses are separated by white spaces.
- NIS+client-domain-list=string-format;
This tag specifies the list of names of the client's NIS+ domain.
NIS+client-domain-list
is formatted as a character string consisting of characters from the
NVT-ASCII character set.
- NIS+server-address=List-of-IP-addresses-in-IPv6-Address-Format;
This tag specifies the list of NIS+ servers
available to the client. Multiple addresses are separated by white spaces.
- SIP-server-address=List-of-IP-addresses-in-IPv6-Address-Format;
This tag specifies the SIP server list available to the client.
- SIP-server-domain-list=string-format;
This tag specifies the list of names of the client's SIP domain names.
The domain name is formatted as a character string consisting of
the NVT-ASCII character set.
The tags applicable for the individual DHCPv6 pool groups are
as listed below:
- DHCP_POOL_GROUP;
This tag specifies the individual pool groups.
- pool-group-name=name-of-the-pool-group;
This tag specifies the name of the pool group as an
ASCII string.
- default-settings=default-settings-name;
This tag specifies the name of the default settings for the pool group.
The default settings are specified in the
DHCP_CLIENT_DEFAULT_SETTINGS.
- address-pool-names=List-of-address-pool-names;
This tag specifies the list of address pool names with each name
separated by space. The address pool names are specified in the section
DHCP_ADDRESS_POOL.
- deprecated-address-pool-names=List-of-address-pool-names;
This tag specifies the list of deprecated address pool names, with each name
separated by space. The deprecated address pools are specified in the section
DHCP_ADDRESS_POOL.
- preference=unsigned-integer;
This tag specifies the server preference to manage the subnet. This value can
range between 0 and 255.
- T1=time-value-in-seconds;
This variable is used by the server to control the time at which the
client contacts the server to extend the lifetimes on assigned addresses. On
expiration of T1, the client sends a RENEW message to the server. Default value is 302400 seconds.
- T2=time-value-in-seconds;
This variable is used by the server to control the time at which the
client contacts the server to extend the lifetimes on assigned addresses.
On expiration of T2, the client sends a REBIND message to the server. Default value is 483840 seconds.
- preferred-life-time=time-value-in-seconds;
This tag specifies the preferred lifetime for the IP addresses in seconds.
Default is 604800 seconds.
- valid-life-time=time-value-in-seconds;
This tag specifies the valid lifetime for the addresses in seconds.
Default is 2592000 seconds.
- reconf-grace-period=value;
This tag specifies the grace period (in seconds) until when the old
configuration parameters remain valid after reconfiguring the server.
Default is 604800 seconds.
- temp-preferred-life-time=time-value-in-seconds;
This tag specifies the preferred lifetime for temporary
addresses in seconds. Default is 86400 seconds.
- temp-valid-life-time=time-value-in-seconds;
This tag specifies the valid lifetime for temporary addresses
in seconds.
Default is 604800 seconds.
NOTE:
Values for the above listed lifetime-related tags must satisfy
the following conditions:
T1<=T2<=reconf-grace-period<=preferred-life-time<=valid-life-time
temp-preferred-life-time<=temp-valid-life-time
If the above condition fails, the server takes the default values.
- renumber-complete-time=absolute-time;
This tag specifies
deprecated address pools to be valid until the
absolute-time.
A sample format for
absolute-time
is as follows:
Thu Feb 19 17:01:55 IST 2004
The DHCPv6 address-pool-specific tags are as listed below:
- DHCP_ADDRESS_POOL;
This tag specifies the individual address pools.
- address-pool-name=address-pool-name-in-string-format;
This tag specifies the name of the address pool.
- subnet-prefix=IPv6-hex-address-format;
This tag specifies the subnet-prefix of the network that the server
manages. Note that, the complete address of the subnet must be
specified.
- address-pool=start_addr1 - end_addr1 start_addr2 - end_addr2... ;
This tag specifies the list of start and end address, which
constitute the address pool.
- reserved-addresses=list-of-IPv6-addresses;
This tag specifies the list of reserved IPv6 addresses separated
by a space.
The DHCPv6 relay-specific tags are as listed below:
- DHCP_RELAY_SETTINGS;
This tag indicates the start of the DHCP relay settings.
- pool-group-name=name-of-the-pool-group;
This tag specifies the pool group name as a
ASCII string.
- subnet-prefix=IPv6-hex-address-format;
This tag specifies the IPv6 subnet prefix in the hexadecimal format. This must be the complete
address of the subnet.
- dest-dhcp-server-address=IPv6-hex-address-format;
This tag specifies the address of the DHCPv6 server to which the relay
forwards the client messages.
The DHCPv6 device-group-specific tags are as listed below:
- DHCP_DEVICE_GROUP;
This tag indicates the start of the DHCP device group settings.
- vendor-class-id=enterprise-number vendor-class-data-list;
This tag specifies the vendor-specific data, namely
enterprise-number
and
vendor-class-data-list.
enterprise-number
is mandatory and must be an integer.
vendor-class-data-list
can be represented in ASCII format
within double quotes.
vendor-class-data-list
can also be in the
binary format with each byte represented in the hexadecimal
format and separated by a colon (:).
- user-class-id=user-class-data-list;
This tag can be used to represent type or category of the user or client
application. The format for
user-class-data
is similar to that of
vendor-class-data.
NOTE: Either
vendor-class-id
or
user-class-id
can be specified at a time.
- Vn=vendor-options;
This tag can be used to specify vendor-specific configuration options,
where
n
specifies a unique integer.
Ensure that
V
is immediately followed by
n.
vendor-options
can be represented in the ASCII format within double quote or in the
binary format.
All the fields applicable to the
DHCP_POOL_GROUP
can be used under
the DHCPv6 device group except the
pool-group-name.
The DHCPv6 client-duid-group-specific tags are as listed below:
- DHCP_CLIENT_DUID_GROUP;
This tag indicates the start of the DHCP client duid group settings.
- client-duid=Hex-binary-format;
This tag specifies that the client duid can be represented in the hexadecimal
format with each
byte separated by a colon (:).
- addresses=List-of-IP-addresses-in-IPv6-Address-Format;
This tag specifies the list of addresses for the particular duid group.
All the fields applicable to the
DHCP_POOL_GROUP
can be used under
the DHCPv6 client duid group except the
address-pool-names.
The DHCPv6 relay-interface-mapping-specific tags are as listed below:
- RELAY_INTERFACE_MAPPINGS;
This tag indicates the start of the relay interface mappings.
The relay interface mapping maps the the relay's interface
identifier, which is an unique identifier in DHCP domain, to the subnet
address in which the client exists.
- Interface-ID->Subnet-address;
The Interface-ID is represented in the hexadecimal binary format with each
byte separated by a colon (:).
Subnet-address is represented in an
IPv6-hexadecimal format.
Example:
10:24:ab:cd -> 3ffe::/64;\\
ac:12:ff -> 3000::/64;
Printable version
