/[pkgs]/devel/dhcp/dhcp-4.1.0-manpages.patch
ViewVC logotype

Contents of /devel/dhcp/dhcp-4.1.0-manpages.patch

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (show annotations) (download) (as text)
Tue Jan 6 23:46:51 2009 UTC (10 months, 2 weeks ago) by dcantrel
Branch: MAIN
CVS Tags: F-12-split, dhcp-4_1_0-3_fc11, dhcp-4_1_0-2_fc11, dhcp-4_1_0-22_fc12, dhcp-4_1_0-1_fc11, dhcp-4_1_0-20_fc12, dhcp-4_1_0p1-5_fc12, dhcp-4_1_0-16_fc11, dhcp-4_1_0p1-13_fc13, dhcp-4_1_0-11_fc11, dhcp-4_1_0p1-11_fc12, dhcp-4_1_0-10_fc11, dhcp-4_1_0-15_fc11, dhcp-4_1_0-12_fc11, dhcp-4_1_0-14_fc11, F-11-split, dhcp-4_1_0p1-6_fc12, dhcp-4_1_0p1-7_fc12, dhcp-4_1_0p1-8_fc12, dhcp-4_1_0-4_fc11, dhcp-4_1_0p1-4_fc12, dhcp-4_1_0-13_fc11, dhcp-4_1_0-18_fc12, dhcp-4_1_0p1-14_fc13, dhcp-4_1_0-23_fc12, dhcp-4_1_0-6_fc11, dhcp-4_1_0-17_fc12, dhcp-4_1_0-19_fc12, dhcp-4_1_0p1-1_fc12, dhcp-4_1_0p1-3_fc12, dhcp-4_1_0p1-9_fc12, dhcp-4_1_0-9_fc11, dhcp-4_1_0p1-12_fc13, dhcp-4_1_0-26_fc12, dhcp-4_1_0p1-10_fc12, dhcp-4_1_0-8_fc11, dhcp-4_1_0-5_fc11, dhcp-4_1_0-25_fc12, dhcp-4_1_0-24_fc12, dhcp-4_1_0-7_fc11, dhcp-4_1_0-27_fc12, dhcp-4_1_0-21_fc12, dhcp-4_1_0p1-2_fc12, HEAD
File MIME type: text/x-patch
* Tue Jan 06 2009 David Cantrell <dcantrell@redhat.com> - 12:4.1.0-1
- Upgraded to ISC dhcp-4.1.0
- Had to rename the -T option to -timeout as ISC is now using -T
- Allow package rebuilders to easily enable DHCPv6 support with:
      rpmbuild --with DHCPv6 dhcp.spec
  Note that Fedora is still using the 'dhcpv6' package, but some
  users may want to experiment with the ISC DHCPv6 implementation
  locally.
1 diff -up dhcp-4.1.0/client/dhclient.8.man dhcp-4.1.0/client/dhclient.8
2 --- dhcp-4.1.0/client/dhclient.8.man 2008-11-20 04:55:14.000000000 -1000
3 +++ dhcp-4.1.0/client/dhclient.8 2009-01-06 11:51:30.000000000 -1000
4 @@ -111,6 +111,33 @@ relay
5 .B -w
6 ]
7 [
8 +.B -B
9 +]
10 +[
11 +.B -I
12 +.I dhcp-client-identifier
13 +]
14 +[
15 +.B -H
16 +.I host-name
17 +]
18 +[
19 +.B -F
20 +.I fqdn.fqdn
21 +]
22 +[
23 +.B -V
24 +.I vendor-class-identifier
25 +]
26 +[
27 +.B -R
28 +.I request-option-list
29 +]
30 +[
31 +.B -timeout
32 +.I timeout
33 +]
34 +[
35 .B -v
36 ]
37 [
38 @@ -138,32 +165,6 @@ important details about the network to w
39 the location of a default router, the location of a name server, and
40 so on.
41 .PP
42 -If given the -4 command line argument (default), dhclient will use the
43 -DHCPv4 protocol to obtain an IPv4 address and configuration parameters.
44 -.PP
45 -If given the -6 command line argument, dhclient will use the DHCPv6
46 -protocol to obtain whatever IPv6 addresses are available along with
47 -configuration parameters. But with
48 -.B -S
49 -it uses Information-request to get only (i.e., without address)
50 -stateless configuration parameters.
51 -.PP
52 -The default DHCPv6 behavior is modified too with
53 -.B -T
54 -which asks for IPv6 temporary addresses, one set per
55 -.B -T
56 -flag.
57 -.B -P
58 -enables the IPv6 prefix delegation.
59 -As temporary addresses or prefix delegation disables the normal
60 -address query,
61 -.B -N
62 -restores it. Note it is not recommended to mix queries of different types
63 -together, or even to share the lease file between them.
64 -.PP
65 -If given the --version command line argument, dhclient will print its
66 -version number and exit.
67 -.PP
68 On startup, dhclient reads the
69 .IR dhclient.conf
70 for configuration instructions. It then gets a list of all the
71 @@ -217,141 +218,259 @@ file. If interfaces are specified in t
72 only configure interfaces that are either specified in the
73 configuration file or on the command line, and will ignore all other
74 interfaces.
75 -.PP
76 -If the DHCP client should listen and transmit on a port other than the
77 -standard (port 68), the
78 -.B -p
79 -flag may used. It should be followed by the udp port number that
80 -dhclient should use. This is mostly useful for debugging purposes.
81 -If a different port is specified for the client to listen on and
82 -transmit on, the client will also use a different destination port -
83 -one less than the specified port.
84 -.PP
85 -The DHCP client normally transmits any protocol messages it sends
86 -before acquiring an IP address to, 255.255.255.255, the IP limited
87 -broadcast address. For debugging purposes, it may be useful to have
88 -the server transmit these messages to some other address. This can
89 -be specified with the
90 -.B -s
91 -flag, followed by the IP address or domain name of the destination.
92 -This feature is not supported by DHCPv6.
93 -.PP
94 -For testing purposes, the giaddr field of all packets that the client
95 -sends can be set using the
96 -.B -g
97 -flag, followed by the IP address to send. This is only useful for testing,
98 -and should not be expected to work in any consistent or useful way.
99 -.PP
100 -The DHCP client will normally run in the foreground until it has
101 -configured an interface, and then will revert to running in the
102 -background. To run force dhclient to always run as a foreground
103 -process, the
104 -.B -d
105 -flag should be specified. This is useful when running the client
106 -under a debugger, or when running it out of inittab on System V
107 -systems.
108 -.PP
109 -The dhclient daemon creates its own environment when executing the
110 -dhclient-script to do the grunt work of interface configuration.
111 -To define extra environment variables and their values, use the
112 -.B -e
113 -flag, followed by the environment variable name and value assignment,
114 -just as one would assign a variable in a shell. Eg:
115 -.B -e
116 -.I IF_METRIC=1
117 -.PP
118 -The client normally prints no output during its startup sequence. It
119 -can be made to emit verbose messages displaying the startup sequence events
120 -until it has acquired an address by supplying the
121 -.B -v
122 -command line argument. In either case, the client logs messages using
123 -the
124 -.B syslog (3)
125 -facility. A
126 -.B -q
127 -command line argument is provided for backwards compatibility, but since
128 -dhclient is quiet by default, it has no effect.
129 -.PP
130 -The client normally doesn't release the current lease as it is not
131 -required by the DHCP protocol. Some cable ISPs require their clients
132 -to notify the server if they wish to release an assigned IP address.
133 -The
134 -.B -r
135 -flag explicitly releases the current lease, and once the lease has been
136 -released, the client exits.
137 -.PP
138 +.SH OPTIONS
139 +.TP
140 +.BI \-4
141 +Use the DHCPv4 protocol to obtain an IPv4 address and configuration
142 +parameters (default).
143 +
144 +.TP
145 +.BI \-6
146 +Use the DHCPv6 protocol to obtain whatever IPv6 addresses are available
147 +along with configuration parameters. The functionality of DHCPv6 mode
148 +may be modified with the
149 +.BI \-S
150 +,
151 +.BI \-T
152 +, and
153 +.BI \-N
154 +options.
155 +
156 +.TP
157 +.BI \-S
158 +Perform an information-only request over DHCPv6 to get stateless
159 +configuration parameters. It is not recommended to combine this option
160 +with the
161 +.BI \-N
162 +,
163 +.BI \-P
164 +, or
165 +.BI \-T
166 +options or to share lease files between different modes of operation. Only
167 +valid with the
168 +.BI \-6
169 +option.
170 +
171 +.TP
172 +.BI \-N
173 +Perform a normal (IA_NA) address query over DHCPv6. It is not recommended
174 +to combine this option with the
175 +.BI \-P
176 +,
177 +.BI \-S
178 +, or
179 +.BI \-T
180 +options or to share lease files between different modes of operation. Only
181 +valid with the
182 +.BI \-6
183 +option.
184 +
185 +.TP
186 +.BI \-T
187 +Perform a temporary (IA_TA) address query over DHCPv6 (disables normal address
188 +query). It is not recommended to combine this option with the
189 +.BI \-N
190 +,
191 +.BI \-P
192 +, or
193 +.BI \-S
194 +options or to share lease files between different modes of operation. Only
195 +valid with the
196 +.BI \-6
197 +option.
198 +
199 +.TP
200 +.BI \-P
201 +Enable IPv6 prefix delegation (disables normal address query). It is not
202 +not recommended to combine this option with the
203 +.BI \-N
204 +,
205 +.BI \-S
206 +, or
207 +.BI \-T
208 +options or to share lease files between different modes of operation. Only
209 +valid with the
210 +.BI \-6
211 +option.
212 +
213 +.TP
214 +.BI \-p\ <port\ number>
215 +The UDP port number the DHCP client should listen and transmit on. If
216 +unspecified,
217 +.B dhclient
218 +uses the default port 68. This option is mostly useful for debugging
219 +purposes. If a different port is specified for the client to listen and
220 +transmit on, the client will also use a different destination port - one
221 +less than the specified port.
222 +
223 +.TP
224 +.BI \-d
225 +Force
226 +.B dhclient
227 +to run as a foreground process. This is useful when running the client
228 +under a debugger, or when running it out of inittab on System V systems.
229 +
230 +.TP
231 +.BI \-e\ VAR=value
232 +Define additional environment variables for the environment where
233 +dhclient-script executes. You may specify multiplate
234 +.B \-e
235 +options on the command line. For example:
236 +.B \-e IF_METRIC=1
237 +
238 +.TP
239 +.BI \-q
240 +Suppress all terminal and log output except error messages.
241 +
242 +.TP
243 +.BI \-1
244 +Try once to get a lease. One failure, exit with code 2.
245 +
246 +.TP
247 +.BI \-r
248 +Tell
249 +.B dhclient
250 +to release the current lease it has from the server. This is not required
251 +by the DHCP protocol, but some ISPs require their clients to notify the
252 +server if they wish to release an assigned IP address.
253 +
254 +.TP
255 +.BI \-lf\ <lease-file>
256 +Path to the lease database file. If unspecified, the default
257 +.B DBDIR/dhclient.leases
258 +is used.
259 +
260 +.TP
261 +.BI \-pf\ <pid-file>
262 +Path to the process ID file. If unspecified, the default
263 +.B RUNDIR/dhclient.pid
264 +is used.
265 +
266 +.TP
267 +.BI \-cf\ <config-file>
268 +Path to the client configuration file. If unspecified, the default
269 +.B ETCDIR/dhclient.conf
270 +is used.
271 +
272 +.TP
273 +.BI \-sf\ <script-file>
274 +Path to the network configuration script invoked by
275 +.B dhclient
276 +when it gets a lease. If unspecified, the default
277 +.B /sbin/dhclient-script
278 +is used.
279 +
280 +.TP
281 +.BI \-s\ <server>
282 +Specifiy the server IP address or fully qualified domain name to transmit
283 +DHCP protocol messages to. Normally,
284 +.B dhclient
285 +transmits these messages to 255.255.255.255 (the IP limited broadcast
286 +address). Overriding this is mostly useful for debugging purposes.
287 +
288 +.TP
289 +.BI \-g\ <relay>
290 +Only for debugging. Set the giaddr field of all packets the client
291 +sends to the IP address specified. This should not be expected to work
292 +in any consistent or useful way.
293 +
294 +.TP
295 +.BI \-n
296 +Do not configure any interfaces. Most useful combined with the
297 +.B -w
298 +option.
299 +
300 +.TP
301 +.BI \-nw
302 +Become a daemon process immediately (nowait) rather than waiting until an IP
303 +address has been acquired.
304 +
305 +.TP
306 +.BI \-w
307 +Keep running even if no network interfaces are found. The
308 +.B omshell
309 +program can be used to notify the client when a network interface has been
310 +added or removed so it can attempt to configure an IP address on that
311 +interface.
312 +
313 +.TP
314 +.BI \-B
315 +Set the BOOTP broadcast flag in request packets so servers will always
316 +broadcast replies.
317 +
318 +.TP
319 +.BI \-I\ <dhcp-client-identifier>
320 +Specify the dhcp-client-identifier option to send to the DHCP server.
321 +
322 +.TP
323 +.BI \-H\ <host-name>
324 +Specify the host-name option to send to the DHCP server. The host-name
325 +string only contains the client's hostname prefix, to which the server will
326 +append the ddns-domainname or domain-name options, if any, to derive the
327 +fully qualified domain name of the client. The
328 +.B -H
329 +option cannot be used with the
330 +.B -F
331 +option.
332 +
333 +.TP
334 +.BI \-F\ <fqdn.fqdn>
335 +Specify the fqdn.fqdn option to send to the DHCP server. This option cannot
336 +be used with the
337 +.B -H
338 +option. The fqdn.fqdn option must specify the complete domain name of the
339 +client host, which the server may use for dynamic DNS updates.
340 +
341 +.TP
342 +.BI \-V\ <vendor-class-identifier>
343 +Specify the vendor-class-identifier option to send to the DHCP server.
344 +
345 +.TP
346 +.BI \-R\ <option>[,<option>...]
347 +Specify the list of options the client is to request from the server. The
348 +option list must be a single string consisting of option names separated
349 +by at least one command and optional space characters. The default option
350 +list is:
351 +
352 +.BR
353 + subnet-mask, broadcast-address, time-offset, routers,
354 +.BR
355 + domain-name, domain-name-servers, host-name, nis-domain,
356 +.BR
357 + nis-servers, ntp-servers
358 +
359 The
360 -.B -x
361 -flag tells any currently running client to exit gracefully without
362 -releasing leases first.
363 +.B -R
364 +option does not append options to the default request, it overrides the
365 +default request list. Keep this in mind if you want to request an
366 +additional option besides the default request list. You will have to
367 +specify all option names for the
368 +.B -R
369 +parameter.
370 +
371 +.TP
372 +.BI \-timeout\ <timeout>
373 +Specify the time after which
374 +.B dhclient
375 +will decide that no DHCP servers can be contacted when no responses have been
376 +received.
377 +
378 +.TP
379 +.BI \-v
380 +Enable verbose log messages.
381 +
382 .PP
383 -If the client is killed by a signal (for example at shutdown or reboot)
384 -it won't execute the
385 +If the client is killed by a signale (for example at shutdown or reboot), it
386 +will not execute the
387 .B dhclient-script (8)
388 -at exit. However if you shut the client down gracefully with
389 -.B -r
390 +at exit. However, if you shut the client down gracefully with
391 +.BI \-r
392 or
393 -.B -x
394 +.BI \-x
395 it will execute
396 .B dhclient-script (8)
397 -at shutdown with the specific reason for calling the script set.
398 -.PP
399 -The
400 -.B -1
401 -flag will cause dhclient to try once to get a lease. If it fails, dhclient
402 -exits with exit code two. In DHCPv6 the
403 -.B -1
404 -flag sets the max duration of the initial exchange to
405 -.I timeout
406 -(from
407 -.IR dhclient.conf ,
408 -default sixty seconds).
409 -.PP
410 -The DHCP client normally gets its configuration information from
411 -.B ETCDIR/dhclient.conf,
412 -its lease database from
413 -.B DBDIR/dhclient.leases,
414 -stores its process ID in a file called
415 -.B RUNDIR/dhclient.pid,
416 -and configures the network interface using
417 -.B CLIENTBINDIR/dhclient-script
418 -To specify different names and/or locations for these files, use the
419 -.B -cf,
420 -.B -lf,
421 -.B -pf
422 -and
423 -.B -sf
424 -flags, respectively, followed by the name of the file. This can be
425 -particularly useful if, for example,
426 -.B DBDIR
427 -or
428 -.B RUNDIR
429 -has not yet been mounted when the DHCP client is started.
430 -.PP
431 -The DHCP client normally exits if it isn't able to identify any
432 -network interfaces to configure. On laptop computers and other
433 -computers with hot-swappable I/O buses, it is possible that a
434 -broadcast interface may be added after system startup. The
435 -.B -w
436 -flag can be used to cause the client not to exit when it doesn't find
437 -any such interfaces. The
438 -.B omshell (1)
439 -program can then be used to notify the client when a network interface
440 -has been added or removed, so that the client can attempt to configure an IP
441 -address on that interface.
442 -.PP
443 -The DHCP client can be directed not to attempt to configure any interfaces
444 -using the
445 -.B -n
446 -flag. This is most likely to be useful in combination with the
447 -.B -w
448 -flag.
449 -.PP
450 -The client can also be instructed to become a daemon immediately, rather
451 -than waiting until it has acquired an IP address. This can be done by
452 -supplying the
453 -.B -nw
454 -flag.
455 +at shutdown with the specific reason for calling the script set in the
456 +environment table.
457 .SH CONFIGURATION
458 The syntax of the dhclient.conf(5) file is discussed separately.
459 .SH OMAPI
460 @@ -386,7 +505,7 @@ do a DHCPRELEASE. To pause it, set its
461 resume it, set its state attribute to 4.
462 .PP
463 .SH FILES
464 -.B CLIENTBINDIR/dhclient-script,
465 +.B /sbin/dhclient-script,
466 .B ETCDIR/dhclient.conf, DBDIR/dhclient.leases, RUNDIR/dhclient.pid,
467 .B DBDIR/dhclient.leases~.
468 .SH SEE ALSO
469 diff -up dhcp-4.1.0/client/dhclient.conf.5.man dhcp-4.1.0/client/dhclient.conf.5
470 --- dhcp-4.1.0/client/dhclient.conf.5.man 2008-03-07 08:58:29.000000000 -1000
471 +++ dhcp-4.1.0/client/dhclient.conf.5 2009-01-06 10:50:40.000000000 -1000
472 @@ -186,9 +186,9 @@ responding to the client send the client
473 options. Only the option names should be specified in the request
474 statement - not option parameters. By default, the DHCP server
475 requests the subnet-mask, broadcast-address, time-offset, routers,
476 -domain-name, domain-name-servers and host-name options. Note that if
477 -you enter a 'request' statement, you over-ride this default and these
478 -options will not be requested.
479 +domain-name, domain-name-servers host-name, nis-domain, nis-servers,
480 +and ntp-servers options. Note that if you enter a 'request' statement,
481 +you over-ride this default and these options will not be requested.
482 .PP
483 In some cases, it may be desirable to send no parameter request list
484 at all. To do this, simply write the request statement but specify
485 @@ -627,6 +627,18 @@ database and will record the media type
486 Whenever the client tries to renew the lease, it will use that same
487 media type. The lease must expire before the client will go back to
488 cycling through media types.
489 +.PP
490 + \fBbootp-broadcast-always;\fR
491 +.PP
492 +The
493 +.B bootp-broadcast-always
494 +statement instructs dhclient to always set the bootp broadcast flag in
495 +request packets, so that servers will always broadcast replies.
496 +This is equivalent to supplying the dhclient -B argument, and has
497 +the same effect as specifying 'always-broadcast' in the server's dhcpd.conf.
498 +This option is provided as an extension to enable dhclient to work
499 +on IBM s390 Linux guests.
500 +.PP
501 .SH SAMPLE
502 The following configuration file is used on a laptop running NetBSD
503 1.3. The laptop has an IP alias of 192.5.5.213, and has one
504 @@ -648,12 +660,12 @@ interface "ep0" {
505 send host-name "andare.fugue.com";
506 send dhcp-client-identifier 1:0:a0:24:ab:fb:9c;
507 send dhcp-lease-time 3600;
508 - supersede domain-name "fugue.com rc.vix.com home.vix.com";
509 + supersede domain-search "fugue.com rc.vix.com home.vix.com";
510 prepend domain-name-servers 127.0.0.1;
511 request subnet-mask, broadcast-address, time-offset, routers,
512 - domain-name, domain-name-servers, host-name;
513 + domain-search, domain-name, domain-name-servers, host-name;
514 require subnet-mask, domain-name-servers;
515 - script "CLIENTBINDIR/dhclient-script";
516 + script "/sbin/dhclient-script";
517 media "media 10baseT/UTP", "media 10base2/BNC";
518 }
519
520 diff -up dhcp-4.1.0/client/dhclient-script.8.man dhcp-4.1.0/client/dhclient-script.8
521 --- dhcp-4.1.0/client/dhclient-script.8.man 2006-02-24 13:16:27.000000000 -1000
522 +++ dhcp-4.1.0/client/dhclient-script.8 2009-01-06 10:50:40.000000000 -1000
523 @@ -47,16 +47,16 @@ customizations are needed, they should b
524 exit hooks provided (see HOOKS for details). These hooks will allow the
525 user to override the default behaviour of the client in creating a
526 .B /etc/resolv.conf
527 -file.
528 +file, and to handle DHCP options not handled by default.
529 .PP
530 No standard client script exists for some operating systems, even though
531 the actual client may work, so a pioneering user may well need to create
532 a new script or modify an existing one. In general, customizations specific
533 to a particular computer should be done in the
534 -.B ETCDIR/dhclient.conf
535 +.B /usr/local/etc/dhclient.conf
536 file. If you find that you can't make such a customization without
537 customizing
538 -.B ETCDIR/dhclient.conf
539 +.B /usr/local/etc/dhclient.conf
540 or using the enter and exit hooks, please submit a bug report.
541 .SH HOOKS
542 When it starts, the client script first defines a shell function,
543 @@ -68,33 +68,53 @@ the enter hook script.
544 .PP
545 On after defining the make_resolv_conf function, the client script checks
546 for the presence of an executable
547 -.B ETCDIR/dhclient-enter-hooks
548 +.B /usr/local/etc/dhclient-enter-hooks
549 script, and if present, it invokes the script inline, using the Bourne
550 shell '.' command. The entire environment documented under OPERATION
551 is available to this script, which may modify the environment if needed
552 to change the behaviour of the script. If an error occurs during the
553 execution of the script, it can set the exit_status variable to a nonzero
554 value, and
555 -.B CLIENTBINDIR/dhclient-script
556 +.B /sbin/dhclient-script
557 will exit with that error code immediately after the client script exits.
558 .PP
559 After all processing has completed,
560 -.B CLIENTBINDIR/dhclient-script
561 +.B /sbin/dhclient-script
562 checks for the presence of an executable
563 -.B ETCDIR/dhclient-exit-hooks
564 +.B /usr/local/etc/dhclient-exit-hooks
565 script, which if present is invoked using the '.' command. The exit
566 status of dhclient-script will be passed to dhclient-exit-hooks in the
567 exit_status shell variable, and will always be zero if the script
568 succeeded at the task for which it was invoked. The rest of the
569 environment as described previously for dhclient-enter-hooks is also
570 present. The
571 -.B ETCDIR/dhclient-exit-hooks
572 +.B /usr/local/etc/dhclient-exit-hooks
573 script can modify the valid of exit_status to change the exit status
574 of dhclient-script.
575 +.PP
576 +Immediately after dhclient brings an interface UP with a new IP address,
577 +subnet mask, and routes, in the REBOOT/BOUND states, it will check for the
578 +existence of an executable
579 +.B /usr/local/etc/dhclient-up-hooks
580 +script, and source it if found. This script can handle DHCP options in
581 +the environment that are not handled by default. A per-interface.
582 +.B /usr/local/etc/dhclient-${IF}-up-hooks
583 +script will override the generic script and be sourced when interface
584 +$IF has been brought up.
585 +.PP
586 +Immediately before dhclient brings an interface DOWN, removing its IP
587 +address, subnet mask, and routes, in the STOP/RELEASE states, it will
588 +check for the existence of an executable
589 +.B /usr/local/etc/dhclient-down-hooks
590 +script, and source it if found. This script can handle DHCP options in
591 +the environment that are not handled by default. A per-interface
592 +.B /usr/local/etc/dhclient-${IF}-down-hooks
593 +script will override the generic script and be sourced when interface
594 +$IF is about to be brought down.
595 .SH OPERATION
596 When dhclient needs to invoke the client configuration script, it
597 defines a set of variables in the environment, and then invokes
598 -.B CLIENTBINDIR/dhclient-script.
599 +.B /sbin/dhclient-script.
600 In all cases, $reason is set to the name of the reason why the script
601 has been invoked. The following reasons are currently defined:
602 MEDIUM, PREINIT, BOUND, RENEW, REBIND, REBOOT, EXPIRE, FAIL, STOP, RELEASE,
603 diff -up dhcp-4.1.0/common/dhcp-options.5.man dhcp-4.1.0/common/dhcp-options.5
604 --- dhcp-4.1.0/common/dhcp-options.5.man 2008-11-21 03:59:56.000000000 -1000
605 +++ dhcp-4.1.0/common/dhcp-options.5 2009-01-06 10:50:40.000000000 -1000
606 @@ -905,6 +905,21 @@ classless IP routing - it does not inclu
607 classless IP routing is now the most widely deployed routing standard,
608 this option is virtually useless, and is not implemented by any of the
609 popular DHCP clients, for example the Microsoft DHCP client.
610 +.PP
611 +NOTE to Fedora dhclient users:
612 +.br
613 +dhclient-script interprets trailing 0 octets of the target as indicating
614 +the subnet class of the route, so for the following static-routes value:
615 +.br
616 + option static-routes 172.0.0.0 172.16.2.254,
617 +.br
618 + 192.168.0.0 192.168.2.254;
619 +.br
620 +dhclient-script will create routes:
621 +.br
622 + 172/8 via 172.16.2.254 dev $interface
623 +.br
624 + 192.168/16 via 192.168.2.254 dev $interface
625 .RE
626 .PP
627 .nf
628 diff -up dhcp-4.1.0/server/dhcpd.conf.5.man dhcp-4.1.0/server/dhcpd.conf.5
629 --- dhcp-4.1.0/server/dhcpd.conf.5.man 2008-11-03 08:13:58.000000000 -1000
630 +++ dhcp-4.1.0/server/dhcpd.conf.5 2009-01-06 10:50:40.000000000 -1000
631 @@ -519,6 +519,9 @@ pool {
632 };
633 .fi
634 .PP
635 +Dynamic BOOTP leases are not compatible with failover, and, as such,
636 +you need to disallow BOOTP in pools that you are using failover for.
637 +.PP
638 The server currently does very little sanity checking, so if you
639 configure it wrong, it will just fail in odd ways. I would recommend
640 therefore that you either do failover or don't do failover, but don't
641 @@ -533,9 +536,9 @@ primary server might look like this:
642 failover peer "foo" {
643 primary;
644 address anthrax.rc.vix.com;
645 - port 519;
646 + port 647;
647 peer address trantor.rc.vix.com;
648 - peer port 520;
649 + peer port 847;
650 max-response-delay 60;
651 max-unacked-updates 10;
652 mclt 3600;
653 @@ -594,9 +597,7 @@ statement
654 .B port \fIport-number\fR\fB;\fR
655 .PP
656 The \fBport\fR statement declares the TCP port on which the server
657 -should listen for connections from its failover peer. This statement
658 -may not currently be omitted, because the failover protocol does not
659 -yet have a reserved TCP port number.
660 +should listen for connections from its failover peer.
661 .RE
662 .PP
663 The
664 @@ -608,10 +609,8 @@ statement
665 .PP
666 The \fBpeer port\fR statement declares the TCP port to which the
667 server should connect to reach its failover peer for failover
668 -messages. This statement may not be omitted because the failover
669 -protocol does not yet have a reserved TCP port number. The port
670 -number declared in the \fBpeer port\fR statement may be the same as
671 -the port number declared in the \fBport\fR statement.
672 +messages. The port number declared in the \fBpeer port\fR statement
673 +may be the same as the port number declared in the \fBport\fR statement.
674 .RE
675 .PP
676 The
677 @@ -1278,7 +1277,7 @@ the zone containing PTR records - for IS
678 .PP
679 .nf
680 key DHCP_UPDATER {
681 - algorithm HMAC-MD5.SIG-ALG.REG.INT;
682 + algorithm hmac-md5;
683 secret pRP5FapFoJ95JEL06sv4PQ==;
684 };
685
686 @@ -1301,7 +1300,7 @@ dhcpd.conf file:
687 .PP
688 .nf
689 key DHCP_UPDATER {
690 - algorithm HMAC-MD5.SIG-ALG.REG.INT;
691 + algorithm hmac-md5;
692 secret pRP5FapFoJ95JEL06sv4PQ==;
693 };
694
695 @@ -2302,7 +2301,7 @@ statement
696 .PP
697 .I Name
698 should be the name of the DHCP server's lease file. By default, this
699 -is DBDIR/dhcpd.leases. This statement \fBmust\fR appear in the outer
700 +is /private/var/db/dhcpd/dhcpd.leases. This statement \fBmust\fR appear in the outer
701 scope of the configuration file - if it appears in some other scope,
702 it will have no effect. Furthermore, it has no effect if overridden
703 by the
704 @@ -2337,7 +2336,7 @@ statement
705 .PP
706 .I Name
707 is the name of the lease file to use if and only if the server is running
708 -in DHCPv6 mode. By default, this is DBDIR/dhcpd6.leases. This statement,
709 +in DHCPv6 mode. By default, this is /private/var/db/dhcpd/dhcpd6.leases. This statement,
710 like
711 .I lease-file-name,
712 \fBmust\fR appear in the outer scope of the configuration file. It
713 @@ -2495,7 +2494,8 @@ statement
714 The \fInext-server\fR statement is used to specify the host address of
715 the server from which the initial boot file (specified in the
716 \fIfilename\fR statement) is to be loaded. \fIServer-name\fR should
717 -be a numeric IP address or a domain name.
718 +be a numeric IP address or a domain name. If no \fInext-server\fR statement
719 +applies to a given client, the address 0.0.0.0 is used.
720 .RE
721 .PP
722 The
723 @@ -2540,7 +2540,7 @@ statement
724 .I Name
725 should be the name of the DHCP server's process ID file. This is the
726 file in which the DHCP server's process ID is stored when the server
727 -starts. By default, this is RUNDIR/dhcpd.pid. Like the
728 +starts. By default, this is /private/var/run/dhcpd.pid. Like the
729 .I lease-file-name
730 statement, this statement must appear in the outer scope
731 of the configuration file. It has no effect if overridden by the
732 @@ -2558,7 +2558,7 @@ statement
733 .PP
734 .I Name
735 is the name of the pid file to use if and only if the server is running
736 -in DHCPv6 mode. By default, this is DBDIR/dhcpd6.pid. This statement,
737 +in DHCPv6 mode. By default, this is /private/var/db/dhcpd/dhcpd6.pid. This statement,
738 like
739 .I pid-file-name,
740 \fBmust\fR appear in the outer scope of the configuration file. It

admin@fedoraproject.org
ViewVC Help
Powered by ViewVC 1.1.2