1dhcp6s.conf(5) Linux System Manager's Manual dhcp6s.conf(5)
2
6 dhcp6s.conf - configuration file of the DHCPv6 server daemon, dhcp6s
7
10 dhcp6s.conf contains the configuration information of addresses, pre‐
11 fixes, or various network configuration parameters for each of the
12 interfaces. The network configuration parameters can be described
13 globally for all of the interfaces. The default address preferred life
14 time is 36000 seconds; the default address valid life time is 72000
15 seconds if they are not defined in any declaration. The specific decla‐
16 ration order is interface, link, host; within link the more specific
17 declaration is pool.
18 The interface definitions are described in the following form:
20 interface <interface name>
22 {
23 [declarations];
24 };
25 where each of the declarations could be of type link, group, or host.
26 Each declaration and the statements within each of these declarations
27 must be terminated by a semicolon. Additional details of the declara‐
28 tions are specified below.
29 DECLARATIONS
32 interface <interface name>
34 {
35 [declarations];
36 };
37 An interface declaration is used to inform the DHCPv6 server that the
38 links and hosts declared within it are connected to the same network
39 segment. Common network parameters for this network segment can be
40 defined within the interface declaration.
41 link <link name>
43 {
44 [declarations];
45 };
46 A link declaration is used to provide the DHCPv6 server the IPv6 ass‐
47 gined address ranges, prefixes, and hosts. Common network parameters
48 for this link can be defined within the link declaration.
49 group
51 {
52 [declarations];
53 };
54 A group declaration is used to group a list of declarations together to
55 define the common network parameters. These network parameters are
56 valid within this declaration only. Declarations can be one of the fol‐
57 lowing types: interface, link, pool, or host.
58 pool
60 {
61 [declarations];
62 };
63 The pool declaration is used to declare an address pool from which IPv6
64 address can be allocated, with its own permit to control client access
65 and its own declaration in which you can declare pool-specific network
66 parameters.
67 host <host name>
69 {
70 [duid <DUID0];
71 [iaidinfo {}];
72 [address {}];
73 [prefix <prefix>/<prefix length>];
74 [declarations];
75 };
76 This declaration allows administrators to describe the addresses, pre‐
77 fixes, and network configuration parameters for this host. As for this
78 declaration, the DHCP Unique Identifier (DUID), Identity Association
79 Identifier (IAID), and addresses must be specified. The host declara‐
80 tion is used to do Static Address Assginment for a particular DHCPv6
81 client.
82 address
84 {
85 [<ipv6 address>/<prefix length>];
86 [prefer-life-time <preferred lifetime>];
87 [valid-life-time <valid lifetime>];
88 };
89 This statement allows administrators to specify the address for the
90 host. Preferred Lifetime and Valid Lifetime also can be set in this
91 statement. This statement is valid only in host {} declarations.
92 prefix <prefix>/<prefix length>;
94 This statement allows administrators to specify the prefix. This
95 parameter is needed when configuring dhcp6s as the Delegation Router
96 for the Prefix Delegation. dhcp6s assigns the specified prefixes to the
97 requesting routers.
98 relay <relay>/<prefix length>;
100 This statement specifies the prefix that the relay agent will put in
101 the link address field of the RELAY-FORW message to indicate the link
102 the client is attached to. If the link-address matches this prefix,
103 this link declaration will be used. This statement is only valid in the
104 link declaration.
105 iaidinfo
107 {
108 [iaid <IAID number>];
109 [renew-time <renew time>];
110 [rebind-time <rebind time>];
111 };
112 This statement allows administrators to describe the information for
113 this IAID. This statement is only valid in host {} declarations. iaid
114 is required; renew-time and rebind time are optional in this statement.
115 range <ipv6 address> to <ipv6 address>/<prefix length>;
117 This statement allows adminstrators to use "range" and "to" keywords
118 and prefix length to specify an address range. For each range not more
119 than one of the unassigned addresses will be assgined to the requested
120 client.
121 duid <DUID>;
123 DUID is a DHCP Unique Identifier for a DHCP participant. Using this
124 option, the administrator can specify the DUID of this DHCPv6 client.
125 The duid statement is valid only in host {} declarations.
126 iaid <IAID number>;
128 IAID is a Identity Association Identifier. IA is a collection of
129 addresses assigned to a client. Using this option, the administrator
130 can specify the IAID in iaidinfo for a host declaration.
131 renew-time <renew time>;
133 This statement allows administrators to specify the RenewTime (T1).
134 The recommended value for RenewTime is .5 times the shortest preferred
135 lifetime of the address in the IA, if the value is not defined.
136 rebind-time <rebind time>;
138 This statement allows administrators to specify the RebindTime (T2).
139 The recommended value for RenewTime is .8 times the shortest preferred
140 lifetime of the address in the IA, if the value is not defined.
141 prefer-life-time <preferred lifetime>;
143 This statement allows administrators to specify the Preferred Life Time
144 for each address.
145 valid-life-time <valid lifetime>;
147 This statement allows administrators to specify the Valid Life Time for
148 each address.
149 option dns_server <ipv6 addresses or domain name list>;
151 This statement allows administrators to specify the DNS servers.
152 send <OPTION>;
154 This declaration enables dhcp6s to include the specified option in
155 sending DHCPv6 messages.
156 send unicast;
158 This declaration enables dhcp6s to send a Server Unicast option. Usu‐
159 ally DHCPv6 clients must use multicast addresses to contact the DHCPv6
160 server and agents. This declaration specifies that dhcp6s will accept
161 unicast messages from DHCPv6 clients if they include a Server Unicast
162 option.
163 server-preference <server preference value>;
165 This declaration enables dhcp6s to include a Preference option for
166 sending DHCPv6 messages. DHCPv6 clients will pick up the DHCPv6 server
167 which has highest preference value. The highest preference value is
168 255.
169 send temp-address;
171 This declaration assigns a temporary address to the requesting client.
172 send information-only;
174 This option enables dhcp6s to give only configuration information
175 rather than assigning client addresses. This could be, for example, DNS
176 server address configuration information.
177 allow <OPTION>;
179 This declaration allows the DHCPv6 client to specify an option in
180 receiving DHCPv6 messages.
181 allow rapid-commit;
183 This option enables dhcp6s to allow the Rapid-Commit option from the
184 DHCPv6 client and the Solicit-Reply message exchanges.
185 allow unicast;
187 This option enables dhcp6s to allow the Server Unicast option for the
188 DHCPv6 client. Usually DHCPv6 clients must use multicast addresses to
189 contact DHCPv6 server and agents. With this declaration, dhcp6s accepts
190 unicast messages from DHCPv6 clients if they include a Server Unicast
191 option.
192 use-ra-prefix;
195 This declaration tells the server not to send clients the address pre‐
196 fix configured in address or range statements. With this option, client
197 address prefixes can be set only by router advertisements, and the pre‐
198 fix configured in address or range statements will be ignored. This is
199 a Red Hat extension; previously, the only way to set client address
200 prefixes was by router advertisement.
201
204 This is a sample of the dhcp6s.conf file.
205 option dns_server 2003::6:1 ibm.com;
206 prefer-life-time 10000;
207 valid-life-time 20000;
208 renew-time 5000;
209 rebind-time 8000;
210 interface eth1 {
211 link AAA {
212 allow unicast;
213 send unicast;
214 allow rapid-commit;
215 server-preference 5;
216 renew-time 1000;
217 rebind-time 2400;
218 prefer-life-time 2000;
219 valid-life-time 3000;
220 range 3ffe:ffff:100::10 to 3ffe:ffff:100::110/64;
221 prefix 3ffe:ffef:104::/64;
222 pool {
223 prefer-life-time 3600;
224 valid-life-time 7200;
225 range fec0:ffff::10 to fec0:ffff::110/64;
226 prefix fec0:fffe::/48;
227 };
228 };
229 host host0 {
230 duid 00:00:00:00:a0:a0;
231 iaidinfo {
232 iaid 101010;
233 renew-time 1000;
234 rebind-time 2000;
235 };
236 address {
237 3ffe:ffff:102::120/64;
238 prefer-life-time 2000;
239 valid-life-time 3000;
240 };
241 };
242 group {
243 prefer-life-time 5000;
244 valid-life-time 6000;
245 host host1 {
246 duid 00:00:00:00:a1:a1;
247 iaidinfo {
248 iaid 101011;
249 renew-time 1000;
250 rebind-time 2000;
251 };
252 };
253 host host2 {
254 duid 00:00:00:00:a2:a2;
255 send information-only;
256 };
257 };
258 };
259
262 Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix
263 Options for DHCPv6, dhcp6s(5)
264
267 Kazuo Hiekata <hiekata@yamato.ibm.com>
268dhcp6s.conf 17 March 2003 dhcp6s.conf(5)