1 --- dhcp-0.10/dhcp6c.conf.5.man 2003-03-28 15:16:36.000000000 -0500
2 +++ dhcp-0.10/dhcp6c.conf.5 2007-02-08 15:44:07.000000000 -0500
6 -.\" Copyright (C) International Business Machines Corp., 2003
\r
7 -.\" All rights reserved.
\r
9 -.\" Redistribution and use in source and binary forms, with or without
\r
10 -.\" modification, are permitted provided that the following conditions
\r
12 -.\" 1. Redistributions of source code must retain the above copyright
\r
13 -.\" notice, this list of conditions and the following disclaimer.
\r
14 -.\" 2. Redistributions in binary form must reproduce the above copyright
\r
15 -.\" notice, this list of conditions and the following disclaimer in the
\r
16 -.\" documentation and/or other materials provided with the distribution.
\r
17 -.\" 3. Neither the name of the project nor the names of its contributors
\r
18 -.\" may be used to endorse or promote products derived from this software
\r
19 -.\" without specific prior written permission.
\r
21 -.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
\r
22 -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
\r
23 -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
\r
24 -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
\r
25 -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
\r
26 -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
\r
27 -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
\r
28 -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
\r
29 -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
\r
30 -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
\r
33 -.TH dhcp6c.conf 5 "17 March 2003" "dhcp6c.conf" "Linux System Manager's Manual"
\r
36 -dhcp6c.conf \- configuration file of the DHCPv6 client daemon, dhcp6c
\r
40 -is a configuration file for dhcp6c (DHCPv6 client).
\r
42 -dhcp6c is configured by the configuration information (such as rapid-commit,
\r
43 -requesting temp-address, or prefix-delegation) in this file.
\r
44 -dhcp6c.conf is an ASCII text file and lines that start with # are comments.
\r
50 -.B interface\ <interface\ name>
\r
52 -.B \t[declarations]
\r
55 -Write configurations for this interface in this statement.
\r
56 -In [declarations], options can be specified.
\r
62 -.B send\ [dhcpoptions];
\r
64 -With this declaration, dhcp6c sends specified options.
\r
65 -Currently rapid\-commit is defined.
\r
68 -\fIsend rapid\-commit;\fR
\r
70 -This declaration enables dhcp6c to request the dhcp6s server to perform a
\r
74 -.B request\ [dhcpoptions];
\r
76 -This declaration enables dhcp6c to request specified options.
\r
77 -Currently temp\-address, domain\-name\-servers, and prefix\-delegation
\r
81 -\fIrequest domain\-name\-servers;\fR
\r
83 -The DHCPv6 mechanism provides a way to obtain configuration information
\r
84 -such as a list of available DNS servers or NTP servers. This declaration
\r
85 -enables dhcp6c to request a DNS server address from the DHCPv6 server.
\r
88 -\fIrequest prefix\-delegation;\fR
\r
90 -This declaration enables dhcp6c to request a Prefix Delegation to the
\r
91 -DHCPv6 server. dhcp6c gets a prefix assignment from the DHCPv6 server.
\r
94 -\fIrequest temp\-address;\fR
\r
96 -This declaration enables dhcp6c to request temporary addresses.
\r
97 -dhcp6c requests Non-temporary Addresses as default. This option makes
\r
98 -dhcp6c request Temporary Addresses.
\r
101 -.B information-only;
\r
103 -This declaration enables dhcp6c to request host configuration information
\r
104 -from the DHCPv6 server. If dhcp6c doesn't need to be assigned any addresses,
\r
105 -this option should be specified.
\r
109 -.B \t[<ipv6\ address>/<prefix\ length>];
\r
110 -.B \t[prefer-life-time\ <preferred\-lifetime>];
\r
111 -.B \t[valid-life-time\ <valid\-lifetime>];
\r
114 -This declaration defines the dhcp6c client preferred IPv6 address,
\r
115 -the preferred lifetime of the address, and the valid lifetime for this
\r
120 -.B \t[<ipv6\ prefix>/<prefix\ length>];
\r
121 -.B \t[prefer-life-time\ <preferred\-lifetime>];
\r
122 -.B \t[valid-life-time\ <valid\-lifetime>];
\r
125 -This declaration defines the dhcp6c client acting as a requesting
\r
126 -router for the preferred prefix, the prefix length, and the prefix's
\r
127 -preferred lifetime, and valid lifetime for this interface.
\r
130 -.B prefer-life-time\ <preferred\-lifetime>;
\r
132 -This declaration sets the preferred lifetime (in seconds) of the address
\r
133 -or prefix. This declaration is valid only in address or prefix declarations.
\r
136 -.B valid-life-time\ <valid\-lifetime>;
\r
138 -This declaration sets the valid lifetime (in seconds) of the address or
\r
140 -This declaration is valid only in address or prefix declarations.
\r
143 -.B renew-time\ <renew-time>;
\r
145 -This declaration specifies the Renew Time (in seconds) for this Identity
\r
146 -Association (IA). Renew Time is a T1 value in an IA option. dhcp6c sets the
\r
147 -Renew Time in IA options to the specified value.
\r
150 -.B rebind-time\ <rebind-time>;
\r
152 -This declaration specifies the Rebind Time (in seconds) for this IA. Rebind
\r
153 -Time is T2 value in an IA option. dhcp6c sets the Rebind Time in IA options
\r
154 -to the specified value.
\r
162 -If this option is used in a "send [dhcpoptions];" declaration,
\r
163 -dhcp6c sends DHCPv6 messages with a Rapid Commit option.
\r
166 -.B domain\-name\-servers
\r
168 -If this option is used in a "request [dhcpoptions];" declaration,
\r
169 -dhcp6c requests the DNS server address via the DHCPv6 mechanism.
\r
172 -.B prefix\-delegation
\r
174 -If this option is used in a "request [dhcpoptions];" declaration,
\r
175 -dhcp6c requests a Prefix Delegation to the DHCPv6 servers.
\r
179 -This is a sample of the dhcp6c.conf file.
\r
181 -.B interface eth0 {
\r
182 -.B \tsend rapid-commit;
\r
183 -.B \trequest prefix-delegation;
\r
184 -.B \trequest domain-name-servers;
\r
185 -.B \trequest temp-address;
\r
188 -.B \t\t3ffe:10::10/64;
\r
189 -.B \t\tprefer-life-time 6000;
\r
190 -.B \t\tvalid-life-time 8000;
\r
192 -.B \trenew-time 11000;
\r
193 -.B \trebind-time 21000;
\r
198 -Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
\r
199 -for DHCPv6, dhcp6c(5)
\r
203 -Kazuo Hiekata <hiekata@yamato.ibm.com>
\r
208 +.\" Copyright (C) International Business Machines Corp., 2003
209 +.\" All rights reserved.
211 +.\" Redistribution and use in source and binary forms, with or without
212 +.\" modification, are permitted provided that the following conditions
214 +.\" 1. Redistributions of source code must retain the above copyright
215 +.\" notice, this list of conditions and the following disclaimer.
216 +.\" 2. Redistributions in binary form must reproduce the above copyright
217 +.\" notice, this list of conditions and the following disclaimer in the
218 +.\" documentation and/or other materials provided with the distribution.
219 +.\" 3. Neither the name of the project nor the names of its contributors
220 +.\" may be used to endorse or promote products derived from this software
221 +.\" without specific prior written permission.
223 +.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
224 +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
225 +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
226 +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
227 +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
228 +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
229 +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
230 +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
231 +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
232 +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
235 +.TH dhcp6c.conf 5 "17 March 2003" "dhcp6c.conf" "Linux System Manager's Manual"
238 +dhcp6c.conf \- configuration file of the DHCPv6 client daemon, dhcp6c
242 +is a configuration file for dhcp6c (DHCPv6 client).
244 +dhcp6c is configured by the configuration information (such as rapid-commit,
245 +requesting temp-address, or prefix-delegation) in this file.
246 +dhcp6c.conf is an ASCII text file and lines that start with # are comments.
252 +.B interface\ <interface\ name>
257 +Write configurations for this interface in this statement.
258 +In [declarations], options can be specified.
264 +.B send\ [dhcpoptions];
266 +With this declaration, dhcp6c sends specified options.
267 +Currently rapid\-commit is defined.
270 +\fIsend rapid\-commit;\fR
272 +This declaration enables dhcp6c to request the dhcp6s server to perform a
276 +.B request\ [dhcpoptions];
278 +This declaration enables dhcp6c to request specified options.
279 +Currently temp\-address, domain\-name\-servers, and prefix\-delegation
283 +\fIrequest domain\-name\-servers;\fR
285 +The DHCPv6 mechanism provides a way to obtain configuration information
286 +such as a list of available DNS servers or NTP servers. This declaration
287 +enables dhcp6c to request a DNS server address from the DHCPv6 server.
290 +\fIrequest prefix\-delegation;\fR
292 +This declaration enables dhcp6c to request a Prefix Delegation to the
293 +DHCPv6 server. dhcp6c gets a prefix assignment from the DHCPv6 server.
296 +\fIrequest temp\-address;\fR
298 +This declaration enables dhcp6c to request temporary addresses.
299 +dhcp6c requests Non-temporary Addresses as default. This option makes
300 +dhcp6c request Temporary Addresses.
303 +.B information-only;
305 +This declaration enables dhcp6c to request host configuration information
306 +from the DHCPv6 server. If dhcp6c doesn't need to be assigned any addresses,
307 +this option should be specified.
311 +.B \t[<ipv6\ address>/<prefix\ length>];
312 +.B \t[prefer-life-time\ <preferred\-lifetime>];
313 +.B \t[valid-life-time\ <valid\-lifetime>];
316 +This declaration defines the dhcp6c client preferred IPv6 address,
317 +the preferred lifetime of the address, and the valid lifetime for this
322 +.B \t[<ipv6\ prefix>/<prefix\ length>];
323 +.B \t[prefer-life-time\ <preferred\-lifetime>];
324 +.B \t[valid-life-time\ <valid\-lifetime>];
327 +This declaration defines the dhcp6c client acting as a requesting
328 +router for the preferred prefix, the prefix length, and the prefix's
329 +preferred lifetime, and valid lifetime for this interface.
332 +.B prefer-life-time\ <preferred\-lifetime>;
334 +This declaration sets the preferred lifetime (in seconds) of the address
335 +or prefix. This declaration is valid only in address or prefix declarations.
338 +.B valid-life-time\ <valid\-lifetime>;
340 +This declaration sets the valid lifetime (in seconds) of the address or
342 +This declaration is valid only in address or prefix declarations.
345 +.B renew-time\ <renew-time>;
347 +This declaration specifies the Renew Time (in seconds) for this Identity
348 +Association (IA). Renew Time is a T1 value in an IA option. dhcp6c sets the
349 +Renew Time in IA options to the specified value.
352 +.B rebind-time\ <rebind-time>;
354 +This declaration specifies the Rebind Time (in seconds) for this IA. Rebind
355 +Time is T2 value in an IA option. dhcp6c sets the Rebind Time in IA options
356 +to the specified value.
364 +If this option is used in a "send [dhcpoptions];" declaration,
365 +dhcp6c sends DHCPv6 messages with a Rapid Commit option.
368 +.B domain\-name\-servers
370 +If this option is used in a "request [dhcpoptions];" declaration,
371 +dhcp6c requests the DNS server address via the DHCPv6 mechanism.
374 +.B prefix\-delegation
376 +If this option is used in a "request [dhcpoptions];" declaration,
377 +dhcp6c requests a Prefix Delegation to the DHCPv6 servers.
380 +.B prefix\-delegation\-interface <interface name>
381 +Specifies the name of the interface definition in radvd.conf
382 +that dhcp6c will write the 'prefix' declaration for. By default,
383 +dhcp6c will write a radvd.conf prefix declaration for the interface
384 +on which it receives the prefix delegation lease.
387 +\fIuse-ra-prefix;\fR
389 +This declaration tells the client not to request the address prefix configured
390 +in the server's address or range statements. With this option, client address
391 +prefixes can be set only by router advertisements, and the prefix configured in
392 +server address or range statements will be ignored. This is a Red Hat extension;
393 +previously, the only way to set client address prefixes was by router advertisement.
397 +This is a sample of the dhcp6c.conf file.
400 +.B \tsend rapid-commit;
401 +.B \trequest prefix-delegation;
402 +.B \trequest domain-name-servers;
403 +.B \trequest temp-address;
406 +.B \t\t3ffe:10::10/64;
407 +.B \t\tprefer-life-time 6000;
408 +.B \t\tvalid-life-time 8000;
410 +.B \trenew-time 11000;
411 +.B \trebind-time 21000;
416 +Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
417 +for DHCPv6, dhcp6c(5)
421 +Kazuo Hiekata <hiekata@yamato.ibm.com>
424 --- dhcp-0.10/dhcp6s.conf.5.man 2003-05-28 18:56:23.000000000 -0400
425 +++ dhcp-0.10/dhcp6s.conf.5 2007-02-08 15:44:07.000000000 -0500
429 -.\" Copyright (C) International Business Machines Corp., 2003
\r
430 -.\" All rights reserved.
\r
432 -.\" Redistribution and use in source and binary forms, with or without
\r
433 -.\" modification, are permitted provided that the following conditions
\r
435 -.\" 1. Redistributions of source code must retain the above copyright
\r
436 -.\" notice, this list of conditions and the following disclaimer.
\r
437 -.\" 2. Redistributions in binary form must reproduce the above copyright
\r
438 -.\" notice, this list of conditions and the following disclaimer in the
\r
439 -.\" documentation and/or other materials provided with the distribution.
\r
440 -.\" 3. Neither the name of the project nor the names of its contributors
\r
441 -.\" may be used to endorse or promote products derived from this software
\r
442 -.\" without specific prior written permission.
\r
444 -.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
\r
445 -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
\r
446 -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
\r
447 -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
\r
448 -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
\r
449 -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
\r
450 -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
\r
451 -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
\r
452 -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
\r
453 -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
\r
456 -.TH dhcp6s.conf 5 "17 March 2003" "dhcp6s.conf" "Linux System Manager's Manual"
\r
459 -dhcp6s.conf \- configuration file of the DHCPv6 server daemon, dhcp6s
\r
464 +.\" Copyright (C) International Business Machines Corp., 2003
465 +.\" All rights reserved.
467 +.\" Redistribution and use in source and binary forms, with or without
468 +.\" modification, are permitted provided that the following conditions
470 +.\" 1. Redistributions of source code must retain the above copyright
471 +.\" notice, this list of conditions and the following disclaimer.
472 +.\" 2. Redistributions in binary form must reproduce the above copyright
473 +.\" notice, this list of conditions and the following disclaimer in the
474 +.\" documentation and/or other materials provided with the distribution.
475 +.\" 3. Neither the name of the project nor the names of its contributors
476 +.\" may be used to endorse or promote products derived from this software
477 +.\" without specific prior written permission.
479 +.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
480 +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
481 +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
482 +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
483 +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
484 +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
485 +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
486 +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
487 +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
488 +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
491 +.TH dhcp6s.conf 5 "17 March 2003" "dhcp6s.conf" "Linux System Manager's Manual"
494 +dhcp6s.conf \- configuration file of the DHCPv6 server daemon, dhcp6s
498 -contains the configuration information of addresses, prefixes, or
\r
499 -various network configuration parameters for each of the interfaces.
\r
500 -The network configuration parameters can be described globally for all of
\r
501 -the interfaces. The default address preferred life time is 36000 seconds;
\r
502 -the default address valid life time is 72000 seconds if they are not defined
\r
503 -in any declaration. The specific declaration order is interface, link, host;
\r
504 -within link the more specific declaration is pool.
\r
506 - The interface definitions are described in the following form:
\r
509 -.B \tinterface\ <interface\ name>
\r
511 -.B \t\t[declarations];
\r
514 - where each of the declarations could be of type link, group, or host.
\r
515 -Each declaration and the statements within each of these declarations
\r
516 -must be terminated by a semicolon. Additional details of the declarations
\r
517 -are specified below.
\r
523 -.B interface\ <interface\ name>
\r
525 -.B \t[declarations];
\r
528 -An interface declaration is used to inform the DHCPv6 server that the links and
\r
529 -hosts declared within it are connected to the same network segment. Common
\r
530 -network parameters for this network segment can be defined within the interface
\r
534 -.B link\ <link\ name>
\r
536 -.B \t[declarations];
\r
539 -A link declaration is used to provide the DHCPv6 server the IPv6 assgined
\r
540 -address ranges, prefixes, and hosts. Common network parameters for this link
\r
541 -can be defined within the link declaration.
\r
546 -.B \t[declarations];
\r
549 -A group declaration is used to group a list of declarations together to define
\r
550 -the common network parameters. These network parameters are valid within this
\r
551 -declaration only. Declarations can be one of the following types: interface, link,
\r
557 -.B \t[declarations];
\r
560 -The pool declaration is used to declare an address pool from which IPv6
\r
561 -address can be allocated, with its own permit to control client access
\r
562 -and its own declaration in which you can declare pool-specific network parameters.
\r
565 -.B host\ <host\ name>
\r
567 -.B \t[duid\ <DUID\n>];
\r
568 -.B \t[iaidinfo\ {}];
\r
569 -.B \t[address\ {}];
\r
570 -.B \t[prefix\ <prefix>/<prefix\ length>];
\r
571 -.B \t[declarations];
\r
574 -This declaration allows administrators to describe the addresses, prefixes, and
\r
575 -network configuration parameters for this host. As for this declaration, the
\r
576 -DHCP Unique Identifier (DUID), Identity Association Identifier (IAID), and
\r
577 -addresses must be specified. The host declaration is used to do Static
\r
578 -Address Assginment for a particular DHCPv6 client.
\r
583 -.B \t[<ipv6 address>/<prefix length>];
\r
584 -.B \t[prefer-life-time\ <preferred\ lifetime>];
\r
585 -.B \t[valid-life-time\ <valid\ lifetime>];
\r
588 -This statement allows administrators to specify the address for the
\r
589 -host. Preferred Lifetime and Valid Lifetime also can be set in this
\r
590 -statement. This statement is valid only in host {} declarations.
\r
593 -.B prefix\ <prefix>/<prefix\ length>;
\r
595 -This statement allows administrators to specify the prefix.
\r
596 -This parameter is needed when configuring dhcp6s as the Delegation Router for
\r
597 -the Prefix Delegation. dhcp6s assigns the specified prefixes
\r
598 -to the requesting routers.
\r
603 -.B \t[iaid\ <IAID\ number>];
\r
604 -.B \t[renew-time\ <renew\ time>];
\r
605 -.B \t[rebind-time\ <rebind\ time>];
\r
608 -This statement allows administrators to describe the information for
\r
609 -this IAID. This statement is only valid in host {} declarations.
\r
610 -iaid is required; renew-time and rebind time are optional in this statement.
\r
613 -.B range\ <ipv6\ address>\ to\ <ipv6\ address>/<prefix\ length>;
\r
615 -This statement allows adminstrators to use "range" and "to" keywords and
\r
616 -prefix length to specify an address range.
\r
617 -For each range not more than one of the unassigned addresses will be
\r
618 -assgined to the requested client.
\r
623 -DUID is a DHCP Unique Identifier for a DHCP participant. Using this option,
\r
624 -the administrator can specify the DUID of this DHCPv6 client.
\r
625 -The duid statement is valid only in host {} declarations.
\r
628 -.BI iaid\ <IAID\ number>;
\r
630 -IAID is a Identity Association Identifier. IA is a collection of addresses
\r
631 -assigned to a client. Using this option, the administrator can specify the IAID
\r
632 -in iaidinfo for a host declaration.
\r
635 -.BI renew-time\ <renew\ time>;
\r
637 -This statement allows administrators to specify the RenewTime (T1).
\r
638 -The recommended value for RenewTime is .5 times the shortest preferred
\r
639 -lifetime of the address in the IA, if the value is not defined.
\r
642 -.BI rebind-time\ <rebind\ time>;
\r
644 -This statement allows administrators to specify the RebindTime (T2).
\r
645 -The recommended value for RenewTime is .8 times the shortest preferred
\r
646 -lifetime of the address in the IA, if the value is not defined.
\r
649 -.BI prefer-life-time\ <preferred\ lifetime>;
\r
651 -This statement allows administrators to specify the Preferred Life Time for
\r
655 -.BI valid-life-time\ <valid\ lifetime>;
\r
657 -This statement allows administrators to specify the Valid Life Time for
\r
661 -.BI option\ dns_server\ <ipv6\ addresses\ or\ domain\ name\ list>;
\r
663 -This statement allows administrators to specify the DNS servers.
\r
665 -.B send\ <OPTION>;
\r
667 -This declaration enables dhcp6s to include the specified option in sending
\r
671 -\fIsend\ unicast;\fR
\r
673 -This declaration enables dhcp6s to send a Server Unicast option. Usually
\r
674 -DHCPv6 clients must use multicast addresses to contact the DHCPv6 server and
\r
675 -agents. This declaration specifies that dhcp6s will accept unicast messages
\r
676 -from DHCPv6 clients if they include a Server Unicast option.
\r
679 -\fIsend\ server-preference\ <server\ preference\ value>;\fR
\r
681 -This declaration enables dhcp6s to include a Preference option for sending
\r
682 -DHCPv6 messages. DHCPv6 clients will pick up the DHCPv6 server which has
\r
683 -highest preference value. The highest preference value is 255.
\r
686 -\fIsend\ temp-address;\fR
\r
688 -This declaration assigns a temporary address to the requesting client.
\r
691 -\fIsend\ information-only;\fR
\r
693 -This option enables dhcp6s to give only configuration information rather than
\r
694 -assigning client addresses. This could be, for example, DNS server address
\r
695 -configuration information.
\r
698 -.B allow\ <OPTION>;
\r
700 -This declaration allows the DHCPv6 client to specify an option in receiving
\r
704 -\fIallow rapid\-commit;\fR
\r
706 -This option enables dhcp6s to allow the Rapid-Commit option from the DHCPv6
\r
707 -client and the Solicit-Reply message exchanges.
\r
710 -\fIallow\ unicast;\fR
\r
712 -This option enables dhcp6s to allow the Server Unicast option for the DHCPv6
\r
713 -client. Usually DHCPv6 clients must use multicast addresses to contact DHCPv6
\r
714 -server and agents. With this declaration, dhcp6s accepts unicast
\r
715 -messages from DHCPv6 clients if they include a Server Unicast option.
\r
719 -This is a sample of the dhcp6s.conf file.
\r
721 -.B option dns\_server 2003::6:1 ibm.com;
\r
722 -.B prefer\-life\-time 10000;
\r
723 -.B valid\-life\-time 20000;
\r
724 -.B renew\-time 5000;
\r
725 -.B rebind\-time 8000;
\r
726 -.B interface eth1 {
\r
728 -.B \t\tallow unicast;
\r
729 -.B \t\tsend unicast;
\r
730 -.B \t\tallow rapid-commit;
\r
731 -.B \t\tsend server-preference 5;
\r
732 -.B \t\trenew-time 1000;
\r
733 -.B \t\trebind-time 2400;
\r
734 -.B \t\tprefer-life-time 2000;
\r
735 -.B \t\tvalid-life-time 3000;
\r
736 -.B \t\trange 3ffe:ffff:100::10 to 3ffe:ffff:100::110/64;
\r
737 -.B \t\tprefix 3ffe:ffef:104::/64;
\r
739 -.B \t\t\tprefer\-life\-time 3600;
\r
740 -.B \t\t\tvalid\-life\-time 7200;
\r
741 -.B \t\t\trange fec0:ffff::10 to fec0:ffff::110/64;
\r
742 -.B \t\t\tprefix fec0:fffe::/48;
\r
746 -.B \t\tduid 00:00:00:00:a0:a0;
\r
748 -.B \t\t\tiaid 101010;
\r
749 -.B \t\t\trenew-time 1000;
\r
750 -.B \t\t\trebind-time 2000;
\r
753 -.B \t\t\t3ffe:ffff:102::120/64;
\r
754 -.B \t\t\tprefer-life-time 2000;
\r
755 -.B \t\t\tvalid-life-time 3000;
\r
759 -.B \t\tprefer\-life\-time 5000;
\r
760 -.B \t\tvalid\-life\-time 6000;
\r
761 -.B \t\thost host1 {
\r
762 -.B \t\t\tduid 00:00:00:00:a1:a1;
\r
763 -.B \t\t\tiaidinfo {
\r
764 -.B \t\t\t\tiaid 101011;
\r
765 -.B \t\t\t\trenew-time 1000;
\r
766 -.B \t\t\t\trebind-time 2000;
\r
769 -.B \t\thost host2 {
\r
770 -.B \t\t\tduid 00:00:00:00:a2:a2;
\r
771 -.B \t\t\tsend information-only;
\r
778 -Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
\r
779 -for DHCPv6, dhcp6s(5)
\r
783 -Kazuo Hiekata <hiekata@yamato.ibm.com>
\r
784 +contains the configuration information of addresses, prefixes, or
785 +various network configuration parameters for each of the interfaces.
786 +The network configuration parameters can be described globally for all of
787 +the interfaces. The default address preferred life time is 36000 seconds;
788 +the default address valid life time is 72000 seconds if they are not defined
789 +in any declaration. The specific declaration order is interface, link, host;
790 +within link the more specific declaration is pool.
792 + The interface definitions are described in the following form:
795 +.B \tinterface\ <interface\ name>
797 +.B \t\t[declarations];
800 + where each of the declarations could be of type link, group, or host.
801 +Each declaration and the statements within each of these declarations
802 +must be terminated by a semicolon. Additional details of the declarations
803 +are specified below.
809 +.B interface\ <interface\ name>
811 +.B \t[declarations];
814 +An interface declaration is used to inform the DHCPv6 server that the links and
815 +hosts declared within it are connected to the same network segment. Common
816 +network parameters for this network segment can be defined within the interface
820 +.B link\ <link\ name>
822 +.B \t[declarations];
825 +A link declaration is used to provide the DHCPv6 server the IPv6 assgined
826 +address ranges, prefixes, and hosts. Common network parameters for this link
827 +can be defined within the link declaration.
832 +.B \t[declarations];
835 +A group declaration is used to group a list of declarations together to define
836 +the common network parameters. These network parameters are valid within this
837 +declaration only. Declarations can be one of the following types: interface, link,
843 +.B \t[declarations];
846 +The pool declaration is used to declare an address pool from which IPv6
847 +address can be allocated, with its own permit to control client access
848 +and its own declaration in which you can declare pool-specific network parameters.
851 +.B host\ <host\ name>
853 +.B \t[duid\ <DUID\n>];
854 +.B \t[iaidinfo\ {}];
856 +.B \t[prefix\ <prefix>/<prefix\ length>];
857 +.B \t[declarations];
860 +This declaration allows administrators to describe the addresses, prefixes, and
861 +network configuration parameters for this host. As for this declaration, the
862 +DHCP Unique Identifier (DUID), Identity Association Identifier (IAID), and
863 +addresses must be specified. The host declaration is used to do Static
864 +Address Assginment for a particular DHCPv6 client.
869 +.B \t[<ipv6 address>/<prefix length>];
870 +.B \t[prefer-life-time\ <preferred\ lifetime>];
871 +.B \t[valid-life-time\ <valid\ lifetime>];
874 +This statement allows administrators to specify the address for the
875 +host. Preferred Lifetime and Valid Lifetime also can be set in this
876 +statement. This statement is valid only in host {} declarations.
879 +.B prefix\ <prefix>/<prefix\ length>;
881 +This statement allows administrators to specify the prefix.
882 +This parameter is needed when configuring dhcp6s as the Delegation Router for
883 +the Prefix Delegation. dhcp6s assigns the specified prefixes
884 +to the requesting routers.
887 +.B relay\ <relay>/<prefix\ length>;
889 +This statement specifies the prefix that the relay agent will put in the link
890 +address field of the RELAY-FORW message to indicate the link the client is
891 +attached to. If the link-address matches this prefix, this link declaration
892 +will be used. This statement is only valid in the link declaration.
897 +.B \t[iaid\ <IAID\ number>];
898 +.B \t[renew-time\ <renew\ time>];
899 +.B \t[rebind-time\ <rebind\ time>];
902 +This statement allows administrators to describe the information for
903 +this IAID. This statement is only valid in host {} declarations.
904 +iaid is required; renew-time and rebind time are optional in this statement.
907 +.B range\ <ipv6\ address>\ to\ <ipv6\ address>/<prefix\ length>;
909 +This statement allows adminstrators to use "range" and "to" keywords and
910 +prefix length to specify an address range.
911 +For each range not more than one of the unassigned addresses will be
912 +assgined to the requested client.
917 +DUID is a DHCP Unique Identifier for a DHCP participant. Using this option,
918 +the administrator can specify the DUID of this DHCPv6 client.
919 +The duid statement is valid only in host {} declarations.
922 +.BI iaid\ <IAID\ number>;
924 +IAID is a Identity Association Identifier. IA is a collection of addresses
925 +assigned to a client. Using this option, the administrator can specify the IAID
926 +in iaidinfo for a host declaration.
929 +.BI renew-time\ <renew\ time>;
931 +This statement allows administrators to specify the RenewTime (T1).
932 +The recommended value for RenewTime is .5 times the shortest preferred
933 +lifetime of the address in the IA, if the value is not defined.
936 +.BI rebind-time\ <rebind\ time>;
938 +This statement allows administrators to specify the RebindTime (T2).
939 +The recommended value for RenewTime is .8 times the shortest preferred
940 +lifetime of the address in the IA, if the value is not defined.
943 +.BI prefer-life-time\ <preferred\ lifetime>;
945 +This statement allows administrators to specify the Preferred Life Time for
949 +.BI valid-life-time\ <valid\ lifetime>;
951 +This statement allows administrators to specify the Valid Life Time for
955 +.BI option\ dns_server\ <ipv6\ addresses\ or\ domain\ name\ list>;
957 +This statement allows administrators to specify the DNS servers.
961 +This declaration enables dhcp6s to include the specified option in sending
965 +\fIsend\ unicast;\fR
967 +This declaration enables dhcp6s to send a Server Unicast option. Usually
968 +DHCPv6 clients must use multicast addresses to contact the DHCPv6 server and
969 +agents. This declaration specifies that dhcp6s will accept unicast messages
970 +from DHCPv6 clients if they include a Server Unicast option.
973 +\fIserver-preference\ <server\ preference\ value>;\fR
975 +This declaration enables dhcp6s to include a Preference option for sending
976 +DHCPv6 messages. DHCPv6 clients will pick up the DHCPv6 server which has
977 +highest preference value. The highest preference value is 255.
980 +\fIsend\ temp-address;\fR
982 +This declaration assigns a temporary address to the requesting client.
985 +\fIsend\ information-only;\fR
987 +This option enables dhcp6s to give only configuration information rather than
988 +assigning client addresses. This could be, for example, DNS server address
989 +configuration information.
994 +This declaration allows the DHCPv6 client to specify an option in receiving
998 +\fIallow rapid\-commit;\fR
1000 +This option enables dhcp6s to allow the Rapid-Commit option from the DHCPv6
1001 +client and the Solicit-Reply message exchanges.
1004 +\fIallow\ unicast;\fR
1006 +This option enables dhcp6s to allow the Server Unicast option for the DHCPv6
1007 +client. Usually DHCPv6 clients must use multicast addresses to contact DHCPv6
1008 +server and agents. With this declaration, dhcp6s accepts unicast
1009 +messages from DHCPv6 clients if they include a Server Unicast option.
1013 +\fIuse-ra-prefix;\fR
1015 +This declaration tells the server not to send clients the address prefix configured
1016 +in address or range statements. With this option, client address prefixes can
1017 +be set only by router advertisements, and the prefix configured in address or
1018 +range statements will be ignored. This is a Red Hat extension; previously, the
1019 +only way to set client address prefixes was by router advertisement.
1023 +This is a sample of the dhcp6s.conf file.
1025 +.B option dns\_server 2003::6:1 ibm.com;
1026 +.B prefer\-life\-time 10000;
1027 +.B valid\-life\-time 20000;
1028 +.B renew\-time 5000;
1029 +.B rebind\-time 8000;
1030 +.B interface eth1 {
1032 +.B \t\tallow unicast;
1033 +.B \t\tsend unicast;
1034 +.B \t\tallow rapid-commit;
1035 +.B \t\tserver-preference 5;
1036 +.B \t\trenew-time 1000;
1037 +.B \t\trebind-time 2400;
1038 +.B \t\tprefer-life-time 2000;
1039 +.B \t\tvalid-life-time 3000;
1040 +.B \t\trange 3ffe:ffff:100::10 to 3ffe:ffff:100::110/64;
1041 +.B \t\tprefix 3ffe:ffef:104::/64;
1043 +.B \t\t\tprefer\-life\-time 3600;
1044 +.B \t\t\tvalid\-life\-time 7200;
1045 +.B \t\t\trange fec0:ffff::10 to fec0:ffff::110/64;
1046 +.B \t\t\tprefix fec0:fffe::/48;
1050 +.B \t\tduid 00:00:00:00:a0:a0;
1052 +.B \t\t\tiaid 101010;
1053 +.B \t\t\trenew-time 1000;
1054 +.B \t\t\trebind-time 2000;
1057 +.B \t\t\t3ffe:ffff:102::120/64;
1058 +.B \t\t\tprefer-life-time 2000;
1059 +.B \t\t\tvalid-life-time 3000;
1063 +.B \t\tprefer\-life\-time 5000;
1064 +.B \t\tvalid\-life\-time 6000;
1065 +.B \t\thost host1 {
1066 +.B \t\t\tduid 00:00:00:00:a1:a1;
1067 +.B \t\t\tiaidinfo {
1068 +.B \t\t\t\tiaid 101011;
1069 +.B \t\t\t\trenew-time 1000;
1070 +.B \t\t\t\trebind-time 2000;
1073 +.B \t\thost host2 {
1074 +.B \t\t\tduid 00:00:00:00:a2:a2;
1075 +.B \t\t\tsend information-only;
1082 +Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
1083 +for DHCPv6, dhcp6s(5)
1087 +Kazuo Hiekata <hiekata@yamato.ibm.com>