]> git.pld-linux.org Git - packages/dhcpv6.git/blob - dhcpv6-man.patch
- pl for libdhcp6client*
[packages/dhcpv6.git] / dhcpv6-man.patch
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
3 @@ -1,202 +1,218 @@
4 -.\" $Id$\r
5 -.\"\r
6 -.\" Copyright (C) International Business Machines  Corp., 2003\r
7 -.\" All rights reserved.\r
8 -.\"\r
9 -.\" Redistribution and use in source and binary forms, with or without\r
10 -.\" modification, are permitted provided that the following conditions\r
11 -.\" are met:\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
20 -.\"\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
31 -.\" SUCH DAMAGE.\r
32 -.\"\r
33 -.TH dhcp6c.conf 5 "17 March 2003" "dhcp6c.conf" "Linux System Manager's Manual"\r
34 -\r
35 -.SH NAME\r
36 -dhcp6c.conf \- configuration file of the DHCPv6 client daemon, dhcp6c\r
37 -\r
38 -.SH DESCRIPTION\r
39 -.B dhcp6c.conf\r
40 -is a configuration file for dhcp6c (DHCPv6 client).\r
41 -\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
45 -\r
46 -.PP\r
47 -.BI STATEMENTS\r
48 -.PP\r
49 -.nf\r
50 -.B interface\ <interface\ name>\r
51 -.B {\r
52 -.B \t[declarations]\r
53 -.B };\r
54 -.fi\r
55 -Write configurations for this interface in this statement.\r
56 -In [declarations], options can be specified.\r
57 -\r
58 -.PP\r
59 -.BI DECLARATIONS\r
60 -.PP\r
61 -.nf\r
62 -.B send\ [dhcpoptions];\r
63 -.fi\r
64 -With this declaration, dhcp6c sends specified options.\r
65 -Currently rapid\-commit is defined.\r
66 -\r
67 -.nf\r
68 -\fIsend rapid\-commit;\fR\r
69 -.fi\r
70 -This declaration enables dhcp6c to request the dhcp6s server to perform a\r
71 -Rapid Commit.\r
72 -\r
73 -.nf\r
74 -.B request\ [dhcpoptions];\r
75 -.fi\r
76 -This declaration enables dhcp6c to request specified options.\r
77 -Currently temp\-address, domain\-name\-servers, and prefix\-delegation\r
78 -are defined.\r
79 -\r
80 -.nf\r
81 -\fIrequest domain\-name\-servers;\fR\r
82 -.fi\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
86 -\r
87 -.nf\r
88 -\fIrequest prefix\-delegation;\fR\r
89 -.fi\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
92 -\r
93 -.nf\r
94 -\fIrequest temp\-address;\fR\r
95 -.fi\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
99 -\r
100 -.nf\r
101 -.B information-only;\r
102 -.fi\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
106 -\r
107 -.nf\r
108 -.B address\ {\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
112 -.B };\r
113 -.fi\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
116 -interface.\r
117 -\r
118 -.nf\r
119 -.B prefix\ {\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
123 -.B };\r
124 -.fi\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
128 -\r
129 -.nf\r
130 -.B prefer-life-time\ <preferred\-lifetime>;\r
131 -.fi\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
134 -\r
135 -.nf\r
136 -.B valid-life-time\ <valid\-lifetime>;\r
137 -.fi\r
138 -This declaration sets the valid lifetime (in seconds) of the address or\r
139 -prefix.\r
140 -This declaration is valid only in address or prefix declarations.\r
141 -\r
142 -.nf\r
143 -.B renew-time\ <renew-time>;\r
144 -.fi\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
148 -\r
149 -.nf\r
150 -.B rebind-time\ <rebind-time>;\r
151 -.fi\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
155 -\r
156 -.PP
157 -.BI DHCPOPTIONS\r
158 -.PP\r
159 -.nf\r
160 -.B rapid\-commit\r
161 -.fi\r
162 -If this option is used in a "send [dhcpoptions];" declaration, \r
163 -dhcp6c sends DHCPv6 messages with a Rapid Commit option.\r
164 -\r
165 -.nf\r
166 -.B domain\-name\-servers\r
167 -.fi\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
170 -\r
171 -.nf\r
172 -.B prefix\-delegation\r
173 -.fi\r
174 -If this option is used in a "request [dhcpoptions];" declaration, \r
175 -dhcp6c requests a Prefix Delegation to the DHCPv6 servers.\r
176 -\r
177 -.SH EXAMPLES\r
178 -.PP\r
179 -This is a sample of the dhcp6c.conf file.\r
180 -.nf\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
186 -.B \tiaid 11111;\r
187 -.B \taddress {\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
191 -.B \t};\r
192 -.B \trenew-time 11000;\r
193 -.B \trebind-time 21000;\r
194 -.B };\r
195 -.fi\r
196 -\r
197 -.SH SEE ALSO\r
198 -Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options\r
199 -for DHCPv6, dhcp6c(5)\r
200 -\r
201 -.SH AUTHORS\r
202 -.LP\r
203 -Kazuo Hiekata <hiekata@yamato.ibm.com>\r
204 -\r
205 -\r
206 +.\" $Id$
207 +.\"
208 +.\" Copyright (C) International Business Machines  Corp., 2003
209 +.\" All rights reserved.
210 +.\"
211 +.\" Redistribution and use in source and binary forms, with or without
212 +.\" modification, are permitted provided that the following conditions
213 +.\" are met:
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.
222 +.\"
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
233 +.\" SUCH DAMAGE.
234 +.\"
235 +.TH dhcp6c.conf 5 "17 March 2003" "dhcp6c.conf" "Linux System Manager's Manual"
236 +
237 +.SH NAME
238 +dhcp6c.conf \- configuration file of the DHCPv6 client daemon, dhcp6c
239 +
240 +.SH DESCRIPTION
241 +.B dhcp6c.conf
242 +is a configuration file for dhcp6c (DHCPv6 client).
243 +
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.
247 +
248 +.PP
249 +.BI STATEMENTS
250 +.PP
251 +.nf
252 +.B interface\ <interface\ name>
253 +.B {
254 +.B \t[declarations]
255 +.B };
256 +.fi
257 +Write configurations for this interface in this statement.
258 +In [declarations], options can be specified.
259 +
260 +.PP
261 +.BI DECLARATIONS
262 +.PP
263 +.nf
264 +.B send\ [dhcpoptions];
265 +.fi
266 +With this declaration, dhcp6c sends specified options.
267 +Currently rapid\-commit is defined.
268 +
269 +.nf
270 +\fIsend rapid\-commit;\fR
271 +.fi
272 +This declaration enables dhcp6c to request the dhcp6s server to perform a
273 +Rapid Commit.
274 +
275 +.nf
276 +.B request\ [dhcpoptions];
277 +.fi
278 +This declaration enables dhcp6c to request specified options.
279 +Currently temp\-address, domain\-name\-servers, and prefix\-delegation
280 +are defined.
281 +
282 +.nf
283 +\fIrequest domain\-name\-servers;\fR
284 +.fi
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. 
288 +
289 +.nf
290 +\fIrequest prefix\-delegation;\fR
291 +.fi
292 +This declaration enables dhcp6c to request a Prefix Delegation to the 
293 +DHCPv6 server. dhcp6c gets a prefix assignment from the DHCPv6 server.
294 +
295 +.nf
296 +\fIrequest temp\-address;\fR
297 +.fi
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.
301 +
302 +.nf
303 +.B information-only;
304 +.fi
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.
308 +
309 +.nf
310 +.B address\ {
311 +.B \t[<ipv6\ address>/<prefix\ length>];
312 +.B \t[prefer-life-time\ <preferred\-lifetime>];
313 +.B \t[valid-life-time\ <valid\-lifetime>];
314 +.B };
315 +.fi
316 +This declaration defines the dhcp6c client preferred IPv6 address,
317 +the preferred lifetime of the address, and the valid lifetime for this
318 +interface.
319 +
320 +.nf
321 +.B prefix\ {
322 +.B \t[<ipv6\ prefix>/<prefix\ length>];
323 +.B \t[prefer-life-time\ <preferred\-lifetime>];
324 +.B \t[valid-life-time\ <valid\-lifetime>];
325 +.B };
326 +.fi
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.
330 +
331 +.nf
332 +.B prefer-life-time\ <preferred\-lifetime>;
333 +.fi
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.
336 +
337 +.nf
338 +.B valid-life-time\ <valid\-lifetime>;
339 +.fi
340 +This declaration sets the valid lifetime (in seconds) of the address or
341 +prefix.
342 +This declaration is valid only in address or prefix declarations.
343 +
344 +.nf
345 +.B renew-time\ <renew-time>;
346 +.fi
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.
350 +
351 +.nf
352 +.B rebind-time\ <rebind-time>;
353 +.fi
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.
357 +
358 +.PP
359 +.BI DHCPOPTIONS
360 +.PP
361 +.nf
362 +.B rapid\-commit
363 +.fi
364 +If this option is used in a "send [dhcpoptions];" declaration, 
365 +dhcp6c sends DHCPv6 messages with a Rapid Commit option.
366 +
367 +.nf
368 +.B domain\-name\-servers
369 +.fi
370 +If this option is used in a "request [dhcpoptions];" declaration, 
371 +dhcp6c requests the DNS server address via the DHCPv6 mechanism.
372 +
373 +.nf
374 +.B prefix\-delegation
375 +.fi
376 +If this option is used in a "request [dhcpoptions];" declaration, 
377 +dhcp6c requests a Prefix Delegation to the DHCPv6 servers.
378 +
379 +.nf
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.
385 +
386 +.nf
387 +\fIuse-ra-prefix;\fR
388 +.fi
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.
394 +
395 +.SH EXAMPLES
396 +.PP
397 +This is a sample of the dhcp6c.conf file.
398 +.nf
399 +.B interface eth0 {
400 +.B \tsend rapid-commit;
401 +.B \trequest prefix-delegation;
402 +.B \trequest domain-name-servers;
403 +.B \trequest temp-address;
404 +.B \tiaid 11111;
405 +.B \taddress {
406 +.B \t\t3ffe:10::10/64;
407 +.B \t\tprefer-life-time 6000;
408 +.B \t\tvalid-life-time 8000;
409 +.B \t};
410 +.B \trenew-time 11000;
411 +.B \trebind-time 21000;
412 +.B };
413 +.fi
414 +
415 +.SH SEE ALSO
416 +Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
417 +for DHCPv6, dhcp6c(5)
418 +
419 +.SH AUTHORS
420 +.LP
421 +Kazuo Hiekata <hiekata@yamato.ibm.com>
422 +
423 +
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
426 @@ -1,322 +1,340 @@
427 -.\" $Id$\r
428 -.\"\r
429 -.\" Copyright (C) International Business Machines  Corp., 2003\r
430 -.\" All rights reserved.\r
431 -.\"\r
432 -.\" Redistribution and use in source and binary forms, with or without\r
433 -.\" modification, are permitted provided that the following conditions\r
434 -.\" are met:\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
443 -.\"\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
454 -.\" SUCH DAMAGE.\r
455 -.\"\r
456 -.TH dhcp6s.conf 5 "17 March 2003" "dhcp6s.conf" "Linux System Manager's Manual"\r
457 -\r
458 -.SH NAME\r
459 -dhcp6s.conf \- configuration file of the DHCPv6 server daemon, dhcp6s\r
460 -\r
461 -.SH DESCRIPTION\r
462 +.\" $Id$
463 +.\"
464 +.\" Copyright (C) International Business Machines  Corp., 2003
465 +.\" All rights reserved.
466 +.\"
467 +.\" Redistribution and use in source and binary forms, with or without
468 +.\" modification, are permitted provided that the following conditions
469 +.\" are met:
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.
478 +.\"
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
489 +.\" SUCH DAMAGE.
490 +.\"
491 +.TH dhcp6s.conf 5 "17 March 2003" "dhcp6s.conf" "Linux System Manager's Manual"
492 +
493 +.SH NAME
494 +dhcp6s.conf \- configuration file of the DHCPv6 server daemon, dhcp6s
495 +
496 +.SH DESCRIPTION
497  .B dhcp6s.conf
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
505 -\r
506 - The interface definitions are described in the following form:\r
507 -.PP\r
508 -.nf\r
509 -.B \tinterface\ <interface\ name>\r
510 -.B \t{\r
511 -.B \t\t[declarations];\r
512 -.B \t};\r
513 -.fi\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
518 -\r
519 -.PP\r
520 -.BI DECLARATIONS\r
521 -.PP\r
522 -.nf\r
523 -.B interface\ <interface\ name>\r
524 -.B {\r
525 -.B \t[declarations];\r
526 -.B };\r
527 -.fi\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
531 -declaration.\r
532 -\r
533 -.nf\r
534 -.B link\ <link\ name>\r
535 -.B {\r
536 -.B \t[declarations];\r
537 -.B };\r
538 -.fi\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
542 -\r
543 -.nf\r
544 -.B group\r
545 -.B {\r
546 -.B \t[declarations];\r
547 -.B };\r
548 -.fi\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
552 -pool, or host.\r
553 -\r
554 -.nf\r
555 -.B pool\r
556 -.B {\r
557 -.B \t[declarations];\r
558 -.B };\r
559 -.fi\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
563 -\r
564 -.nf\r
565 -.B host\ <host\ name>\r
566 -.B {\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
572 -.B };\r
573 -.fi\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
579 -\r
580 -.nf\r
581 -.B address\r
582 -.B {\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
586 -.B };\r
587 -.fi\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
591 -\r
592 -.nf\r
593 -.B prefix\ <prefix>/<prefix\ length>;\r
594 -.fi\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
599 -\r
600 -.nf\r
601 -.B iaidinfo\r
602 -.B {\r
603 -.B \t[iaid\ <IAID\ number>];\r
604 -.B \t[renew-time\ <renew\ time>];\r
605 -.B \t[rebind-time\ <rebind\ time>];\r
606 -.B };\r
607 -.fi\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
611 -\r
612 -.nf\r
613 -.B range\ <ipv6\ address>\ to\ <ipv6\ address>/<prefix\ length>;\r
614 -.fi\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
619 -\r
620 -.nf\r
621 -.B duid\ <DUID\>;\r
622 -.fi\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
626 -\r
627 -.nf\r
628 -.BI iaid\ <IAID\ number>;\r
629 -.fi\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
633 -\r
634 -.nf\r
635 -.BI renew-time\ <renew\ time>;\r
636 -.fi\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
640 -\r
641 -.nf\r
642 -.BI rebind-time\ <rebind\ time>;\r
643 -.fi\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
647 -\r
648 -.nf\r
649 -.BI prefer-life-time\ <preferred\ lifetime>;\r
650 -.fi\r
651 -This statement allows administrators to specify the Preferred Life Time for \r
652 -each address.\r
653 -\r
654 -.nf\r
655 -.BI valid-life-time\ <valid\ lifetime>;\r
656 -.fi\r
657 -This statement allows administrators to specify the Valid Life Time for \r
658 -each address.\r
659 -\r
660 -.nf\r
661 -.BI option\ dns_server\ <ipv6\ addresses\ or\ domain\ name\ list>;\r
662 -.fi\r
663 -This statement allows administrators to specify the DNS servers.\r
664 -\r
665 -.B send\ <OPTION>;\r
666 -.fi\r
667 -This declaration enables dhcp6s to include the specified option in sending \r
668 -DHCPv6 messages.\r
669 -\r
670 -.nf\r
671 -\fIsend\ unicast;\fR\r
672 -.fi\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
677 -\r
678 -.nf\r
679 -\fIsend\ server-preference\ <server\ preference\ value>;\fR\r
680 -.fi\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
684 -\r
685 -.nf\r
686 -\fIsend\ temp-address;\fR\r
687 -.fi\r
688 -This declaration assigns a temporary address to the requesting client.\r
689 -\r
690 -.nf\r
691 -\fIsend\ information-only;\fR\r
692 -.fi\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
696 -\r
697 -.nf\r
698 -.B allow\ <OPTION>;\r
699 -.fi\r
700 -This declaration allows the DHCPv6 client to specify an option in receiving\r
701 -DHCPv6 messages.\r
702 -\r
703 -.nf\r
704 -\fIallow rapid\-commit;\fR\r
705 -.fi\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
708 -\r
709 -.nf\r
710 -\fIallow\ unicast;\fR\r
711 -.fi\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
716 -\r
717 -.SH EXAMPLES\r
718 -.PP\r
719 -This is a sample of the dhcp6s.conf file.\r
720 -.nf\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
727 -.B \tlink AAA {\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
738 -.B \t\tpool {\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
743 -.B \t\t};\r
744 -.B \t};\r
745 -.B \thost host0 {\r
746 -.B \t\tduid 00:00:00:00:a0:a0;\r
747 -.B \t\tiaidinfo {\r
748 -.B \t\t\tiaid 101010;\r
749 -.B \t\t\trenew-time 1000;\r
750 -.B \t\t\trebind-time 2000;\r
751 -.B \t\t};\r
752 -.B \t\taddress {\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
756 -.B \t\t};\r
757 -.B \t};\r
758 -.B \tgroup {\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
767 -.B \t\t\t};\r
768 -.B \t\t};\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
772 -.B \t\t};\r
773 -.B \t};\r
774 -.B };\r
775 -.fi\r
776 -\r
777 -.SH SEE ALSO\r
778 -Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options\r
779 -for DHCPv6, dhcp6s(5)\r
780 -\r
781 -.SH AUTHORS\r
782 -.LP\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.
791 +
792 + The interface definitions are described in the following form:
793 +.PP
794 +.nf
795 +.B \tinterface\ <interface\ name>
796 +.B \t{
797 +.B \t\t[declarations];
798 +.B \t};
799 +.fi
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.
804 +
805 +.PP
806 +.BI DECLARATIONS
807 +.PP
808 +.nf
809 +.B interface\ <interface\ name>
810 +.B {
811 +.B \t[declarations];
812 +.B };
813 +.fi
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
817 +declaration.
818 +
819 +.nf
820 +.B link\ <link\ name>
821 +.B {
822 +.B \t[declarations];
823 +.B };
824 +.fi
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.
828 +
829 +.nf
830 +.B group
831 +.B {
832 +.B \t[declarations];
833 +.B };
834 +.fi
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,
838 +pool, or host.
839 +
840 +.nf
841 +.B pool
842 +.B {
843 +.B \t[declarations];
844 +.B };
845 +.fi
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.
849 +
850 +.nf
851 +.B host\ <host\ name>
852 +.B {
853 +.B \t[duid\ <DUID\n>];
854 +.B \t[iaidinfo\ {}];
855 +.B \t[address\ {}];
856 +.B \t[prefix\ <prefix>/<prefix\ length>];
857 +.B \t[declarations];
858 +.B };
859 +.fi
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. 
865 +
866 +.nf
867 +.B address
868 +.B {
869 +.B \t[<ipv6 address>/<prefix length>];
870 +.B \t[prefer-life-time\ <preferred\ lifetime>];
871 +.B \t[valid-life-time\ <valid\ lifetime>];
872 +.B };
873 +.fi
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.
877 +
878 +.nf
879 +.B prefix\ <prefix>/<prefix\ length>;
880 +.fi
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.
885 +
886 +.nf
887 +.B relay\ <relay>/<prefix\ length>;
888 +.fi
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.
893 +
894 +.nf
895 +.B iaidinfo
896 +.B {
897 +.B \t[iaid\ <IAID\ number>];
898 +.B \t[renew-time\ <renew\ time>];
899 +.B \t[rebind-time\ <rebind\ time>];
900 +.B };
901 +.fi
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.
905 +
906 +.nf
907 +.B range\ <ipv6\ address>\ to\ <ipv6\ address>/<prefix\ length>;
908 +.fi
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.
913 +
914 +.nf
915 +.B duid\ <DUID\>;
916 +.fi
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.
920 +
921 +.nf
922 +.BI iaid\ <IAID\ number>;
923 +.fi
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.
927 +
928 +.nf
929 +.BI renew-time\ <renew\ time>;
930 +.fi
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.
934 +
935 +.nf
936 +.BI rebind-time\ <rebind\ time>;
937 +.fi
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.
941 +
942 +.nf
943 +.BI prefer-life-time\ <preferred\ lifetime>;
944 +.fi
945 +This statement allows administrators to specify the Preferred Life Time for 
946 +each address.
947 +
948 +.nf
949 +.BI valid-life-time\ <valid\ lifetime>;
950 +.fi
951 +This statement allows administrators to specify the Valid Life Time for 
952 +each address.
953 +
954 +.nf
955 +.BI option\ dns_server\ <ipv6\ addresses\ or\ domain\ name\ list>;
956 +.fi
957 +This statement allows administrators to specify the DNS servers.
958 +
959 +.B send\ <OPTION>;
960 +.fi
961 +This declaration enables dhcp6s to include the specified option in sending 
962 +DHCPv6 messages.
963 +
964 +.nf
965 +\fIsend\ unicast;\fR
966 +.fi
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.
971 +
972 +.nf
973 +\fIserver-preference\ <server\ preference\ value>;\fR
974 +.fi
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.
978 +
979 +.nf
980 +\fIsend\ temp-address;\fR
981 +.fi
982 +This declaration assigns a temporary address to the requesting client.
983 +
984 +.nf
985 +\fIsend\ information-only;\fR
986 +.fi
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.
990 +
991 +.nf
992 +.B allow\ <OPTION>;
993 +.fi
994 +This declaration allows the DHCPv6 client to specify an option in receiving
995 +DHCPv6 messages.
996 +
997 +.nf
998 +\fIallow rapid\-commit;\fR
999 +.fi
1000 +This option enables dhcp6s to allow the Rapid-Commit option from the DHCPv6
1001 +client and the Solicit-Reply message exchanges.
1002 +
1003 +.nf
1004 +\fIallow\ unicast;\fR
1005 +.fi
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.
1010 +
1011 +
1012 +.nf
1013 +\fIuse-ra-prefix;\fR
1014 +.fi
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.
1020 +
1021 +.SH EXAMPLES
1022 +.PP
1023 +This is a sample of the dhcp6s.conf file.
1024 +.nf
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 {
1031 +.B \tlink AAA {
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;
1042 +.B \t\tpool {
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;
1047 +.B \t\t};
1048 +.B \t};
1049 +.B \thost host0 {
1050 +.B \t\tduid 00:00:00:00:a0:a0;
1051 +.B \t\tiaidinfo {
1052 +.B \t\t\tiaid 101010;
1053 +.B \t\t\trenew-time 1000;
1054 +.B \t\t\trebind-time 2000;
1055 +.B \t\t};
1056 +.B \t\taddress {
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;
1060 +.B \t\t};
1061 +.B \t};
1062 +.B \tgroup {
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;
1071 +.B \t\t\t};
1072 +.B \t\t};
1073 +.B \t\thost host2 {
1074 +.B \t\t\tduid 00:00:00:00:a2:a2;
1075 +.B \t\t\tsend information-only;
1076 +.B \t\t};
1077 +.B \t};
1078 +.B };
1079 +.fi
1080 +
1081 +.SH SEE ALSO
1082 +Dynamic Host Configuration Protocol for IPv6 (DHCPv6), IPv6 Prefix Options
1083 +for DHCPv6, dhcp6s(5)
1084 +
1085 +.SH AUTHORS
1086 +.LP
1087 +Kazuo Hiekata <hiekata@yamato.ibm.com>
This page took 0.288371 seconds and 3 git commands to generate.