1 Internet Systems Consortium DHCP Distribution
8 Please note that that ISC DHCP is now licensed under the Mozilla Public
9 License, MPL 2.0. Please see https://www.mozilla.org/en-US/MPL/2.0/ to read
10 the MPL 2.0 license terms.
12 NOTE: The client and relay components are now End-Of-Life.
13 4.4.3 is the final release for those components.
15 For information on how to install, configure and run this software, as
16 well as how to find documentation and report bugs, please consult the
19 ISC DHCP uses standard GNU configure for installation. Please review the
20 output of "./configure --help" to see what options are available.
22 The system has only been tested on Linux, and FreeBSD, and may not work on
23 other platforms. Please report any problems and suggested fixes to
26 ISC DHCP is open source software maintained by Internet Systems
27 Consortium. This product includes cryptographic software written
28 by Eric Young (eay@cryptsoft.com).
30 Changes since 4.4.2 (New Features)
32 - BIND libraries updated to the latest version, 9.11.36. This fixes a number
33 of compilation issues on various systems, including OpenWRT. Thanks to
34 Philip Prindeville for testing on OpenWRT.
35 [Gitlab #218, #171, #180, #192]
37 - Added support for the new DHCPv4 option v6-only-preferred specified
38 in RFC 8925. A new reason code, V6ONLY, was added to the client script
39 and the client Linux script sample was updated.
42 Changes since 4.4.2 (Bug Fixes)
44 - Minor corrections to allow compilation under gcc 10.
47 - Corrected logic in dhclient that causes it to decline DHCPv4 leases if the
48 client script exits abnormally (i.e. crashes).
51 - The limit on the size of lease file that can be loaded at start up
52 is now only enforced on 32-bit systems.
55 - The PRNG initialization has been improved. It now uses the configure flag
56 `--with-randomdev=PATH`, which specifies the device from which to read the
57 initial seed. That is typically `/dev/random` (the default value) or
58 `/dev/urandom`, but may be specified otherwise on the local system. If not
59 explicitly specified, the default device (`/dev/random`) is used. The old
60 behavior can be forced by disabling this feature (`--with-randomdev=no`).
61 If the initialization is disabled or reading from the random device fails,
62 the previous algorithm (retrieve the last four bytes of hardware addresses
63 from all network interfaces that have them, and use the current time and
67 - Minor dhclient code fix to remove compilation warnings.
70 - Removed hard-coded MD5 algorithm name in OMAPI connection logic. Prior
71 to this using any other algorithm via key-algorithm statement would
72 allow OMAPI connections to made but subsequent actions such as updating
76 Changes since 4.4.2b1 (Bug Fixes)
78 - Added a clarification on DHCPINFORMs and server authority to
82 - Only emit lease scrubbing log messages when DEBUG_FAILOVER_MESSAGES
86 - Added the interface name to socket initialization failure log messages.
87 Prior to this the log messages stated only the error reason without
88 stating the target interface.
91 - Corrected buffer pointer logic in dhcrelay functions that manipulate
92 agent relay options. Thanks to Thomas Imbert of MSRC Vulnerabilities
93 & Mitigations for reporting the issue.
96 - Corrected unresolved symbol errors building relay_unittests when
97 configured to build using libtool.
100 Changes since 4.4.1 (New Features)
102 - A new configuration parameter, ping-cltt-secs (v4 operation only), has
103 been added to allow the user to specify the number of seconds that must
104 elapse since CLTT before a ping check is conducted. Prior to this, the
105 value was hard coded at 60 seconds. Please see the server man pages for
106 a more detailed discussion.
109 - A new configuration parameter, ping-timeout-ms (v4 operation only),
110 has been added that allows the user to specify the amount of time
111 the server waits for a ping-check response in milliseconds rather
112 than in seconds (via ping-timeout). When greater than zero, the value
113 of ping-timeout-ms will override the value of ping-timeout. Thanks
114 to Jay Doran from Bluecat Networks for suggesting this feature.
117 - An experimental tool called, Keama (KEA Migration Assistant), which helps
118 translate ISC DHCP configurations to Kea configurations, is now included
122 Changes since 4.4.1 (Bug Fixes)
124 - Corrected a misuse of the BIND9 DDNS API which caused DDNS updates to be
125 carried out over TCP rather than UDP. The coding error was exposed by
126 migration to BIND9 9.11. Thanks to Jinmei Tatuya at Infoblox for
130 - Bind9 now defaults to requiring python to build. The Makefile for
131 building Bind9 when bundled with ISC DHCP was modified to turn off
135 - Corrected a dual-stack mixed-mode issue that occurs when both
136 ddns-guard-id-must-match and ddns-other-guard-is-dynamic
137 are enabled and that caused the server to incorrectly interpret
138 the presence of a guard record belonging to another client as
139 a case of no guard record at all. Thanks to Fernando Soto
140 from BlueCat Networks for reporting this issue.
143 - Corrected a compilation issue that occurred when building without DNS
144 update ability (e.g. by undefining NSUPDATE).
147 - Corrected an issue that was causing the server, when running in
148 DHPCv4 mode, to segfault when class lease limits are reached.
149 Thanks to Peter Nagy at Porion-Digital for reporting the matter
150 and submitting a patch.
153 - Made minor changes to eliminate warnings when compiled with GCC 9.
154 Thanks to Brett Neumeier for bringing the matter to our attention.
157 - Fixed potential memory leaks in parser error message generation
158 spotted by Coverity, CIDs: 1448191, 1448193, 1448194, 1448195
161 - Updated URL of IEEE oui.txt in contrib/dhcp-lease-list.pl. Thanks
162 to Tommy Smith for contributing the patch.
165 - Fixed define flags when using SO_BINDTODEVICE. Thanks to Joe LeVeque for
169 - Applied a patch from OpenBSD to always set the scope id of outbound
170 DHPCv6 packets. Note this change only applies when compiling under
171 OpenBSD. Thanks to Brad Smith at OpenBSD from bringing it to our
175 - Modified dhclient to not discard config file leases that are
176 duplicates of server-provided leases and to retain such leases
177 after they have been used as the fallback active lease and
178 DHCP service has been restored. This allows them to be used
179 more than once during the lifetime of a dhclient instance.
180 This applies to DHCPv4 operation only.
183 - Corrected a number of reference counter and zero-length buffer leaks.
184 Thanks to Christopher Ertl of MSRC Vulnerabilities & Mitigations for
188 - Closed a small window of time between the installation of graceful
189 shutdown signal handlers and application context startup, during which
190 the receipt of shutdown signal would cause a REQUIRE() assertion to
191 occur. Note this issue is only visible when compiling with
192 ENABLE_GENTLE_SHUTDOWN defined.
195 - Corrected a buffer overflow that can occur when retrieving zone
196 names that are more than 255 characters in length.
199 - The "d" domain name option format was incorrectly handled as text
200 instead of RFC 1035 wire format. Thanks to Jay Doran at BlueCat Networks
201 for reporting this issue.
204 - Improved the error message issued when a host declaration has both
205 a uid and a dhcp-client-identifier. Server configuration parsing will
206 now fail if a host declaration specifies more than one uid.
209 - Updated developer's documentation on building and running unit tests.
210 Removed support for --with-atf=bind as BIND9 no longer bundles in ATF
214 - Fixed a syntax error in ldap.c which cropped up under Ubuntu
215 18.04.1/gcc 7.4.0. Thanks to Charles Hedrick for pointing it out.
218 - Added clarification to dhcp-options.5 section on ip-address values
219 describing the first-use DNS resolution of options with hostnames as
220 values (e.g. next-server).
223 - The option format for the server option omapi-key was changed to a
224 format type 'k' (key name); while server options ldap-port and
225 ldap-init-retry were changed to 'L' (unsigned 32-bit integer). These
226 three options were inadvertantly broken when the 'd' format content
227 was changed to comply with RFC 1035 wire format (see Gitlab #2).
230 Changes since 4.4.0 (New Features)
232 Changes since 4.4.0 (Bug Fixes)
234 - A delayed-ack value of 0 (the default), now correctly disables the delayed
235 feature. A change in 4.4.0 prohibited lease updates marking leases active
236 from be written to the lease file when delayed-ack is 0. This in turn,
237 caused servers to lose active lease assignments upon restart.
240 ! Option reference count was not correctly decremented in error path
241 when parsing buffer for options. Reported by Felix Wilhelm, Google
246 ! Corrected an issue where large sized 'X/x' format options were causing
247 option handling logic to overwrite memory when expanding them to human
248 readable form. Reported by Felix Wilhelm, Google Security Team.
252 - Added use of new Bind9 compatibility header files, that are now necessary
253 to supply type definitions for primitive data types, removed from Bind9
254 proper. Altered util/bind.sh to pull from Bind9 repo on gitlab.
258 Changes since 4.4.0b1 (New Features)
260 - Duplicate address detection when binding to a new IPv6 address was added
261 to the following dhclient scripts: linux,freebsd,netbsd,openbsd, and macos.
262 The scripts will check for DAD errors after binding to a new IPv6 address
263 for at most --dad-wait-time seconds. If a DAD error is detected the script
264 will exit with a value of 3, instructing dhclient to decline the address. If
265 dad-wait-time is zero (the default), DAD error checking is not peformed.
268 - Support for sending and receiving additional DHCP4 options has been added
269 to both the dhcpd and dhclient. Specifically: option codes 93,94, and 97
270 (RFC 4578); code 150 (RFC 5859); and codes 209,219, and 211 (RFC 5071).
271 Beyond configuring, sending, requesting, and receiving these options neither
272 server nor client apply any additional logic based on their values.
273 Thanks to Peter Lewis for requesting this change.
276 Changes since 4.4.0b1 (Bug Fixes)
278 - Added clarifying text to dhcpd.conf.5 explaining the class match expressions
279 cannot rely on the results of executable statements.
282 - Fixed a bug which causes dhcpd and dhclient to crash on certain
283 systems when given relative path names for lease or pid files on
284 the command line. Affected systems are those on which the C library
285 function, realpath() does not support a second parameter value of
286 NULL (see manpages for realpath(3)).
289 - Fixed a build issue when building with embedded BIND9 under OpenBSD that
290 was causing BIND9 build to not generate dns/enumclass.h and dns/enumtype.h.
293 - Added <dhcp>/m4/README to the distribution tarball. Some versions of
294 ac_local() treat the absence of the m4 subdirectory as error rather than
295 warning. This was causing the call to autoreconf, necessary for building
296 with libtool, to fail.
299 Changes since 4.4.0a1 (New Features)
301 - Added experimental support for relay port (draft-ietf-dhc-relay-port-10.txt)
302 feature for DHCPv4, DHCPv6 and DHCPv4-over-DHCPv6. Relay port has to be
303 enabled at compile time via --enable-relay-port and is fully backward
304 compatible (i.e. works with previous implementations of servers and relays
305 using the standard ports). A new --rp <relay-port> command line option
306 specifies to dhcrelay an alternate source port for upstream (i.e. toward
307 the server) messages. Thanks to Naiming Shen and Enke Chen of Cisco
308 systems for submitting these patches.
311 - Added --release-on-roam to dhcpd server. When enabled and the server detects
312 that a DHCPv6 client (IAID+DUID) has roamed to a new network, it will release
313 the pre-existing leases on the old network and emit a log statement similar
316 "Client: <id> roamed to new network, releasing lease: <address>"
318 The server will carry out all of the same steps that would normally occur
319 when a client explicitly releases a lease. This behavior is disabled by
320 default and may only be specified globally. Prior to this the server renders
321 the leases unavailable until they expire or the server is restarted. Clients
322 that need leases in multiple networks must supply a unique IAID in each IA.
323 When release-on-roam is disabled (the default) the server maintains the
324 prior behavior of making such leases unavailable until they expire or the
325 server is restarted. Clients that need leases in multiple networks must
326 supply a unique IAID in each IA. This parameter may only be specified at
327 the global level. Thanks to Fernando Soto from BlueCat Networks for
328 suggesting this change.
332 - Support for delayed-ack is now compiled in by default. Prior to this
333 it had to be enabled at compile time via --enable-delayed-acks. The
334 default value for delayed-ack, however, has been changed from 28 to 0
335 (i.e. disabled). This was done to minimize the impact on users not
336 currently using the feature. Please note that the delayed-ack feature
337 is not currently compatible with support for DHPCv4-over-DHCPv6 so
338 when a 4to6 port command line argument enables this in the server the
339 delayed-ack value is reset to 0.
342 - The server (-6) now honors the parameter, update-static-leases, for static
343 (fixed-address6) DHCPv6 leases. It is worth noting that because stateful
344 data is not retained by the server for static leases, each time a client
345 requests or renews a static lease, the server will perform DDNS updates for
346 it. This may have significant performance implications for environments
347 with many clients that request or renew static leases often. Similarly,
348 the DNS entries will not be removed by server when a client issues a RELEASE
349 nor if the lease is deleted from the configuration. In such cases the DNS
350 entries must be removed manually. This feature is disabled by default.
351 Thanks to both Bill Shirley and dgutier-at-cern-dot-ch for requesting
357 - Added to the server (-6) a new statement, local-address6, which specifies
358 the source address of packets sent by the server. An additional flag,
359 bind-local-address6, disabled by default, binds the service socket to
360 to local-address6. Note that bind-local-address does not work with direct
361 clients: a relay has to forward packets to the server using the
362 local-address6 destination.
365 Changes since 4.4.0a1 (Bugs)
367 - The server now recognizes environment variables PATH_DHCPD_DB and
368 PATH_DHCPD_PID. These had been incorrectly compiled out of the code
369 unless DHCPv6 support was disabled. Additionally, the server man
370 pages were corrected to accurately reflect how the server chooses
371 file names (see lease-file-name and pid-file-name statements). Thanks
372 to Fernando Soto at Bluecat Networks for bringing this matter to our
376 - Removed an "Impossible condition" error upon exit in the dhcpd server that
377 has been shutdown via OMAPI. This condition was only apparent under Solaris
378 when building with --enable-use-sockets and --enable-ipv4-pktinfo.
381 - Corrected some minor Coverity issues: CID 1426059, 1426058, and 1426057.
384 - Added missing text to dhclient.8 and expanded release note coverage
385 for --address-prefix-len changes.
387 Changes since 4.3.6 (New Features)
389 - Added --enable-bind-install to install embedded bind includes and
390 libraries. Default is to not install them (it was the previous
391 behavior). If you'd like to change the includedir and/or libdir
392 installation directories to something different than for ISC DHCP
393 you must pass them using the --with-bind-extra-config configuration
397 - Added support of dynamic shared libraries with libtool. A new
398 --enable-libtool configuration parameter is available but
399 should not be used directly: *please* read the build configuration
400 section in the README file for the recommended procedure.
403 - IPv6 operation now supports an EUI-64 based address allocation which will
404 calculate addresses for clients with EUI-64 DUIDs based on those DUIDs when
405 enabled by setting use-eui-64 true. The parameter may defined down to the
406 pool scope. Note this feature must be compiled in by defining EUI_64 in
407 includes/site.h. This flag is undefined by default.
410 - The directory includes/isc-dhcp and it's only occupant, dst.h, have
411 been removed from the source tree. They are obsolete for branches
415 - Replaced ISC licensing with Mozilla Public License, MPL 2.0 licensing
416 throughout. Please see https://www.mozilla.org/en-US/MPL/2.0/ to read
417 the MPL 2.0 license terms.
420 - Load balancing for failover peers can now be disabled by setting
421 "load balance max secs" to 0. Doing so for both peers means both
422 servers will respond to all DHCPDISCOVERs or DHCPREQUESTs as soon as
426 - Added a new dhclient command line parameter, --prefix-len-hint <length>.
427 When used in conjunction with -P, it directs dhclient to use the given
428 length as the prefix length hint when requesting prefixes. Thanks to both
429 Indy, of the FireballISO open source project and H. Peter Anvin for
430 suggesting this change.
436 - dhclient will now wait for 10 seconds after declining an IPv4 address
437 before issuing a discover. This is in keeping with RFC 2131, section 3.1.5.
438 Prior to this dhclient did not wait at all. The amount of time dhclient
439 waits can be specified via a new command line parameter:
440 --decline-wait-time <seconds>. A value of zero equates to no wait at all.
441 Thanks to Pavel Kankovsky for bringing this matter to our attention.
442 **NOTE: THIS IS CHANGE IN DEFAULT BEHAVIOR.
445 - dhclient will now include the lease address when logging DHCPOFFERs,
446 DHCPREQUESTs, DHCPACKs, DHCPRELEASEs, and DHCPDECLINEs. Additionally,
447 DHCPOFFERs will be logged before their corresponding DHCPREQUESTs are
451 - When given the -T command line argument, in addition to reading the
452 current lease file, the server will write the leases to a temporary
453 lease file. This can help detect issues in server configuration that
454 only surface when leases are written to the file. The current lease
455 file will not be modified and the temporary lease file is removed upon
456 completion of the test.
459 - dhclient will now generate a DHCPv6 DECLINE message containing all IA_NA
460 addresses which for which the client script indicates a DAD failure. After
461 receiving the DECLINE reply, dhclient will restart the solicit process.
462 Note, the client script must exit with a value of 3 to signify that the
463 address failed DAD. Thanks to Jiri Popelka of Red Hat for submitting the
464 patch that was the foundation for this change.
465 **NOTE: THIS IS CHANGE IN DEFAULT BEHAVIOR.
470 - Replaced compilation option, enable-secs-byteorder, with a run-time, server
471 configuration parameter, check-secs-byte-order. When enabled, the
472 server will check for clients that do the byte ordering on the secs field
473 incorrectly. This field should be in network byte order but some clients
474 get it wrong. When this parameter is enabled the server will examine the
475 secs field and if it looks wrong (high byte non zero and low byte zero) swap
476 the bytes. The default is disabled. This parameter is only useful when
477 doing load balancing within failover.
480 - The default value for server (-6) parameter, prefix-length-mode, has been
481 changed from "exact" to "prefer". In "prefer" mode the server will offer
482 the first available prefix with the same length as that requested by the
483 client. If none are found then it will offer the first available prefix of
484 any length. This is more in line with with RFC 8168 and should improve
485 the out-of-the-box user experience.
486 **NOTE: THIS IS CHANGE IN DEFAULT BEHAVIOR.
489 - Added support for 'dhcp-cache-threshold' to IPv6 operation: If a client
490 renews before 'dhcp-cache-threshold' percent of its lease has elapsed
491 (default 25%), the server will reuse the allocated lease (provide a
492 lease within the currently allocated lease-time) rather than extend or
493 renew the lease. This allows the server to reply without needlessly
494 writing leases to disk. The preferred and valid lease lifetimes
495 sent to the client will be reduced by the age of the lease. The option
496 may be specified down to the pool level and is supported for all three
497 pool types: NA, TA, and PD.
500 - Added three new server configuration parameters which influence DDNS:
501 1. ddns-dual-stack-mixed-mode - alters DNS conflict resolution behavior
502 to mitigate issues with non-compliant clients in dual stack environments.
504 2. ddns-guard-id-must-match - relaxes the DHCID RR client id matching
505 requirement of DNS conflict resolution.
507 3. ddns-other-guard-is-dynamic - alters dual-stack-mixed-mode behavior to
508 allow unguarded DNS entries to be overwritten in certain cases
513 - A "key-algorithm <algorithm>" statement has been added to omshell to
514 allow the specification of the key algorithm to use during transaction
515 authentication. Prior to this it was hard-coded to be hmac-md5. It now
516 supports all of the same algorithms as the dhcpd server: hmac-md5 (the
517 default), hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, and hmac-sha512.
520 - Added a server configuration parameter, persist-eui-64-leases, which
521 determines whether or not EUI-64 based leases are written to the
522 leases file. Default is true.
525 - Changed the default value of the prefix length passed by dhclient into the
526 client script for each IPv6 address from 64 to 128. This was done to comply
527 with RFC3315bis draft (-09, page 64) and RFC5942, Section 4, point 1.
528 In addition, dhclient now supports a command line argument,
529 --address-prefix-len, which may be used to override the default value.
530 **WARNING**: This change may not be backwardly compatible with your
531 environment. If you are operating without a router, such as between VMs on
532 a host, you may find they cannot see each with prefix length of 128. In
533 such cases, you'll need to either provide routing or use the command line
534 parameter to set the value to 64. Alternatively you may change the default
535 at compile time by setting DHCLIENT_DEFAULT_PREFIX_LEN in includes/site.h.
539 - Modified dhclient (-6) to bypass sending a confirm (INIT REBOOT) when it has
540 only expired address associations. Thanks to Jiri Popelka at Red Hat for
541 raising the issue and submitting the patch.
543 Changes since 4.3.6 (Bugs):
545 - Corrected an issue where the server would return a client's previously
546 released prefix lease even when the client provides a prefix length
547 hint that does not match the prior lease. Now the server will only
548 return the previous lease if it exactly matches the hint. If not
549 it will attempt to allocate a new prefix based on the hint and the
550 prefix-length-mode. Thanks to Tim DeNike - Lightspeed Communications
551 for pointing out the error of our ways.
554 - Added explicit include of BIND9 isc/util.h to adapt to revisions
555 in BIND9 (see BIND9 ticket #46311). Prior to this the build was failing
556 with implicit function declarations errors for POST() and INSIST().
559 - Added to code ignore empty IPv4 host name option (code 12). While RFC 2132
560 states the option cannot be empty, some clients are apparently capable of
561 sending it. Prior to this the server was attempting to use it and store it
562 in the lease file causing issues with DDNS and so forth.
565 - Corrected dhclient command line parsing for --dad-wait-time that causes
566 even valid values to fail as invalid on some environments.
569 - Replaced iasubopt::heap_index with separate values for active and inactive
570 heaps: iasubopt::active_index and iasubopt::inactive_index. This was done
571 to accommodate a change in behavior in BIND9 isc_heap_delete().
574 ! Plugged a socket descriptor leak in OMAPI, that can occur when there is
575 data pending to be written to an OMAPI connection, when the connection
576 is closed by the reader. Thanks to Pavel Zhukov at RedHat for bringing
577 this issue to our attention and whose patch helped guide us in the right
581 - The ability of the server to send back dhcp6.vendor-opts values has been
582 restored. A change in 4.3.5 (see #29246) which enabled it to send back the
583 FQDN option unfortunately broke its ability send back dhcp6.vendor-opts.
584 Thanks to Sumant Gupta (sumantgupta at gmail dot com) of Landis+Gry for
585 bringing this issue to our attention.
588 Changes since 4.3.6b1
594 - The server now allows the client identifier (option 61) to own leases
595 in more than one subnet concurrently. Prior to this the server would
596 incorrectly release an existing lease in one subnet prior to assigning
597 a lease in another subnet. Note that the prior behavior can be still
598 be achieved by enabling one-lease-per-client. Thanks to both David Zych at
599 the University of Illinois and Norm Proffitt of Infoblox for reporting
600 the issue; and Norm for suggesting a solution.
603 - When replying to a DHCPINFORM, the server will now include options specified
604 at the pool scope, provided the ciaddr field of the DHCPINFORM is populated.
605 Prior to this the server only evaluated options down to the subnet scope.
606 Thanks to Fernando Soto at BlueCat Networks for reporting the issue.
610 - When memory allocation fails in a repeated way the process writes
611 "Run out of memory." on the standard error and exists with status 1.
614 - The new lmdb (Lightning Memory DataBase) bind9 configure option is
615 now disabled by default to avoid the presence of this library to be
616 detected which can lead to a link failure.
619 - The linux interface discovery code has been modified to use getifaddrs()
620 as is done for BSD and OS-X. Prior to this the code would only recognize
621 the first address on an interface and thereby omit vlans.
622 Thanks to Jiri Popelka at Redhat, Marius Tomaschewski at SUSE, and Wei
623 Kong at Novell, who all submitted patches.
630 - Fixed a bug in OMAPI that causes omshell to crash when a name-value
631 pair with a zero length value is shipped in an object. Thanks to
632 Fernando Soto at BlueCat Networks for reporting the issue and
636 - On 64-bit platforms, dhclient now generates the correct value for the
637 script environment variable, "expiry", the lease expiry value exceeds
638 0x7FFFFFFF. Prior to this such values would produce negative values
639 for expiry in the script environment.
642 - Common timer logic was modified to cap the maximum timeout values at
643 0x7FFFFFFF - 1. Values larger than that were causing fatal timer out of
644 range errors on 64-bit platforms. Thanks to Jiri Popelka at Red Hat for
648 - DHCP6 FQDN option unpacking code now correctly handles values that contain
649 spaces, special, or non-printable characters. Prior to this the buffer
650 size needed was underestimated causing a conversion error message to
651 be logged and DNS updates to be skipped. Thanks to Fernando Soto at
652 BlueCat Networks for bringing the matter to our attention.
655 - When running in -6 mode, dhclient can enforce the require option statement
656 and will discard offered leases that do not contain all the required
657 options specified in the client configuration. If not enabled the client
658 will still consider such leases. This must be enabled at compile time
659 (see ENFORCE_DHCPV6_CLIENT_REQUIRE in includes/site.h). Thanks to
660 Mritunjaykumar Dubey at Nokia for reporting the issue.
663 - Altered DHCPv4 lease time calculation to avoid roll over errors on 64-bit
664 OS systems when using -1 or large values for default-lease-time. Rollover
665 values will be replaced with 0x7FFFFFFF - 1. This alleviates unintentionally
666 short expiration times being handed out when infinite lease times (-1) in
667 conjunction with failover. Our thanks to Alessandro Gherardi for bringing
668 the issue to our attention.
671 - Added new compile time option --with-srv-conf-file which specifies a
672 default location of the server configuration file.
675 - Added --dad-wait-time parameter to dhclient. It specifies the maximum time,
676 in seconds, that the client process should wait for the duplicate address
677 detection to complete before initiating DHCP requests. This value is
678 propagated to the dhclient script and the script is responsible for waiting
679 the specified amount of time or until DAD has completed. If the script does
680 not support it, specifying this parameter has no effect. The default value
681 is 0 which specifies that the script should not wait for DAD. With this
682 change the following scripts have been modified to support the new parameter:
683 freebsd, linux, macos, netbsd, openbsd.
686 - The server nows checks both the address and length of a prefix delegation
687 when attempting to match it to a prefix pool. This ensures the server
688 responds properly when pool configurations change such that once valid,
689 "in-pool" delegations are now treated as being invalid. During lease
690 file loading at startup, the server will discard any PD leases that
691 are deemed "out-of-pool" either by address or mis-matched prefix length.
692 Clients seeking to renew or rebind such leases will get a response of
693 No Binding in the case of the former, and the prefix delegation with
694 lifetimes set to zero in the case of the latter. Thanks to Mark Nejedlo
695 at TDS Telecom for reporting this issue.
698 - Modified DDNS support initialization such that DNS related ports will only be
699 opened by the server (dhcpd) at startup if ddns-update-style is not "none";
700 by dhclient only if and when the it first attempts an update; and never by
701 dhcrelay. Prior to this all three always did the initialization at startup
702 which causes them to always open on and listen for traffic on two random
703 ports. Thanks to Rodney Beede for reporting this issue.
707 - Added error logging to two memory allocation failure checks. Thanks to Bill
708 Parker (wp02855 at gmail dot com) for reporting the issue.
711 - Corrected a dhclient -6 issue that caused the client to crash with an
712 "Impossible condition" error after de-preferencing its only IA binding.
713 The crash occurred when server configuration changes rendered the existing
714 binding out-of-range and no other leases were available to offer. Thanks
715 to Pierre Clerissi for bringing this issue to our attention.
718 - By defining CALL_SCRIPT_ON_ONETRY_FAIL in includes/site.h, dhclient will
719 now call the script with reason set to FAIL when run with -1 (one try) and
720 there are no server responses. This applies to IPv4 mode only. Thanks for a
721 patch by Martin Pitt which got to us via Andrew Pollock.
724 - The server now detects failover peers that are not referenced in at least
725 one pool when run with the command line option for test mode, -T. Prior to
726 this the check was performed too far down stream to be detected in test mode.
729 - Linux script updated. The script is now based on Debian version. It uses
730 ip tool from iproute2 package and ifconfig is no longer used. This also
731 addresses an issue of calling arping with inappropriate parameter.
735 - Changed severity of the log message indicating UDP checksum errors in
736 the received packets from 'info' to 'debug' to avoid logging excessive
737 number of false positives when UDP checksum offloading is enabled.
740 - The directory minires has been removed from the source tree. It has
741 long been obsolete for branches other than v4_1_esv. Additionally,
742 includes/minires.h was renamed includes/ns_name.h.
745 - Replaced ifconfig parameters "add" and "delete" with "alias" and "-alias"
746 for IPv6 mode in the client scripts, netbsd and openbsd. This was
747 preventing IPv6 addresses from being added or removed from interfaces.
748 Thanks to Tim Dean for reporting this issue.
751 Changes since 4.3.5b1
753 - Corrected a bug which could cause the server to sporadically crash while
754 loading lease files with the lease-id-format is set to "hex". Our thanks
755 to Jay Ford, University of Iowa for reporting the issue.
758 - Eliminated a noisy, but otherwise harmless debug log statment that may
759 appear during server startup when building with --enable-binary-leases
760 and configuring multiple pools in a shared network. Thanks to Fernando
761 Soto from BlueCat Networks for reporting the issue and supplying a patch.
766 - Fixed util/bindvar.sh error handling.
769 - Correct error message in relay to use remote id length instead
770 of circuit id length.
773 - Add logic to test directory Makefiles to avoid copying Attfile(s)
774 when building within the source tree. This eliminates a noisy but
775 otherwise harmless error message when running "make check".
778 - Leases are now scrubbed of certain prior use information when pool
779 re-balancing reassigns them from one FO peer to the other. This
780 corrects an issue where leases that were offered but not used
781 by the client retained the client hostname from the original
782 client. Thanks to Pavel Polacek, Jan Evangelista Purkyne University
783 for reporting the issue.
786 - In the LDAP code and schema add some missing '6' characters to use
787 the v6 instead of the v4 versions. Thanks to Denis Taranushin for
788 reporting this issue and supplying its patch.
791 - Correct how the pick-first-value expression is written to a lease
792 file. Previously it was written as a concat expression due to
793 a cut and paste error.
796 - Modify the DDNS code to clean up the PTR record even if there
797 are issues while cleaning up the A or AAAA records.
800 - Added global configuration parameter, abandon-lease-time, which determines
801 the amount of time a lease remains abandoned. The default is 84600 seconds.
802 Additionaly, the server now conducts a ping check (if ping checks are
803 enabled) prior to offering an abandoned lease to client. Our thanks to
804 David Zych at University of Illinois for reporting the issue and working
805 with us to produce a viable solution.
808 - Correct handling of interface names during interface discovery. This
809 addresses an issue where interface names of 15 characters in length
810 could lead to crashes or interface recognition errors during startup
811 of dhcpd, dhclient, and dhcrelay.
814 - Updates to contrib/dhcp-lease-list.pl to make it more friendly.
815 The updates are: looking for the lease file in more places and skipping
816 the "processing complete" output when creating machine readable
817 output. Thanks to Cameron Paine (cbp at null dot net) for the
821 - When reusing a lease for dhcp-cache-threshold return the hostname
822 to the original lease. Also if the host pointer, UID or hardware address
823 change don't allow reuse of the lease.
824 Thanks to Michael Vincent for reporting this and helping us
825 verify the problem and fix.
828 - Change dmalloc to use a size_t as the length argument to bring it
829 in line with the call it will make to malloc().
832 - If the failover socket can't be bound, close it. Otherwise if the
833 user configures an incorrect address in the failover stanza the
834 server will continue to open new sockets every 90 seconds until
838 - Add DHCPv4-mode, dhcrelay command line options, "-iu" and "-id", that
839 allow interfaces to be upstream or downstream respectively. Upstream
840 interfaces will accept and forward only BOOTP replies, while downstream
841 interfaces will accept and forward only BOOTP requests.
844 - Clean up some memory references in the vendor-class construct.
847 Changes since 4.3.4b1
853 - Corrected a static analyzer warning in common/execute.c
856 - ISC DHCP now follows the common convention to use the base name a
857 program is invoked with (aka argv[0], vs. a builtin name) for
858 logs. This should help differentiate syslog entries for DHCPv4 and
859 DHCPv6 servers. You can define OLD_LOG_NAME in includes/site.h to
860 keep the previous behavior.
863 - The Linux packet filter code now correctly treats only the least significant
864 12 bits in an inbound packet's TCI value as the VLAN id (per IEEE 802.1Q).
865 Prior to this it was using the entire 16 bit value as the VLAN id and
866 incorrectly discarding packets. Thanks to Jiri Popelka at Red Hat for
867 reporting this issue and supplying its patch.
870 - Fixed several static analysis issues such as potential null
871 references, unchecked strdup returns. Thanks to Bill Parker (wp02855 at
872 gmail dot com) who identified these issues and supplied patches to
877 - Corrected compilation errors that prohibited building the server
878 and its ATF unit tests when failover is disabled.
881 - Added the lease address to the end of the debug level log message
882 emitted when an existing lease is renewed within the dhcp-cache-threshold.
883 Thanks to Nathan Neulinger at Missouri S&T for suggesting the change.
886 - Added dhcpv6 and delayed-ack to settings listed in the "Features:"
887 section of the configure script output. Additionally, all of the
888 features reported on will now always show either a "yes" or "no"
889 value. Prior to this features left to their default setting would
893 - Added a parameter, authoring-byte-order, to the lease file. This value
894 is automatically added to the top of new lease files by the server and
895 indicates the internal byte order (big endian or little endian) of the
896 server. This permits lease files generated on a server with one form of
897 byte order to be used on a server with the opposite form. Our thanks to
898 Timothe Litt for calling this to our attention and for the suggestions
902 - Fixed a small memory leak in the DHCPv6 version of the client code.
903 This is unlikely to cause significant issues in actual use.
906 - Corrected a few minor memory leaks in omapi's dereferencing of
907 host objects. Thanks to Jiri Popelka at Red Hat for reporting
908 the issue and supplying the patches.
912 - Cleaned up some of the Make infrastructure to make --with-libbind
913 work better. Though it still only works with an absolute path.
916 - Made the embedded bind libraries able to be cross compiled
917 (please refer to the bind9 documentation to learn how to cross
918 compile DHCP and its bind library dependency).
921 - Update the client code to better support getting IA_NAs and IA_PDs
922 in the same packet, see RFC7550 for some discussion.
925 ! Update the bounds checking when receiving a packet.
926 Thanks to Sebastian Poehn from Sophos for the bug report and a suggested
931 - When handling an incorrect command line for dhcpd, dhclient or dhcrelay
932 print out a specific error message about the first error in addition
933 to the usage string. This may be disabled by editing includes/site.h.
937 - The configure script will now exit with an error message if it cannot find
938 a GNU-style make tool (needed when building BIND libraries) or pkg-config
939 (needed to locate ATF used for building unit tests). Prior to this the
940 script would exit indicating success causing subsequent attempts to build
941 the software to fail.
944 - Properly terminate strings before passing them to regex and fix
945 a boundary error when creating certain new data strings.
946 Thanks to Andrey Jr. Melnikov for the bug report.
949 - Option expressions, such as prepend and append, are now supported when
950 running dhclient for IPv6. Prior to this such statements in the
951 client configuration file would be parsed but have no affect. Thanks
952 to Jiri Popelka at Red Hat for reporting the issue.
955 - A failover primary server will now accept a binding status update from the
956 secondary which transitions a lease from ACTIVE to ABANDONED. This accounts
957 for instances in which a client declines a lease and only the secondary
958 server receives it. Prior to this the primary server would reject such an
959 update as an "invalid state transition".
962 - Properly allocate memory for a bpf filter.
963 Thanks to Bill Parker (wp02855 at gmail dot com) who identified this issue.
966 - Updated contrib/dhcp-lease-list.pl to handle garbage in the oui file better
967 and to print out the hostnames a bit better.
968 Thanks to Antoine Beaupré from Debian for the suggested patch.
971 - The DHCPv6 server now handles long valid and preferred lease times better.
972 Values that would cause the internal end time of the lease to wrap are
973 modified to work as infinite.
976 - Updated support for cross compiling by allowing the library archiver
977 to be set at configure time via the environment variable 'AR'.
980 - The server will now match DHCPv6 relayed clients to host declarations
981 which include the "hardware" statement, if the relay connected to the
982 client supplies the client's hardware address via client-linklayer-address
983 option as per RFC 6939.
986 - Allow a filename to be specified instead of /dev/random during
987 configuration. This is passed to the BIND configuration to allow
988 for cross compilation.
991 - Add more option definitions.
994 - Correct outputting of long lines in the lease file when writing
995 a lease that includes long strings in an execute statement.
998 - The server will now correctly treat a lease as reserved when the client
999 requests an infinite lease time (i.e. OxFFFFFFFF) and "infinite-is-reserved"
1000 is enabled. Prior to this the server would halt. In addition, corrections
1001 were made to the server to allow a lease's flags field to be set via omapi.
1002 Prior to this, the server, depending on the host architecture, would
1003 incorrectly parse the new flags value from the omapi message.
1006 - ISC DHCP can now be configured and built from a directory other than
1007 the top level source directory. Note that "make distcheck" uses this
1011 - Add support for RFC 3527 to dhcrelay. A new, dhcrelay command line argument,
1012 "-U <interface>" enables the addition of a RFC 3527 compliant link selection
1013 suboption to the agent option added for clients directly connected to the
1018 - Add a new global DHCPv6 option, dhcpv6-set-tee-times, which when enabled
1019 instructs the server to calculate T1 and T2 as recommended in RFC 3315,
1023 - Corrected minor Coverity issues.
1026 - Add support for RFC 7341 DHCPv4 over DHCPv6 with a new configuration
1027 option "--enable-dhcpv4o6". Note this feature requires DHCPv6 support
1028 and is not compatible with delayed-ack. Both client and server use 2
1029 processes which communicate over UDP on a pair of sockets. The new
1030 "-4o6 <port>" command line argument enables DHCPv4 over DHCPv6 support
1031 and specifies the consecutive ports to use for inter-process communication.
1032 Please look at doc/DHCPv4-over-DHCPv6 for more details.
1035 - Correct interface name formation when using DLPI under Solaris 11. As of
1036 Solaris 11, ethernet device files are located in "/dev/net". The configure
1037 script has been modified to detect this situation and adjust the directory
1038 used accordingly. Thanks to Jarkko Torppa for reporting this issue and
1043 - Add a dereference call when handling an error condition while
1047 - Add a new parameter, lease-id-format, to both dhcpd and dhclient. The
1048 parameter controls the format in which certain values are written to lease
1049 files. Formats supported are octal - quoted string containing octal
1050 escapes, and hex - unquoted, colon separated hex digits. Thanks to
1051 Jay Ford, University of Iowa for bringing the issue to our attention.
1054 ! Add an option in site.h to limit the number of failover and control
1055 connections the server will accept. By default this is 200.
1059 Changes since 4.3.3b1
1065 - The server now does a better check to see if it can allocate the memory
1066 for large blocks of v4 leases and should provide a slightly better error
1067 message. Note well: the server pre-allocates v4 addresses, if you use
1068 a large range, such as a /8, the server will attempt to use a large
1069 amount of memory and may not start if there either isn't enough memory
1070 or the size exceeds what the code supports.
1073 - The server will now reject unicast Request, Renew, Decline, and Release
1074 messages from a client unless the server would have sent that client the
1075 dhcp6.unicast option. This behavior is in compliance with paragraph 1 in
1076 each of the sections 18.2,1, 18.2.3, 18.2.6, and 18.2.7 of RFC 3315. Prior
1077 to this, the server would simply accept the messages. Now, in order for
1078 the server to accept such a message, the server configuration must include
1079 the dhcp6.unicast option either globally or within the shared network to
1080 which the requested lease belongs. In other words, the server will map
1081 the first IA_XX address found within the client message to a shared-network
1082 and look for the presence of the unicast option there and then globally.
1083 Thanks to Jiri Popelka at Red Hat for this issue and his patch which
1087 - The ATF (Automated Testing Framework) tools used for optional unit tests
1088 can now be built from its embedded sources in bind, solving the
1089 atf-run / atf-report issue with recent (>= 0.20) versions of ATF.
1090 The new configuration option is "./configure --with-atf=bind".
1091 [ISC-Bugs #38754, #39300]
1093 - Corrected a compilation error introduced by the fix for ISC-Bugs #22806.
1094 On older linuxes that do not include the tpacket_auxdata structure don't
1095 bother allocating the cmsgbuf as it isn't necessary and we don't have
1096 a proper length for it.
1099 - Remove the dst directory. This was replaced in 4.2.0 with the dst
1100 code from the Bind libraries but we continued to include it for
1101 backwards compatibility. As we have now released 4.3.x it seems
1102 reasonable to remove it.
1105 - Write out the DUID server id on startup in all cases, previously if it
1106 was read in from server-duid option in the config or lease files for
1107 DHCPv4 it would not be written to the new lease file.
1110 - When parsing dates for leases convert dates past 2038 to "never".
1111 This avoids problems with integer overflows in the date and time
1112 handling code for people that decide to use very large lease times
1113 or add a lease entry with a date far in the future.
1116 - Leave the siaddr field clear when sending a NACK as per RFC 2131
1120 - In the client don't send expired addresses to the script as part of
1121 the binding process. Thanks to Sven Trenkel at Google for reporting
1122 the issue and suggesting the patch.
1125 - While parsing IPv6 addresses treat "add" as part of the address instead
1129 - Add support for accessing the v4 lease queues (active, free etc) in a
1130 binary fashion instead of needing to walk through a linear list to
1131 insert, find or remove an entry from the queues. In addition add a
1132 compile time option "--enable-binary-leases" to enable the new code
1133 or to continue using the old code. The old code is the default.
1134 Thanks to Fernando Soto from BlueCat Networks for the patch.
1137 - Delayed-ack now works properly with Failover. Prior to this, bind updates
1138 post startup were being queued but never delivered. Among other things, this
1139 was causing leases to not transition from expired or released to free.
1142 - Clean up parsing of v6 lease files a bit to avoid infinite loops if the
1143 lease file is corrupt in certain ways.
1146 - Corrected a crash in dhclient that occurs during lease renewal if the
1147 client is performing its own DNS updates. Thanks to Jiri Popelka at Red Hat
1151 - Corrected an issue in v6 lease file parsing. Prior to this, when encountering
1152 a lease with an address for which no configured pool exists, the server was
1153 declaring the lease file corrupt and incorrectly skipping over the subsequent
1154 entry in the file. The server will now emit a log message indicating that
1155 no pool was found for the address (or prefix) and correctly resume parsing
1156 with the next entry in the lease file. Our thanks to Michal Žejdl for
1157 reporting the issue.
1160 - Be more liberal in finding a subnet group associated with a static
1161 prefix. When we added the class matching code for v6 we also added
1162 a requirement that the static prefix must be within a subnet the
1163 client was in, in order to find the proper statements. We now
1164 look for a subnet based on the prefix, failing that on the static
1165 address for the client and failing that on the shared network
1169 - Add a new action expression "parse_vendor_options", which can be used
1170 to parse a vendor-encapsualted-option received by the server based on
1171 the encoding specified by the vendor-option-space statement.
1174 - Enhance the PARANOIA patch to include fchown() the lease file to
1175 allow it to be manipulated after the server does a chown().
1176 Thanks to Jiri Popelka at Red Hat for the patch.
1179 - Relax the requirement that prefix pools must be within the subnet.
1180 This was added in as part of #32453 in order to avoid configuration
1181 mistakes but is being removed as prefixes aren't required to be
1182 within the same subnet and many people configure them in that fashion.
1185 - Fixed a server crash that could occur when the server attempts to remove
1186 the billing class from the last lease billed to a dynamic class after said
1187 class has been deleted. Our thanks to Lasse Pesonen for reporting the
1191 - LDAP Patches - Numerous small patches submitted by contributors have
1192 been applied to the contributed code which supplies LDAP support.
1193 In addition, two larger submissions have also been included. The
1194 first adds support for IPv6 configuration and the second provides
1195 GSSAPI authentication. We would like to thank the following for their
1196 contributions (alphabetically):
1198 Bill Parker (wp02855 at gmail dot com)
1199 Jiri Popelka at Red Hat
1200 Marius Tomaschewski at SUSE
1201 (william at adelaide.edu.au), The University of Adelaide
1217 - Handle an out of memory condition in the client a bit better.
1218 Thanks to Frédéric Perrin from Brocade for finding the issue
1219 and suggesting a patch.
1222 Changes since 4.3.2rc2
1225 Changes since 4.3.2rc1
1227 - Corrected a compilation error introduced by the fix for ISC-Bugs #37415.
1228 The error occurs on Linux variants that do not support VLAN tag information
1229 in packet auxiliary data. The configure script now only enables inclusion
1230 of the VLAN tag-based logic if it is supported by the underlying OS.
1233 Changes since 4.3.2b1
1235 - Specifying the option, --disable-debug, on the configure script command line
1236 now disables debug features. Prior to this, specifying --disable-debug
1237 incorrectly enabled debug features. Thanks to Gustavo Zacarias for reporting
1241 - Unit test execution now uses a path augmented during configuration
1242 processing of the --with-atf option to locate ATF runtime tools, atf-run
1243 and atf-report. For most installations of ATF, this should alleviate the
1244 need to manually include them in the PATH, as was formerly required.
1245 If the configure script cannot locate the tools it will emit a warning,
1246 informing the user that the tools must be in the PATH when running unit
1248 Secondly, please note that "make check" will now exit with a failure status
1249 code (non-zero) if one or more unit tests fail. This means that invoking
1250 "make check" from an upper level directory will cause the make process to
1251 STOP after the first test subdirectory with failed test(s). To force all
1252 tests in all subdirectories to run, regardless of individual test outcome,
1253 use the command "make -k check".
1258 - Corrected parser's right brace matching when a statement contains an error.
1261 - TSIG-authenticated dynamic DNS updates now support the use of these
1262 additional algorithms: hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384,
1266 - Added check for invalid failover message type. Thanks to Tobias Stoeckmann
1267 working with the OpenBSD project who spotted the issue and provided the
1271 - Corrected rate limiting checks for bad packet logging. Thanks to Tobias
1272 Stoeckmann working with the OpenBSD project who spotted the issue and
1276 - Log statements depicting what files will be used by the server now occur
1277 after the configuration file has been processed.
1280 - Addressed Coverity issues reported as of 07-31-2014:
1281 [ISC-Bugs #36712] Corrects Coverity reported "high" impact issues.
1282 [ISC-Bugs #36933] Corrects Coverity reported "medium" impact issues
1283 [ISC-Bugs #37708] Fixes compilation error in dst_api.c seen in older
1284 compilers that was introduced by #36712
1286 - Server now supports a failover split value of 256.
1289 - Remove unneeded error #defines. These defines were included in case
1290 external programs required the older versions of the macro. They
1291 have been #ifdeffed for now and will be removed at a future date.
1292 See site.h for the #define to include them again, but you should
1293 switch to using the DHCP_R_* versions instead of the ISC_R_* versions.
1294 Also ISC_R_MULTIPLE has been removed as it is also defined in bind.
1297 - Added checks in range6 and prefix6 statement parsing to ensure addresses
1298 are within the declared subnet. Thanks to Jiri Popelka at Red Hat for the
1299 bug report and patch.
1306 - Addressed checksum issues:
1307 Added checksum readiness check to Linux packet filtering which eliminates
1308 invalid packet drops due to checksum errors when checksum offloading is
1309 in use. Based on dhcp-4.2.2-xen-checksum.patch made to the Fedora project.
1316 Inbound packets with UDP checksums of 0xffff now validate correctly rather
1321 - Added the echo-client-id configuration parameter to the server configuration.
1322 The server now supports RFC 6842 compliant behavior by setting a new
1323 configuration parameter, echo-client-id. When enabled, the server will
1324 include the client identifier option (Option code 61) if received, in its
1325 responses. The server identifier returned in NAKs (if enabled) will now
1326 be the globally defined value (if one) if the server cannot attribute the
1327 inbound request to a known subnet.
1331 - Added support of the configuration parameter, use-host-decl-names, to
1332 BOOTP request handling.
1335 - Added logic to ignore the signal, SIGPIPE, which ensures write failures
1336 will be delivered as errors rather than as SIGPIPE signals on all OSs.
1337 Thanks to Marius Tomaschewski from SUSE who reported the issue and provided
1338 the patch upon which the fix is based.
1341 - In the failover code, handle the case of communications being interrupted
1342 when the servers are dealing with POTENTIAL-CONFLICT. This patch allows
1343 the primary to accept the secondary moving from POTENTIAL-CONFLICT to
1344 RESOLUTION-INTERRUPTED as well as handling the bind update process better.
1345 In addition the code to resend update or update all requests has been
1346 modified to send requests more often.
1350 - By default, the server will now choose the value to use in the forward DNS
1351 name from the following in order of preference:
1353 1. FQDN option if provided by the client
1354 2. Host name option if provided by the client
1355 3. Configured option host-name if defined
1357 As before, this may be overridden by defining ddns-hostname to the desired
1358 value (or expression). In addition, the server logic has been extended to
1359 use the value of the host name declaration if use-host-decl-names is enabled
1360 and no other value is available.
1363 - DNS updates were being attempted when dhcp-cache-threshold enabled the use of
1364 the existing lease and the forward DNS name had not changed. This has been
1369 - Corrected an issue which caused dhclient to incorrectly form the result when
1370 prepending or appending to the IPv4 domain-search option, received from the
1371 server, when either of the values being combined contain compressed
1375 - Added the server-id-check parameter to the server configuration.
1376 This parameter allows run-time control over whether or not a server,
1377 participating in failover, verifies the dhcp-server-identifier option in
1378 DHCP REQUESTs against the server's id before processing the request.
1379 Formerly, enabling this behavior was done at compilation time through
1380 the use of the #define, SERVER_ID_CHECK, which has been removed from site.h
1381 The functionality is now only available through the new runtime parameter.
1384 - During startup, when the server encounters a lease whose binding state is
1385 FTS_BACKUP but whose pool has no configured failover peer, it will reset the
1386 lease's binding state to FTS_FREE. This allows the leases to be reclaimed
1387 by the server after a pool's configuration has changed from failover to
1388 standalone. Prior to this such leases would remain stuck in the backup state
1389 making them unavailable for assignment. Note this conversion will occur
1390 whether or not the server is compiled for failover.
1393 - Fixed a small issue in the treatment of hosts in the inform processing
1394 that could cause the response to an inform to include information from
1395 the wrong scope. The two examples we've heard of are getting subnet
1396 instead of group information associated with a host entry, or getting
1397 global information instead of subnet if the host entry was built via
1398 omapi. Thanks to Julien Soula at University of Lille for finding the
1399 bug and supplying a patch.
1402 - Avoid calling pool_timer() recursively from supersede_lease(). This could
1403 result in leases changing state incorrectly or delaying the running of the
1404 leae expiration code.
1407 - Move the check for a PID file and process to be before we rewrite the
1408 lease file. This avoids the possibility of starting a second instance
1409 of a server which changes the current lease file confusing the first
1410 instance. This check is only included if the admin hasn't disabled PID
1415 - In the client code change the way preferred_life and max_life are printed
1416 for environment variables to be unsigned rather than signed.
1417 Thanks to Jiri Popelka at Red Hat for the bug report and patch.
1420 - Modified Linux packet handling such that packets received via VLAN are now
1421 seen only by the VLAN interface. Prior to this, such packets were seen by
1422 both the VLAN interface and its parent (physical) interface, causing the
1423 server to respond to both. Note this remains an issue for non-Linux OSs.
1424 Thanks to Jiri Popelka at Red Hat for the patch.
1430 - Log content has been changed to more directly suggest that admins should
1431 check for multiple IPv6 clients attempting to use the same DUID when only
1432 abandoned addresses are available. Debug level logging will now emit counts
1433 of the total number of, in-use, and abandoned addresses in a shared subnet
1434 when the server finds no addresses available for a given DUID. Lastly,
1435 threshold logging is now automatically disabled for shared subnets whose
1436 total number of possible addresses exceeds (2^64)-1.
1440 - Added a global parameter, prefix-length-mode, which may be used to determine
1441 how the server uses a non-zero value for prefix-length supplied by clients
1442 when soliciting DHCPv6 prefixes. The server supports selection modes of:
1443 ignore, prefer, exact, minimum and maximum which are described in detail in
1444 the server man pages. The prior behavior of the server was to only offer a
1445 prefix whose length exactly matched the prefix-length value requested. If
1446 no such prefixes were available, the server returned a status of none
1447 available. Note the default mode, "exact", provides this same behavior.
1451 - Corrected inconsistencies in dhcrelay's setting the upper interface hop count
1452 limit such that it now sets it to 32 when the upstream address is a multicast
1453 address per RFC 3315 Section 20. Prior to this if the -u argument preceded
1454 the -l argument on the command line or if the same interface was specified
1455 for both; the logic to set the hop limit count for the upper interface was
1456 skipped. This caused the hop count limit to be set to the default value
1457 (typically 1) in the outbound upstream packets.
1460 Changes since 4.3.1b1
1462 - Modify the linux and openwrt dhclient scripts to process information
1463 from a stateless request. Thanks to Jiri Popelka at Red Hat for the
1464 bug report and patch.
1467 - Remove more unused RCSID tags. These weren't noticed in 4.3 as
1468 the code isn't used anymore but we remove them here to keep the
1469 code consistent across versions.
1474 - Tidy up several small tickets.
1475 Correct parsing of DUID from config file, previously the LL type
1476 was put in the wrong place in the DUID string.
1478 Add code to parse "do-forward-updates" as well as "do-forward-update"
1479 Thanks to Jiri Popelka at Red Hat.
1481 Remove log_priority as it isn't currently used.
1483 Increase the size of the buffer used for reading interface information.
1486 - Remove an extra set of the msg_controllen variable.
1489 - Add a more understandable error message if a configuration attempts
1490 to add multiple keys for a single zone. Thanks to a patch from Jiri
1494 - Fix some minor issues in the dst code.
1497 - Properly #ifdef functions so that the code can compile without NSUPDATE.
1500 - Update the partner's stos (start time of state, basically when we last
1501 heard from this partner) field when updating the state in failover.
1504 - Modify the overload processing to allow space for the remote agent ID.
1506 Handle the ordering of the SUBNET_MASK option even if it is the last
1510 - Remove the code that allows a server to follow RFC3315 instead of
1511 the subsequent errata from August 2010 when determining which IAs
1512 to include if no addresses will be assigned.
1515 - Remove unused RCSID tags.
1518 - Correct the v6 client timing code. When doing the timing backoff
1519 for MRT limit it to MRD.
1520 Thanks to Jiri Popelka at Red Hat for the bug report and fix.
1523 - Add a log entry when killing a client and remove the PID files
1524 when a server, relay or client are killed.
1528 - Some minor cleanups in the client code.
1529 In addition to checking for dhcpc check for bootpc in the services list.
1531 Correct the client code to only try to get a lease once when the
1532 given the "-1" argument.
1533 Thanks to Jiri Popelka at Red Hat for the bug report and fix.
1535 When asked for the version don't send the output to syslog.
1537 Add the next server information to the environment variables for
1538 use by the client script. In order to avoid changing the client
1539 lease file the next server information isn't written to it.
1540 Thanks to Tomas Hozza at Red Hat for the suggestion and a prototype fix.
1543 - Several updates to the dhcp server code.
1544 When not in quiet mode print out the files being used.
1546 As accessing some pid files may require privileges move the dropping
1547 of permission bits due to the paranoia patch to be after the pid code.
1548 Thanks to Jiri Popelka at Red Hat for the bug report and fix.
1550 When processing a "--version" request don't output the version information
1553 - Add the "enable-log-pid" build option to the configure script. When enabled
1554 this causes the client, server and relay programs to include the PID
1555 number in syslog messages.
1556 Thanks to Marius Tomaschewski for the suggestion and proto-patch.
1559 - Add a #define to specify the prefix length used when a client attempts
1560 to configure an address. This can be modified by editing includes/site.h.
1561 By default it is set to 64. While 128 might be a better choice it would
1562 also be a change for currently running systems, so we have left it at 64.
1565 - Add a run time option to the client "-df" to allow the administrator to
1566 point to a second lease file the client can search for a DUID. This can
1567 be used to allow a v4 and a v6 instance of the client to share a DUID.
1568 The second file will only be searched if there isn't a DUID in the main
1569 lease file and the DUID will be written out to the main lease file.
1572 - Have the client fsync the lease file to avoid lease corruption if the
1573 client hibernates or otherwise shuts down.
1576 - Add a check for L2VLAN in bpf.c to help support VLAN interfaces
1577 Thanks to Steinar Haug for the suggestion.
1580 - Modify the handling of the resolv.conf file to allow the DHCP
1581 process to start up even if the resolv.conf file has problems.
1584 - Add threshold logging functionality. Two new options,
1585 log-threshold-low and log-threshold-high, indicate to the
1586 server if and when it should log an error message as addresses
1590 - Add code to properly dereference a pointer in the dhclient code
1591 on an error condition.
1594 - Add code to help clean up soft leases.
1597 - Disable the gentle shutdown functionality until we can determine
1598 the best way to present it to remove or reduce the side effects.
1601 Changes since 4.3.0rc1
1604 Changes since 4.3.0b1
1606 - Tidy up receive packet processing.
1607 Thanks to Brad Plank of GTA for reporting the issue and suggesting
1611 Changes since 4.3.0a1
1613 - Modify the message displayed when a process hits a fatal error.
1614 The new message is much shorter and simply points to the README
1615 and our website for directions on bug submissions.
1618 Changes since 4.2.0 (new features)
1620 - If a client renews before 'dhcp-cache-threshold' percent of its lease
1621 has elapsed (default 25%), the server will reuse the allocated lease
1622 (provide a lease within the currently allocated lease-time) rather
1623 than extend or renew the lease. This absolves the server of needing
1624 to perform an fsync() operation on the lease database before reply,
1625 which improves performance. [ISC-Bugs #22228]
1626 Updated this patch to support asynchronous DDNS. If the server is
1627 attempting to do DDNS on a lease it should be updated and written to
1628 disk even if that wouldn't be necessary due to the thresholding.
1631 - The 'no available billing' log line now also logs the name of the last
1632 matching billing class tried before failing to provide a billing.
1635 - A problem with missing get_hw_addr function when --enable-use-sockets
1636 was used is now solved on GNU/Linux, BSD and GNU/Hurd systems. Note
1637 that use-sockets feature was not tested on those systems. Client and
1638 server code no longer use MAX_PATH constant that is not defined on
1639 GNU/Hurd systems. [ISC-Bugs #25979]
1641 - Add a perl script in the contrib directory, dhcp-lease-list.pl, which
1642 can parse v4 lease files and output the lease information in a more
1643 human friendly manner. This was written by Christian Hammers with
1644 some updates by vom and ISC. This is contributed code and is not
1645 supported by ISC; however it may be useful to some users.
1648 - Add support in v6 for on-commit, on-expire and on-release.
1651 - Add support for using classes with v6.
1654 - Update the DDNS code to current standards and allow for sharing
1655 of DDNS entries between v4 and v6 clients. The new code is used
1656 if the ddns-update-style is set to "standard", the older code is
1657 still available if ddns-update-style is set to "interim". The
1658 oldest DDNS code "ad-hoc" has been removed. Thanks to Thomas Pegeot
1659 who submitted a patch for this issue. This patch is based on
1660 that work with some modifications.
1663 - Add a configuration option to the server to suppress using fsync().
1664 Enabling this option will mean that fsync() is never called. This
1665 may provide better performance but there is also a risk that a lease
1666 will not be properly written to the disk after it has been issued
1667 to a client and before the server stops. Using this option is
1671 - Add some logging statements to indicate when the server is ready
1672 to serve. One statement is emitted after the server has finished
1673 reading its files and is about to enter the dispatch loop.
1674 This is "Server starting service.".
1675 The second is emitted when a server determines that both it and
1676 its failover peer are in the normal state.
1677 This is "failover peer <name>: Both servers normal."
1680 - Add support for accessing options from v6 relays. The v6relay
1681 statement allows the administrator to choose which relay to
1682 use when searching for an option, see the dhcp-options man page
1683 for a description. The host-identifier option has also been
1684 updated to support the use of relay options, see the dhcpd.conf
1685 man page for a description.
1688 - When doing DDNS if there isn't an appropriate zone statement attempt
1689 to find a reasonable nameserver via a DNS resolver. This restores
1690 some functionality that was lost in the transition to asynchronous
1691 DDNS. Due to the lack of security and increase in fragility of the
1692 system when using this feature we strongly recommend the use of
1693 appropriate zone statements rather than using this functionality.
1696 - Add support for specifying the address from which to send
1697 DDNS updates on the DHCP server. There are two new options
1698 "ddns-local-address4" and "ddns-local-address6" that each take
1699 one instance of their respective address types.
1702 - Add ignore-client-uids option in the server. This option causes
1703 the server to not record a client's uid in its lease. This
1704 violates the specification but may also be useful when a client
1705 can dual boot using different client ids but the same mac address.
1706 Thank you to Brian De Wolf at Cal Poly Pomona for the patch.
1710 - Extend the DHCPINFORM processing to honor the subnet selection option
1711 and take host declarations into account.
1712 Thanks to Christof Chen for testing and submitting the patch.
1715 - Extend the hardware expression to look into the lease structure
1716 for a hardware address if there is no packet. This allows the
1717 server to find the hardware address during on-expiry processing.
1720 - Add definitions for some options that have been specified by the IETF.
1724 Changes since 4.2.0 (bug fixes)
1726 - When using 'ignore client-updates;', the FQDN returned to the client
1727 is no longer truncated to one octet.
1729 - Cleaned up an unused hardware address variable in nak_lease().
1731 - Manpage entries for the ia-pd and ia-prefix options were updated to
1732 reflect support for prefix delegation.
1734 - Cleaned up some compiler warnings
1736 - An optimization described in the failover protocol draft is now included,
1737 which permits a DHCP server operating in communications-interrupted state
1738 to 'rewind' a lease to the state most recently transmitted to its peer,
1739 greatly increasing a server's endurance in communications-interrupted.
1740 This is supported using a new 'rewind state' record on the dhcpd.leases
1741 entry for each lease.
1743 - Fix the trace code which was broken by the changes to the DDNS code.
1745 - Update the fsync code to work with the changes to the DDNS code. It now
1746 uses a timer instead of noticing if there are no more packets to process.
1748 - When constructing the DNS name structure from a text string append
1749 the root to relative names. This satisfies a requirement in the DNS
1750 library that names be absolute instead of relative and prevents DHCP
1751 from crashing. [ISC-Bugs #21054]
1753 - "The LDAP Patch" that has been circulating for some time, written by
1754 Brian Masney and S.Kalyanasundraram and maintained for application to
1755 the DHCP-4 sources by David Cantrell has been included. Please be
1756 advised that these sources were contributed, and do not yet meet the
1757 high standards we place on production sources we include by default.
1758 As a result, the LDAP features are only included by using a compile-time
1759 option which defaults off, and if you enable it you do so under your
1760 own recognizance. We will be improving this software over time.
1763 - Prohibit including lease time information in a response to a DHCP INFORM.
1766 ! Accept a client id of length 0 while hashing. Previously the server would
1767 exit if it attempted to hash a zero length client id, providing attackers
1768 with a simple denial of service attack. [ISC-Bugs #21253]
1769 CERT: VU#541921 - CVE: CVE-2010-2156
1771 - A memory leak in ddns processing was closed. [ISC-Bugs #21377]
1773 - Modify the exception handling for initial context creation. Previously
1774 we would try and clean up before exiting. This could present problems
1775 when the cleanup required part of the context that wasn't available. It
1776 also didn't do much as we exited afterwards anyway. Now we simply log
1777 the error and exit. [ISC-Bugs #21093]
1779 - A bug was fixed that could cause the DHCPv6 server to advertise/assign a
1780 previously allocated (active) lease to a client that has changed subnets,
1781 despite being on different shared networks. Dynamic prefixes specifically
1782 allocated in shared networks also now are not offered if the client has
1783 moved. [ISC-Bugs #21152]
1785 - Add some debugging output for use with the DDNS code. [ISC-Bugs #20916]
1787 - Fix the trace code to handle timing events better and to truncate a file
1788 before using instead of overwriting it. [ISC-Bugs #20969]
1790 - Modify the determination of the default TTL to use for DDNS updates.
1791 The user may still configure the ttl via ddns-ttl. The default for
1792 both v4 and v6 is now 1/2 the (preferred) lease time with a limit. The
1793 previous defaults (1/2 lease time without a limit for v4 and a default
1794 value for v6) may be used by defining USE_OLD_DDNS_TTL in site.h
1797 - libisc/libdns is now brought up to version 9.7.1rc1. This corrects
1798 three reported flaws in ISC DHCP;
1800 o DHCP processes (dhcpd, dhclient) fail to start if one of either the
1801 IPv4 or IPv6 address families is not present. [ISC-Bugs #21122]
1803 o Assertion failure when attempting to cancel a previously running DDNS
1804 update. [ISC-Bugs #21133]
1806 o Compilation failure of libisc/libdns due to the use of a flexible
1807 array member. [ISC-Bugs #21316]
1809 - Add declaration for variable in debug code in alloc.c. [ISC-Bugs #21472]
1811 - Documentation cleanup covering multiple tickets
1812 [ISC-Bugs #20265] [ISC-Bugs #20259] minor cleanup
1813 [ISC-Bugs #20263] add text describing some default values
1814 [ISC-Bugs #20193] single quotes at the start of a line indicate a control
1815 line to nroff, escape them if we actually want a quote.
1816 [ISC-Bugs #18916] sync the pointer to web pages amongst the different docs
1818 - 'get-host-names true;' now also works even if 'use-host-decl-names true;'
1819 was also configured. The nature of this repair also fixes another
1820 error; the host-name supplied by a client is no longer overridden by a
1821 reverse lookup of the lease address. Thanks to a patch from Wilco Baan
1822 Hofman supplied to us by the Debian package maintenance team.
1823 [ISC-Bugs #21691] {Debian Bug#509445}
1825 - The .TH tag for the dhcp-options manpage was typo repaired
1826 thanks to a report from jidanni and the Debian package maintenance
1827 team. [ISC-Bugs #21676] {Debian Bug#563613}
1829 - More documentation changes - primarily to put the options in the dhclient
1830 and dhcpd man pages into the standard form. Thanks in part to a patch
1831 from David Cantrell at Red Hat.
1832 [ISC-Bugs #20264] and parts of [ISC-Bugs #17744] dhclient.8 changes
1834 - Add code to clear the pointer to an object in an OMAPI handle when the
1835 object is freed due to a dereference. [ISC-Bugs #21306]
1837 - Fixed a bug that leaks host record references onto lease structures,
1838 causing the server to apply configuration intended for one host to any
1839 other innocent clients that come along later. [ISC-Bugs #22018]
1842 [ISC-Bugs #19566] When trying to find the zone for a name for ddns allow
1843 the name to be at the apex of the zone.
1844 [ISC-Bugs #19617] Restrict length of interface name read from command line
1845 in dhcpd - based on a patch from David Cantrell at Red Hat.
1846 [ISC-Bugs #20039] Correct some error messages in dhcpd.c
1847 [ISC-Bugs #20070] Better range check on values when creating a DHCID.
1848 [ISC-Bugs #20198] Avoid writing past the end of the field when adding
1849 overly long file or server names to a packet and add a log message
1850 if the configuration supplied overly long names for these fields.
1851 Thanks to Martin Pala.
1852 [ISC-Bugs #21497] Add a little more randomness to rng seed in client
1853 thanks to a patch from Jeremiah Jinno.
1855 - Correct error handling in DLPI [ISC-Bugs #20378]
1857 - Remove __sun__ and __hpux__ typedefs in osdep.h as they are now being
1858 checked in configure. [ISC-Bugs #20443]
1860 - Modify how the cmsg header is allocated the v6 send and received routines
1861 to compile on more compilers. [ISC-Bugs #20524]
1863 - When parsing a domain name free the memory for the name after we are
1864 done with it. [ISC-Bugs #20824]
1866 - Add an elapsed time option to the release message and refactor the
1867 code to move most of the common code to a single routine.
1870 - Two identical log messages for commit_leases() have been disambiguated.
1873 - Parse date strings more properly - the code now handles semi-colons in
1874 date strings correctly. Thanks to a patch from Jiri Popelka at Red Hat.
1875 [ISC-Bugs #21501, #20598]
1877 - Fixes to lease input and output.
1878 [ISC-Bugs #20418] - Some systems don't support the "%s" argument to
1879 strftime, paste together the same string using mktime instead.
1880 [ISC-Bugs #19596] - When parsing iaid values accept printable
1882 [ISC-Bugs #21585] - Always print time values in omshell as hex
1883 instead of ascii if the values happen to be printable characters.
1885 - Minor changes for scripts, configure.ac and Makefiles
1886 [ISC-Bugs #19147] Use domain-search instead of domain-name in manual and
1887 example conf file. Thanks to a patch from David Cantrell
1889 [ISC-Bugs #19761] Restore address when doing a rebind in DHCPv6
1890 [ISC-Bugs #19945] Properly close the quote on some arguments.
1891 [ISC-Bugs #20952] Add 64 bit types to configure.ac
1892 [ISC-Bugs #21308] Add "PATH=" to CLIENT_PATH environment variable
1894 - Update the code to parse dhcpv6 lease files to accept a semi-colon at
1895 the end of the max-life and preferred-life clauses. In order to be
1896 backwards compatible with older lease files not finding a semi-colon
1897 is also accepted. [ISC-Bugs #22303].
1899 ! Handle a relay forward message with an unspecified address in the
1900 link address field. Previously such a message would cause the
1901 server to crash. Thanks to a report from John Gibbins. [ISC-Bugs #21992]
1902 CERT: VU#102047 CVE: CVE-2010-3611
1904 - ./configure on longer searches for -lcrypto to explicitly link against.
1905 This fixes a bug where 'dhclient' would have shared library dependencies
1906 on '/usr/lib'. [ISC-Bugs #21967]
1908 - Handle pipe failures more gracefully. Some OSes pass a SIGPIPE
1909 signal to a process and will kill the process if the signal isn't
1910 caught. This patch adds code to turn off the SIGPIPE signal via
1911 a setsockopt() call. The signal is already being ignored as part
1912 of the ISC library. [ISC-Bugs #22269]
1914 - Restore printing of values in omshell to the style pre 21585. For
1915 21585 we changed the print routines to always display time values
1916 as a hex list. This had a side effect of printing all data strings
1917 as a hex list. We shall investigate other ways of displaying time
1918 values more usefully. [ISC-Bugs #22626]
1920 ! Fix the handling of connection requests on the failover port.
1921 Previously a connection request from a source that wasn't
1922 listed as a failover peer would cause the server to become
1923 non-responsive. Thanks to a report from Brad Bendily, brad@bendily.com.
1925 CERT: VU#159528 CVE: CVE-2010-3616
1927 - Don't pass the ISC_R_INPROGRESS status to the omapi signal handlers.
1928 Passing it through to the handlers caused the omshell program to fail
1929 to connect to the server. [ISC-Bugs #21839]
1931 - Fix the parenthesis in the code to process configuration statements
1932 beginning with "auth". The previous arrangement caused
1933 "auto-partner-down" to be processed incorrectly. [ISC-Bugs #21854]
1935 - Limit the timeout period allowed in the dispatch code to 2^^32-1 seconds.
1936 Thanks to a report from Jiri Popelka at Red Hat.
1937 [ISC-Bugs #22033], [Red Hat Bug #628258]
1939 - When processing the format flags for a given option consume the
1940 flag indicating an optional value correctly. A symptom of this
1941 bug was an infinite loop when trying to parse the slp-service-scope
1942 option. Thanks to a patch from Marius Tomaschewski.
1945 - Disable the use of kqueue in the ISC library. This avoids a problem
1946 between the fork and socket code that caused the dhcpd process to
1947 use all available cpu if the program daemonized itself.
1950 ! When processing a request in the DHCPv6 server code that specifies
1951 an address that is tagged as abandoned (meaning we received a
1952 decline request for it previously) don't attempt to move it from
1953 the inactive to active pool as doing so can result in the server
1954 crashing on an assert failure. Also retag the lease as active
1955 and reset its timeout value.
1958 - Removed the restriction on using IPv6 addresses in IPv4 mode. This
1959 allows IPv4 options which contain IPv6 addresses to be specified. For
1960 example the 6rd option can be specified and used like this:
1963 option 6rd code 212 = { integer 8, integer 8,
1964 ip6-address, array of ip-address };
1965 option 6rd 16 10 2001:: 1.2.3.4, 5.6.7.8;
1967 - Handle some DDNS corner cases better. Maintain the DDNS transaction
1968 information when updating a lease and cancel any existing transactions
1969 when removing the ddns information.
1972 - Some fixes for LDAP
1973 [ISC-Bugs #21783] - Include lber library when building ldap
1974 [ISC-Bugs #22888] - Enable the ldap code when buidling common
1975 The above fixes are from Jiri Popelka at Red Hat.
1977 - Modify the dlpi code to accept getmsg() returning a positive value.
1980 ! In dhclient check the data for some string options for
1981 reasonableness before passing it along to the script that
1982 interfaces with the OS.
1986 - DHCPv6 server now responds properly if client asks for a prefix that
1987 is already assigned to a different client. [ISC-Bugs #23948]
1989 - Add the option "--no-pid" to the client, relay and server code,
1990 to disable writing a pid file. Add the option "-pf pidfile"
1991 to the relay to allow the user to supply the pidfile name at
1992 runtime. Add the "with-relay6-pid-file" option to configure
1993 to allow the user to supply the pidfile name for the relay
1994 in v6 mode at configure time.
1995 [ISC-Bugs #23351] [ISC-Bugs #17541]
1997 - 'dhclient' no longer waits a random interval after first starting up to
1998 begin in the INIT state. This conforms to RFC 2131, but elects not to
1999 implement a 'SHOULD' direction in section 4.1. The goal of this change
2000 is to start up faster. [ISC-Bugs #19660]
2002 - Added 'initial-delay' parameter that specifies maximum amount of time
2003 before client goes to the INIT state. The default value is 0. In previous
2004 versions of the code client could wait up to 5 seconds. The old behavior
2005 may be restored by using 'initial-delay 5;' in the client config file.
2008 - ICMP ping-check should now sit closer to precisely the number of seconds
2009 configured (or default 1), due to making use of the new microsecond
2010 scale timer internally to dhcpd. This corrects a bug where the server
2011 may immediately timeout an ICMP ping-check if it was made late in the
2012 current second. [ISC-Bugs #19660]
2014 - The DHCP client will schedule renewal and rebinding events in
2015 microseconds if the DHCP server provided a lease-time that would result
2016 in sub-1-second timers. This corrects a bug where a 2-second or lower
2017 lease-time would cause the DHCP client to enter an infinite loop by
2018 scheduling renewal at zero seconds. [ISC-Bugs #19660]
2020 - Client lease records are recorded at most once every 15 seconds. This
2021 keeps the client from filling the lease database disk quickly on very small
2022 lease times. [ISC-Bugs #19660]
2024 - To defend against RFC 2131 non-compliant DHCP servers which fail to
2025 advertise a lease-time (either mangled, or zero in value) the DHCP
2026 client now adds the server to the reject list ACL and returns to INIT
2027 state to hopefully find an RFC 2131 compliant server (or retry in INIT
2028 forever). [ISC-Bugs #19660]
2030 - Parameters configured to evaluate from user defined function calls can
2031 now be correctly written to dhcpd.leases (as on 'on events' or dynamic
2032 host records inserted via OMAPI). [ISC-Bugs #22266]
2034 - If a 'next-server' parameter is configured in a dynamic host record via
2035 OMAPI as a domain name, the syntax written to disk is now correctly parsed
2036 upon restart. [ISC-Bugs #22266]
2038 - The DHCP server now responds to DHCPLEASEQUERY messages from agents using
2039 IP addresses not covered by a subnet in configuration. Whether or not to
2040 respond to such an agent is still governed by the 'allow leasequery;'
2041 configuration parameter, in the case of an agent not covered by a configured
2042 subnet the root configuration area is examined. Server now also returns
2043 vendor-class-id option, if client sent it. [ISC-Bugs #21094]
2045 - Documentation fixes
2046 [ISC-Bugs #17959] add text to AIX section describing how to have it send
2047 responses to the all-ones address.
2048 [ISC-Bugs #19615] update the includes in dhcpctl/dhcpctl.3 to be more correct
2049 [ISC-Bugs #20676] update dhcpd.conf.5 to include the RFC numbers for DDNS
2051 - Relay no longer crashes, when DHCP packet is received over interface without
2052 any IPv4 address assigned. Also extended logging message about discarding
2053 packets with invalid hlen with information about relevant interface name.
2056 - Relay now properly logs that packet was received over interface without
2057 global IPv6 address [ISC-Bugs #24070]
2059 - Linux Packet Filter interface improvement. sockaddr_pkt structure is used,
2060 rather than sockaddr. Packet ethertype is now forced to ETH_P_IP.
2063 - Minor code cleanups - but note port change for #23196
2064 [ISC-Bugs #23470] - Modify when an ignore return macro is defined to
2065 handle unsed error return warnings for more versions of gcc.
2066 [ISC-Bugs #23196] - Modify the reply handling in the server code to
2067 send to a specified port rather than to the source port for the incoming
2068 message. Sending to the source port was test code that should have
2069 been removed. The previous functionality may be restored by defining
2070 REPLY_TO_SOURCE_PORT in the includes/site.h file. We suggest you don't
2071 enable this except for testing purposes.
2072 [ISC-Bugs #22695] - Close a file descriptor in an error path.
2073 [ISC-Bugs #19368] - Tidy up variable types in validate_port.
2075 - Code cleanup: remove obsolete PROTO, KandR, INLINE and ANSI_DECL macros
2078 - Compilation problem with gcc4.5 and omshell.c resolved. [ISC-Bugs #23831]
2080 - Client Script fixes
2081 [ISC-Bugs #23045] Typos in client/scripts/openbsd
2082 [ISC-Bugs #23565] In the client scripts add a zone id (interface id) if
2083 the domain search address is link local.
2084 [ISC-Bugs #1277] In some of the client scripts add code to handle the
2085 case of the default router information being changed without the address
2088 - Documentation cleanup
2089 [ISC-Bugs #23326] Updated References document, several man page updates
2091 - Server no longer complains about NULL pointer when configured
2092 server-identifier expression fails to evaluate. [ISC-Bugs #24547]
2094 - Convert ISC_R_INPROGRESS status to ISC_R_SUCCESS when called from other
2095 than the dispatch handler. This fixes an issue where omshell, when
2096 run from the same platform as the server, would appear to fail to
2097 connect. This is a companion to #21839. [ISC-Bugs #23592]
2099 - Enlarge the buffer size used by the Omshell code and some of the
2100 print routines to allow for greater than 60 characters or, when
2101 printing as hex strings, 20 characters. [ISC-Bugs #22743]
2103 - In Solaris 11 switch to using sockets instead of DLPI, thanks
2104 to a patch form Oracle. [ISC-Bugs #24634].
2106 - Strict checks for content of domain-name DHCPv4 option can now be
2107 configured during compilation time. Even though RFC2132 does not allow
2108 to store more than one domain in domain-name option, such behavior is
2109 now enabled by default, but this may change some time in the future.
2110 See ACCEPT_LIST_IN_DOMAIN_NAME define in includes/site.h.
2113 - DNS Update fix. A misconfigured server could crash during DNS update
2114 processing if the configuration included overlapping pools or
2115 multiple fixed-address entries for a single address. This issue
2116 affected both IPv4 and IPv6. The fix allows a server to detect such
2117 conditions, provides the user with extra information and recommended
2118 steps to fix the problem. If the user enables the appropriate option
2119 in site.h then server will be terminated
2122 ! Two packets were found that cause a server to halt. The code
2123 has been updated to properly process or reject the packets as
2124 appropriate. Thanks to David Zych at University of Illinois
2125 for reporting this issue. [ISC-Bugs #24960]
2126 One CVE number for each class of packet.
2130 - Fix the code that checks for an existing DDNS transaction to cancel
2131 when removing DDNS information, so that we will continue with the
2132 processing if we have a lease even if it doesn't have an outstanding
2133 transaction. [ISC-Bugs #24682]
2135 - Add AM_MAINTAINER_MODE to configure.ac to avoid rebuilding
2136 configuration files. [ISC-Bugs #24107]
2138 - Add support for passing DDNS information to a DNS server over
2139 an IPv6 address. [ISC-Bugs #22647]
2141 - Enhanced patch for 23595 to handle IPv4 fixed addresses more
2142 cleanly. [ISC-Bugs #23595]
2144 ! Add a check for a null pointer before calling the regexec function.
2145 Without this check we could, under some circumstances, pass
2146 a null pointer to the regexec function causing it to segfault.
2147 Thanks to a report from BlueCat Networks.
2151 ! Modify the DDNS handling code. In a previous patch we added logging
2152 code to the DDNS handling. This code included a bug that caused it
2153 to attempt to dereference a NULL pointer and eventually segfault.
2154 While reviewing the code as we addressed this problem, we determined
2155 that some of the updates to the lease structures would not work as
2156 planned since the structures being updated were in the process of
2157 being freed: these updates were removed. In addition we removed an
2158 incorrect call to the DDNS removal function that could cause a failure
2159 during the removal of DDNS information from the DNS server.
2160 Thanks to Jasper Jongmans for reporting this issue.
2164 - Fixed the code that checks if an address the server is planning
2165 to hand out is in a reserved range. This would appear as
2166 the server being out of addresses in pools with particular ranges.
2169 - In the DDNS code handle error conditions more gracefully and add more
2170 logging code. The major change is to handle unexpected cancel events
2171 from the DNS client code.
2174 - Tidy up the receive calls and eliminate the need for found_pkt.
2177 - Add support for Infiniband over sockets to the server and
2178 relay code. We've tested this on Solaris and hope to expand
2179 support for Infiniband in the future. This patch also corrects
2180 some issues we found in the socket code.
2183 - Add a compile time check for the presence of the noreturn attribute
2184 and use it for log_fatal if it's available. This will help code
2185 checking programs to eliminate false positives.
2188 - Fixed many compilation problems ("set, but not used" warnings) for
2189 gcc 4.6 that may affect Ubuntu 11.10 users. [ISC-Bugs #27588]
2191 - Modify the code that determines if an outstanding DDNS request
2192 should be cancelled. This patch results in cancelling the
2193 outstanding request less often. It fixes the problem caused
2194 by a client doing a release where the TXT and PTR records
2195 weren't removed from the DNS.
2198 - Use offsetof() instead of sizeof() to get the sizes for dhcpv6_relay_packet
2199 and dhcpv6_packet in several more places. Thanks to a report from
2200 Bruno Verstuyft and Vincent Demaertelaere of Excentis.
2203 - Remove outdated note in the description of the bootp keyword about the
2204 option not satisfying the requirement of failover peers for denying
2205 dynamic bootp clients.
2208 - Multiple items to clean up IPv6 address processing.
2209 When processing an IA that we've seen check to see if the
2210 addresses are usable (not in use by somebody else) before
2212 When reading in leases from the file discard expired addresses.
2213 When picking an address for a client include the IA ID in
2214 addition to the client ID to generally pick different addresses
2216 [ISC-Bugs #23138] [ISC-Bugs #27945] [ISC-Bugs #25586]
2219 - Remove unnecessary checks in the lease query code and clean up
2220 several compiler issues (some dereferences of NULL and treating
2221 an int as a boolean).
2224 - Fix the NA and PD allocation code to handle the case where a client
2225 provides a preference and the server doesn't have any addresses or
2226 prefixes available. Previously the server ignored the request with
2227 this patch it replies with a NoAddrsAvail or NoPrefixAvail response.
2228 By default the code performs according to the errata of August 2010
2229 for RFC 3315 section 17.2.2; to enable the previous style see the
2230 section on RFC3315_PRE_ERRATA_2010_08 in includes/site.h. This option
2231 may be removed in the future.
2232 Thanks to Jiri Popelka at Red Hat for the patch.
2235 - Fix up some issues found by static analysis.
2236 A potential memory leak and NULL dereference in omapi.
2237 The use of a boolean test instead of a bitwise test in dst.
2240 - Rotate the lease file when running in v6 mode.
2241 Thanks to Christoph Moench-Tegeder at Astaro for the
2242 report and the first version of the patch.
2245 - Correct code to calculate timing values in client to compare
2246 rebind value to infinity instead of renew value.
2247 Thanks to Chenda Huang from H3C Technologies Co., Limited
2248 for reporting this issue.
2251 - Fix some issues in the code for parsing and printing options.
2252 [ISC-Bugs #22625] - properly print options that have several fields
2253 followed by an array of something for example "fIa"
2254 [ISC-Bugs #27289] - properly parse options in declarations that have
2255 several fields followed by an array of something for example "fIa"
2256 [ISC-Bugs #27296] - properly determine if we parsed a 16 or 32 bit
2257 value in evaluate_numeric_expression (extract-int).
2258 [ISC-Bugs #27314] - properly parse a zero length option from
2259 a lease file. Thanks to Marius Tomaschewski from SUSE for the report
2260 and prototype patch for this ticket as well as ticket 27289.
2262 ! Previously the server code was relaxed to allow packets with zero
2263 length client ids to be processed. Under some situations use of
2264 zero length client ids can cause the server to go into an infinite
2265 loop. As such ids are not valid according to RFC 2132 section 9.14
2266 the server no longer accepts them. Client ids with a length of 1
2267 are also invalid but the server still accepts them in order to
2268 minimize disruption. The restriction will likely be tightened in
2269 the future to disallow ids with a length of 1.
2270 Thanks to Markus Hietava of Codenomicon CROSS project for the
2271 finding this issue and CERT-FI for vulnerability coordination.
2275 ! When attempting to convert a DUID from a client id option
2276 into a hardware address handle unexpected client ids properly.
2277 Thanks to Markus Hietava of Codenomicon CROSS project for the
2278 finding this issue and CERT-FI for vulnerability coordination.
2282 ! A pair of memory leaks were found and fixed. Thanks to
2283 Glen Eustace of Massey University, New Zealand for finding
2288 - Existing legacy unit-tests have been migrated to Automated Test
2289 Framework (ATF). Several new tests have been developed. To enable
2290 unit-tests, please use --with-atf in configure script. A Developer's
2291 Guide has been added. To generate it, please use make devel in
2292 the doc directory. It is currently in early stages of development,
2293 but is expected to grow in the near future. [ISC-Bugs 25901]
2295 ! An issue with the use of lease times was found and fixed. Making
2296 certain changes to the end time of an IPv6 lease could cause the
2297 server to abort. Thanks to Glen Eustace of Massey University,
2298 New Zealand for finding this issue.
2302 - Update the memory leakage debug code to work with v6.
2305 - Relax the requirements for deleting an A or AAAA record.
2306 Previously the DDNS removal code required both the A or AAAA
2307 record and the TXT record to exist. This requirement could
2308 cause problems if something interrupted the removal leaving
2309 the TXT record alone. This relaxation was codified in RFC 4703.
2312 - Modify the failover code to handle incorrect peer names
2313 better. Previously the structure holding the name might
2314 have been freed inappropriately in some cases and not
2315 freed in other cases.
2318 - Add a configure option, enable-secs-byteorder, to deal with
2319 clients that do the byte ordering on the secs field incorrectly.
2320 This field should be in network byte order but some clients
2321 get it wrong. When this option is enabled the server will examine
2322 the secs field and if it looks wrong (high byte non zero and low
2323 byte zero) swap the bytes. The default is disabled. This option
2324 is only useful when doing load balancing within failover.
2327 - Fix a set of issues that were discovered via a code inspection
2328 tool. Thanks to Jiri Popelka and Tomas Hozza Red Hat for the logs
2332 - Parsing unquoted base64 strings improved. Parser now properly handles
2333 strings that contain reserved names. [ISC-Bugs #23048]
2335 - Modify the nak_lease function to make some attempts to find a
2336 server-identifier option to use for the NAK.
2339 - The client now passes information about the options it requested
2340 from the server to the script code via environment variables.
2341 These variables are of the form requested_<option_name>=1 with
2342 the option name being the same as used in the new_* and old_*
2346 - Add support for a simple check that the server id in a request message
2347 to a failover peer matches the server id of the server. This support
2348 is enabled by editing the file includes/site.h and uncommenting the
2349 definition for SERVER_ID_CHECK. The option has several restrictions
2350 and issues - please read the comment in the site.h file before
2354 - Tidy up some compiler issues in the debug code.
2357 - Move the dhcpd.conf example file to dhcpd.conf.example to avoid
2358 overwriting the dhcpd.conf file when installing a new version of
2359 ISC DHCP. The user will now need to manual copy and edit the
2360 dhcpd.conf file as desired.
2363 - Check the status value when trying to read from a connection to
2364 see if it may have been closed. If it appears closed don't try
2365 to read from it again. This avoids a potential busy-wait like
2366 loop when the peer names are mismatched.
2369 - Remove an unused variable to keep compilers happy.
2372 - Modify test makefiles to be more similar to standard makefiles
2373 and comment out a currently unused test.
2376 - Address static analysis warnings.
2377 [ISC-Bugs #33510] [ISC-Bugs #33511]
2379 - Silence benign static analysis warnings.
2382 - Add check for 64-bit package for atf.
2385 - Use newer auto* tool packages and turn on RFC_3542 support on Mac OS.
2388 - Remove a variable when it isn't being used due to #ifdefs to avoid
2389 a compiler warning on Solaris using GCC.
2392 - Add a check for too much whitespace in a config or lease file.
2393 Thanks to Paolo Pellegrino for finding the issue and a suggestion
2397 - Fix several problems with using OMAPI to manipulate class and subclass
2401 - Added a sleep call after killing the old client to allow time
2402 for the sockets to be cleaned. This should allow the -r option
2403 to work more consistently.
2406 - Missing files for ISC DHCP Developer's Guide are now included in
2407 the release tarballs. To generate this documentation, please use
2408 make devel command in doc directory. [ISC-Bugs #32767]
2410 - Update client script for use with openwrt.
2413 - Fix the socket handling for DHCPv6 clients to allow multiple instances
2414 of a client on a single machine to work properly. Previously only
2415 one client would receive the packets. Thanks to Jiri Popelka at Red Hat
2416 for the bug report and a potential patch.
2419 - Added support for gentle shutdown after signal is received.
2420 [ISC-Bugs #32692] [ISC-Bugs 34945]
2422 - Enhance the DHCPv6 server logging to include the addresses that are assigned
2426 - Fix an operation in the DDNS code to be a bitwise instead of logical or.
2430 Changes since 4.1.0 (new features)
2432 - Failover port configuration can now be left to defaults (port 647) as
2433 described in the -12 revision of the Failover draft (and assigned by
2434 IANA). Thanks in part to a patch from David Cantrell at Red Hat.
2436 - If configured, dhclient may now transmit to an anycast MAC address,
2437 rather than using a broadcast address. Thanks to a patch from David
2438 Cantrell at Red Hat.
2440 - Added client support for setting interface MTU and metric, thanks to
2441 Roy "UberLord" Marples <roy@marples.name>.
2443 - Added client -D option to specify DUID type to send.
2445 - A new failover configuration parameter has been introduced for those
2446 environments where DHCP servers can be reasonably guaranteed to be
2447 "down" when the failover TCP socket is severed, "auto-partner-down".
2448 This parameter is not generally safe, and by default is disabled, so
2449 please carefully review the documentation of this parameter in the
2450 dhcpd.conf(5) manpage before determining to use it yourself.
2452 - Added a configuration function, 'gethostname()', which calls the system
2453 function of the same name and presents the results as a data expression.
2454 This function can be used to incorporate the system level hostname of
2455 the system the DHCP software is operating on in responses or queries (such
2456 as including a failover partner's hostname in a dhcp message or binding
2457 scope, or having a DHCP client send any system hostname in the host-name or
2458 FQDN options by default).
2460 - The dhcp-renewal-time and dhcp-rebinding-time options may now be configured
2461 for DHCPv4 operation and used independently of the dhcp-lease-time
2462 calculations. Invalid renew and rebinding times (e.g., greater than the
2463 determined lease time) are omitted.
2465 - Processing the DHCP to DNS server transactions in an asynchronous fashion,
2466 the DHCP server or client can now continue with its processing while
2467 awaiting replies from the DNS server.
2469 - The 'hardware [ethernet|etc] ...;' parameter in host records has been
2470 extended to attempt to match DHCPv6 clients by the last octets of a
2471 DUID-LL or DUID-LLT provided by the client.
2473 Changes since 4.1.0 (bug fixes)
2475 - Remove infinite loop in token_print_indent_concat().
2477 - Validate the argument to the -p option.
2479 - The notorious 'option <unknown> ... larger than buffer' log line,
2480 which is seen in some malformed DHCP client packets, was modified.
2481 It now logs the universe name, and does not log the length values
2482 (which are bogus corruption read from the packet anyway). It also
2483 carries a hopefully more useful explanation.
2485 - Suppress spurious warnings from configure about --datarootdir
2487 - A bug was fixed that caused the server not to answer some valid Solicit
2488 and Request packets, if the dynamic range covering any requested addresses
2489 had been deleted from configuration.
2491 - Update the code to deal with GCC 4.3. This included two sets of changes.
2492 The first is to the configuration files to include the use of
2493 AC_USE_SYSTEM_EXTENSIONS. The second is to deal with return values that
2496 - The db-time-format option was documented in manpages.
2498 - Using reserved leases no longer results in 'lease with binding state
2499 free not on its queue' error messages, thanks to a patch from Frode
2502 - Fix a build error in dhcrelay, using older versions of gcc with
2505 - Two uninitialized stack structures are now memset to zero, thanks to a
2506 patch from David Cantrell at Red Hat.
2508 - Fixed a cosmetic bug where pretty-printing valid domain-search options would
2509 result in an erroneous error log message ('garbage in format string').
2511 - A bug in DLPI packet transmission (Solaris, HP/UX) that caused the server
2512 to stop receiving packets is fixed. The same fix also means that the MAC
2513 address will no longer appear 'bogus' on DLPI-based systems.
2515 - A bug in select handling was discovered where the results of one select()
2516 call were discarded, causing the server to process the next select() call
2517 and use more system calls than required. This has been repaired - the
2518 sockets will be handled after the first return from select(), resulting in
2521 - The update-conflict-detection feature would leave an FQDN updated without
2522 a DHCID (still currently implemented as a TXT RR). This would cause later
2523 expiration or release events to fail to remove the domain name. The feature
2524 now also inserts the client's up to date DHCID record, so records may safely
2525 be removed at expiration or release time. Thanks to a patch submitted by
2528 - Memory leak in the load_balance_mine() function is fixed. This would
2529 leak ~20-30 octets per DHCPDISCOVER packet while failover was in use
2530 and in normal state.
2532 - Various compilation fixes have been included for the memory related
2533 DEBUG #defines in includes/site.h.
2535 - Fixed Linux client script 'unary operator expected' errors with DHCPv6.
2537 - Fixed setting hostname in Linux hosts that require hostname argument
2538 to be double-quoted. Also allow server-provided hostname to
2539 override hostnames 'localhost' and '(none)'.
2541 - Fixed failover reconnection retry code to continue to retry to reconnect
2542 rather than restarting the listener.
2544 - Compilation on Solaris with USE_SOCKETS defined in includes/site.h has
2545 been repaired. Other USE_ overrides should work better.
2547 - A check for the local flavor of IFNAMSIZ had a broken 'else' condition,
2548 that probably still resulted in the correct behaviour (but wouldn't use
2549 a larger defined value provided by the host OS).
2551 - Fixed a bug where an OMAPI socket disconnection message would not result
2552 in scheduling a failover reconnection, if the link had not negotiated a
2553 failover connect yet (e.g.: connection refused, asynch socket connect()
2556 - A bug was fixed that caused the 'conflict-done' state to fail to be parsed
2557 in failover state records.
2559 ! A stack overflow vulnerability was fixed in dhclient that could allow
2560 remote attackers to execute arbitrary commands as root on the system,
2561 or simply terminate the client, by providing an over-long subnet-mask
2562 option. CERT VU#410676 - CVE-2009-0692
2564 - Fixed a bug where relay agent options would never be returned when
2565 processing a DHCPINFORM.
2567 - Versions 3.0.x syntax with multiple name->code option definitions is now
2568 supported. Note that, similarly to 3.0.x, for by-code lookups only the
2569 last option definition is used.
2571 - Fixed a bug where a time difference of greater than 60 seconds between a
2572 failover pair could cause the primary to crash on contact with the
2573 secondary. Thanks to a patch from Steinar Haug.
2575 - Don't look for IPv6 interfaces on Linux when running in DHCPv4 mode.
2576 Thanks to patches from Matthew Newton and David Cantrell.
2578 - Secondary servers in a failover pair will now perform ddns removals if
2579 they had performed ddns updates on a lease that is expiring, or was
2580 released through the primary. As part of the same fix, stale binding scopes
2581 will now be removed if a change in identity of a lease's active client is
2582 detected, rather than simply if a lease is noticed to have expired (which it
2583 may have expired without a failover server noticing in some situations).
2585 - A patch supplied by David Cantrell at RedHat was applied that detects
2586 invalid calling parameters given to the ns_name_ntop() function.
2587 Specifically, it detects if the caller passed a pointer and size pair
2588 that causes the pointer to integer-wrap past zero.
2590 ! Fixed a fenceposting bug when a client had two host records configured,
2591 one using 'uid' and the other using 'hardware ethernet'. CVE-2009-1892
2593 - Fixed the check in the dhcp_interface_signal_handler routine to verify
2594 the existence of the linked signal handler before calling it.
2596 - Both host and subnet6 configuration groups are now included whether a
2597 fixed-address6 (DHCPv6) is in use or not. Host scoped configuration takes
2598 precedence. This fixes two bugs, one where host scoped configuration
2599 would not be included from a non-fixed-address6 host record, and the equal
2600 and opposite bug where subnet6 scoped configuration would not be used when
2601 over-riding values were not present in a matching fixed-address6 host
2604 - ./configure now checks to ensure the intX_t and u_intX_t types are defined,
2605 correcting a compilation failure when using Sun's compiler.
2607 - Modified the handling of a connection to avoid releasing the omapi io
2608 object for the connection while it is still in use. One symptom from
2609 this error was a segfault when a failover secondary attempted to connect
2610 to the failover primary if their clocks were not synchronized.
2612 - Clean up to allow compilation with gcc 2.95.4 on FreeBSD. Remove an
2613 extra semi-colon from common/dns.c and moved setting a variable to NULL
2614 in server/dhcpv6.c to allow the compiler to decide that the variable
2615 was always properly set.
2617 Changes since 4.1.0b1
2619 - A missing "else" in dhcrelay.c could have caused an interface not to
2622 Changes since 4.1.0a2
2624 - A cosmetic bug in DHCPDECLINE processing was fixed which caused all
2625 successful DHCPDECLINEs to be logged as "not found" rather than
2628 - Added configuration file examples for DHCPv6.
2630 - Some failover debugging #defines have been better defined and some
2631 high frequency messages moved to a deeper debugging symbol.
2633 - The CLTT parameter in failover is now only updated by client activity,
2634 and not by failover binding updates (taking on the peer's CLTT).
2636 - Failover BNDUPD messages are now discarded if they conflict with an
2637 update that has been transmitted, but not acknowledged.
2639 - A bug cleaning up unknown-xxx temporary option definitions was fixed.
2641 - Delayed-ack is now a compile-time option, compiled out by default.
2642 This feature is simply too experimental for right now, and causes
2643 some problems to some failover installations. We will revisit this
2646 - The !inet_pton() call in res_mkupdrec was adjusted to '<= 0' as
2647 inet_pton returns either 1, 0, or -1.
2649 - A dhclient-script for MacOS X has been included, which enables
2650 'dhclient -6' support.
2652 - DDNS removal routines were updated so that the DHCID is not removed until
2653 the client has been deprived of all A and AAAA records (not only the last
2654 one of either of those). This resolves a bug where dual stack clients
2655 would not be able to regain their names after either expiration event.
2657 Changes since 4.1.0a1
2659 - Corrected list of failover state values in dhcpd man page.
2661 - Fixed a bug that caused some request types to be logged incorrectly.
2663 - Clients that sent a parameter request list containing the
2664 routers option before the subnet mask option were receiving
2665 only the latter. Fixed.
2667 - The server wasn't always sending the FQDN option when it should.
2669 - A partner-down failover server no longer emits 'peer holds all free leases'
2670 if it is able to newly-allocate one of the peer's leases.
2672 - Fixed a coredump when adding a class via OMAPI.
2674 - Check whether files are zero length before trying to parse them.
2676 - Ari Edelkind's PARANOIA patch has been included and may be compiled in
2677 via two ./configure parameters, --enable-paranoia and
2678 --enable-early-chroot.
2680 - ./configure was extended to cover many optional build features, such
2681 as failover, server tracing, debugging, and the execute() command.
2683 - There is now a default 1/4 of a second scheduled delay between delayed
2684 fsync()'s, it can be configured by the max-ack-delay configuration
2687 - A bug was fixed where the length of a hostname was miscalculated, so that
2688 hosts were given odd-looking domain names ("foo.bar.ba.example.com").
2690 - Shared network selection should be done from the innermost relay
2691 valid link-address field, rather than the outermost.
2693 - Prefix pools are attached to shared network scopes.
2695 - Merged IA_XX related structures.
2697 - Add DHCPv6 files in configure.
2699 - A memory leak when using omapi has been fixed.
2701 - DHCPv6 vendor-class options (VSIO) are now only sent when they appear
2702 on the DHCPv6 ORO. This resolves a bug where VSIO options were placed
2703 in IA_NA encapsulated options fields.
2705 - Integrated client with stateless, temporary address and prefix delegation
2708 - A double-dereference in dhclient transmission of DHCPDECLINEs was
2711 - Fix handling of format code 'Z'.
2713 - Support "-1" argument in DHCPv6.
2715 - Merge DHCPv6-only "dhcrelay6" into general-purpose "dhcrelay" (use
2716 "-6" option to select DHCPv6 mode).
2718 - Fix handling of -A and -a flags in dhcrelay; it was failing to expand
2719 packet size as needed to add relay agent options.
2721 - A bug in subnet6 parsing where options contained in subnet6 clauses would
2722 not be applied to clients addressed within that network was repaired.
2724 - When configuring a "subnet {}" or "subnet6 {}" without an explicit
2725 shared-network enclosing it, the DHCP software would synthesize a
2726 shared-network to contain the subnet. However, all configuration
2727 parameters within the subnet more intuitively belong "to any client
2728 on that interface", or rather the synthesized shared-network. So,
2729 when a shared-network is synthesized, it is used to contain the
2730 configuration present inside the subnet {} clause. This means that
2731 the configuration will be valid for all clients on that network, not
2732 just those addressed out of the stated subnet. If you intended the
2733 opposite, the workaround is to explicitly configure an empty
2736 - A bug was fixed where Information-Request processing was not sourcing
2737 configured option values.
2739 - A warning was added since the DHCPv6 processing software does not yet
2740 support class statements.
2742 - Compilation warnings on GCC 4.3 relating to bootp source address
2743 selection were repaired.
2745 - The v6 BSD socket method was updated to use a single UDP BSD socket
2746 no matter how many interfaces are involved, differentiating the
2747 interfaces the packets were received on by the interface index supplied
2750 - The relay agent no longer listens to the All DHCP Servers Multicast
2753 - A bug was fixed in data_string_sprintfa() where va_start was only called
2754 once for two invocations of vsprintf() variants.
2756 - ERO (RFC 4994) server support.
2758 - Basic and partial DHCPv6 leasequery support.
2760 - Reliable DHCPv6 release (previous behavior, send release and exit, is
2761 still available with dhclient -6 -1 -r).
2763 Changes since 4.0.0 (new features)
2765 - Added DHCPv6 rapid commit support.
2767 - Added explicit parser support for zero-length DHCP options, such as
2768 rapid-commit, via format code 'Z'.
2770 - It's now possible to update the "ends" field of a lease with OMAPI.
2771 This is useful if you want not only to release a lease, but also make
2772 it available for reuse right away. Hat tip to Christof Chen.
2774 - Fixed definition of the iaaddr hash functions to use the correct
2775 functions when referencing and dereferencing memory.
2777 - Some definitions not in phase with the IANA registry were updated.
2779 - Allocated interface IDs are better controlled ('u' bit set to zero,
2780 reserved IDs avoided).
2782 - Unicast options are taken into account only for RENEWs.
2784 - NoAddrsAvail answers to SOLICITs are always ADVERTISEs even when a SOLICIT
2785 carries a rapid-commit option.
2787 - Return in place of raise an impossible condition when one tries to release
2788 an empty active lease.
2790 - Timer granularity is now 1/100s in the DHCPv6 client.
2792 - The dhclient-script was updated to create a host route for the default
2793 gateway if the supplied subnet mask for an IPv4 address was a /32. This
2794 allows the client to work in 'captive' network environments, where the
2795 operator does not want clients to crosstalk directly.
2797 - MINUS tokens should be parsable again.
2799 - Multiple (up to "delayed-ack x;" maximum) DHCPv4 packets are now queued and
2800 released in bursts after single fsync() events when the upper limit is
2801 reached or if the receiving sockets go dry. The practical upshot is
2802 that fsync-coupled server performance is now multiplicitively increased.
2803 The default delayed ack limit is 28. Thanks entirely to a patch from
2806 Changes since 4.0.0 (bug fixes)
2808 - DHCP now builds on AIX.
2810 - Exit with warning when DHCPv6-specific statements are used in the
2811 config file but -6 is not specified.
2813 - Fixed "--version" flag in dhcrelay
2815 - The 'min-secs' configuration parameter's log message has been updated to
2818 - The warning logged when an address range doesn't fit in the subnets
2819 they were declared has been updated to be more helpful and identify the
2820 typo in configuration that created the spanning addresses.
2822 - A bug in failover pool rebalancing that caused POOLREQ message ping-pongs
2825 - A flaw in failover pool rebalancing that could cause POOLREQ messages to
2826 be sent outside of the min-balance/max-balance scheduled intervals has
2829 - A cosmetic bug during potential-conflict recovery that caused the peer's
2830 'conflict-done' state message to be logged as 'unknown-state' has been
2831 repaired. It is now logged correctly.
2833 - A bug was fixed where the 'giaddr' may be used to find the client's subnet
2834 rather than its own 'ciaddr'.
2836 - A log message was introduced to clarify the situation where a failover
2837 'address' parameter (the server's local address) did not resolve to an
2840 - The minimum site code value was set to 224 in 3.1.0 to track RFC3942. This
2841 broke a lot of legacy site local configurations. The new code in place will
2842 track site local space minimum option codes and logs a warning to encourage
2843 updates and exploration of site local code migration problems. Option
2844 codes less than 128 in site local spaces remain inaccessible.
2846 - A possible relay agent option bug was repaired where random server
2847 initialization state may have been used to signal the relay agent
2848 information options sub-option code for the 'END' of the option space.
2850 - Fixes to allow code to compile and run on Solaris 9.
2852 - Fixes to allow code to compile on Mac OS X Leopard (10.5).
2854 - When server is configured with options that it overrides, a warning is
2855 issued when the configuration file is read, rather than at the time the
2856 option is overridden. This was important, because the warning was given
2857 every time the option was overridden, which could create a lot of
2858 unnecessary logging.
2860 - Fixed a compilation problems on platforms that define a value for FDDI,
2861 which conflicts with a dhcp configuration syntax token by the same name.
2863 - When a failover server suspects it has encountered a peer running a
2864 version 3.0.x failover server, a warning that the failover wire protocol
2865 is incompatible is printed.
2867 - The failover server no longer issues a floating point error if it encounters
2868 a previously undefined option code.
2870 - Fix startup error messages to report a missing "subnet6 declaration", rather
2871 than a missing "subnet declaration", when running as a DHCPv6 server.
2873 - DHCPv6 client timestamp in DUID was based on the year 1970 rather
2876 - Warn when attempting to use a hardware parameter in DHCPv6.
2878 - DHCPv6 released resources are now marked as released by the client.
2880 - 'Soft' bindings have no more side-effects.
2882 Changes since 4.0.0b3
2884 - The reverse dns name for PTR updates on IPv6 addresses has been fixed to
2885 use ip6.arpa. rather than default to in-addr.arpa and require user
2888 - dhc6_lease_destroy() and dhc6_ia_destroy() now set lease and IA pointers
2889 to NULL after freeing, to prevent subsequent accesses to freed memory.
2891 - The DHCPv6 server would not send the preference option unless the
2892 client requested it, via the ORO. This has been fixed, so the DHCPv6
2893 server will always send the preference value if it is configured.
2895 - When addresses were passed as hints to the server in an IA, they were
2896 incorrectly handled, sometimes being treated as an error. Now the
2897 server will treat these as hints and ignore them if it cannot supply
2898 a requested address.
2900 - If the client had multiple addresses, and one expired (was not renewed
2901 by the server), the client would continue to attempt to renew the same
2902 old address over and over. Now, the client will omit any expired
2903 addresses from future Confirm, Renew, or Rebind messages.
2905 - dhclient -6 will now select renew/rebind timers based upon the longest
2906 address expiration time rather than the shortest expiration time, in
2907 order to avoid cascading renewals in the event a server elects not to
2908 extend one of multiple IAADDR leases.
2910 - The server now limits clients that request multiple addresses to one
2911 address per IA by default, which can be adjusted through the
2912 "limit-addrs-per-ia" configuration option.
2914 - The DHCPv6 client now issues fresh transaction IDs on Renew and Rebind
2915 message exchanges, rather than using the most recent ID.
2917 - The DHCPv6 server now replies to Information-Request messages.
2919 - A bug was fixed in the dhclient-script for BSDs to correctly carry error
2920 codes through some conditions.
2922 - The parsing of some options in the dhclient lease file, in particular
2923 the success DHCPv6 status-code, was fixed.
2925 - A bug was fixed that caused the DHCPv6 ORO option to be corrupted with
2926 seemingly random values.
2928 - A reference overleak in DHCPv6 shared network processing was repaired.
2930 - ./configure now autodetects local database locations rather than trying
2931 to put dhcpd.leases and dhclient.leases in /usr/local/var/db, which no
2934 - Regression fix for bug where server advertised a IPv6 address in
2935 response to a SOLICIT but would not return the address in response
2938 - A bug was fixed where the DHCPv6 server puts the NoAddrsAvail status
2939 code in the IA_NA was fixed. The status code now appears in the root
2942 Changes since 4.0.0b2
2944 - Clarified error message when lease limit exceeded
2946 - Relative time may now be used as a qualifier for 'allow' and 'deny' access
2947 control lists. These directives may be used to assist in re-addressing
2948 address pools without having to constantly reconfigure the server. Please
2949 see 'man dhcpd.conf' for more information on allow/deny 'after time' syntax.
2950 Thanks to a patch from Christof Chen.
2952 - The server will now include multiple IA_NA's and multiple IAADDRs within
2953 them, if advertised by the client. It still only seeks to allocate one
2956 Changes since 4.0.0b1
2958 - Use different paths for PID and lease files when running in DHCPv4
2959 or DHCPv6 mode, so that servers for both protocols can be run
2960 simultaneously on a single interface.
2962 - Fixed a buffer overflow error which could have allowed a denial
2963 of service under unusual server configurations
2965 - Eliminated a spurious error message from the client
2967 - A number of bugs with the internal handling of lease state on the
2968 server have been fixed. Some of these could cause server crashes.
2970 - The peer_wants_leases() changes pulled up from 3.1.0 were corrected,
2971 'never used' leases will no longer consistently shift between servers
2972 on every pool rebalance run.
2974 - sendmsg()/recvmsg() control buffers are now declared in such a way to
2975 ensure they are correctly aligned on all (esp. 64-bit) architectures.
2977 - The client leasing subsystem was streamlined and corrected to account
2978 more closely for changes in client link attachment selection.
2980 Changes since 4.0.0a3
2982 - The DHCP server no longer requires a "ddns-update-style" statement,
2983 and now defaults to "none", which means DNS updates are disabled.
2985 - Log messages when failover peer names mismatch have been improved to
2986 point out the problem.
2988 - Bug where server advertised a IPv6 address in response to a SOLICIT
2989 but would not return the address in response to a REQUEST. Thanks to
2990 Dennis Kou for finding the bug.
2992 - Fixed an error causing the server to lock up on lease expiration,
2993 reported independently by Jothilingam Vasu and Dennis Kou.
2995 - Fixed a ./configure bug where compile tests were failing due to
2996 "-Werror" (unused variable) rather than the actual test failure. Lead
2997 to inconsistent and unworkable auto-configurations.
2999 - Compilation with DLPI and -Werror has been repaired.
3001 - Error in decoding IA_NA option if multiple interfaces are present
3002 fixed by Marcus Goller.
3004 - DHCPv6 server Confirm message processing has been enhanced - it no
3005 longer replies only to clients with host {} records, it now replies
3006 as directed in RFC3315 section 18.2.2 - that is, to all clients
3007 regardless of the existence of bindings.
3009 - A core dump during expired lease cleanup has been repaired.
3011 - DDNS updates state information are now stored in 'binding scopes' that
3012 follow the leases through their lifecycles. This enables DDNS teardowns
3013 on leases that are assigned and expired inbetween a server restart (the
3014 state is recovered from dhcpd.leases). Arbitrary user-specified binding
3015 scopes ('set var = "value";') are not yet supported.
3017 - Additional compilation problems on HP/UX have been repaired.
3019 Changes since 4.0.0a2
3021 - Fix for startup where there are no IPv4 addresses on an interface.
3022 Thanks to Marcus Goller for reporting the bug.
3024 - Fixed file descriptor leak on listen failure. Thanks to Tom Clark.
3026 - Bug in server configuration parser caused server to get stuck on
3027 startup for certain bad pool declarations. Thanks to Guillaume
3028 Knispel for the bug report and fix.
3030 - Code cleaned to remove warnings reported by "gcc -Wall".
3032 - DHCPv6 is now the default. You can disable DHCPv6 support using the
3033 "--disable-dhcpv6" flag when you run the configure script.
3035 - An internal database inconsistency bug was repaired where the server
3036 would segfault if a client attempted to renew a lease that had been
3037 loaded from persistent storage.
3039 - 'request' and 'also request' syntaxes have been added to accommodate
3040 the DHCPv6 client configuration. 'send dhcp6.oro' is no longer
3043 - Bug fixed where configuration file parsing did not work with
3044 zero-length options; this made it impossible to set the
3045 rapid-commit option.
3047 - Bogus messages about host records with IPv4 fixed-addresses being of
3048 non-128-bits in length were removed.
3050 Changes since 4.0.0a1
3052 - Bug in octal parsing fixed. Thanks to Bernd Fuhrmann for the report
3055 - Autoconf now supplies proper flags for Solaris DHCPv6 builds.
3057 - Fix for parsing error on some IPv6 addresses.
3059 - Invalid CIDR representation for IPv6 subnets or ranges now checked
3060 for when loading configuration.
3062 - Compilation on HP/UX has been repaired. The changes should generally
3063 apply to any architecture that supplies SIOCGLIFCONF but does not
3064 use 'struct lifconf' structures to pass values.
3066 - Two new operators, ~= and ~~, have been integrated to implement
3067 boolean matches by regular expression (such as may be used in
3068 class matching statements). Thanks to a patch by Alexandr S.
3069 Agranovsky, which underwent slight modification.
3071 - Fix for icmp packets on 64-bit systems (bug introduced in 4.0).
3073 - A bug was fixed in interface discovery wherein an error identifying
3074 a server-configured interface with no IPv4 addresses would SEGV.
3076 - Fixed a bug in which write_lease() might report a failure incorrectly
3078 - Added support for DHCPv6 Release messages
3080 - Added -x option to dhclient, which triggers dhclient processes
3081 to exit gracefully without releasing leases first
3083 - All binaries (client, server, relay) now change directories
3084 to / before going into daemon mode, so as not to hold $CWD open
3086 - Fixed a bug parsing DHCPv6 client-id's in host-identifier statements
3088 - Fixed a bug with the 'ddns-updates' boolean server configuration
3089 parameter, which caused the server to fail.
3091 Changes since 4.0.0-20070413
3093 - Old (expired) leases are now cleaned.
3095 - IPv6 subnets now have support for arbitrary allocation ranges via
3096 a new 'range6' configuration directive.
3098 - An obviated option code hash lookup to find D6O_CLIENTID was removed.
3100 - Corrected some situations where variables might be used without being
3103 - Silenced several other compiler warnings.
3105 - Include the more standard sys/uio.h rather than rely upon other
3106 header files to include it (fixes a BSD 4.2 compile failure).
3108 - Duplicate dhclient-script updates for DHCPv6 to all provided scripts.
3110 - DHCPv4 I/O methods that failed to sense hardware address were corrected.
3112 - DHCPv4 is now the default (as documented) rather than DHCPv6. The default
3113 was set to DHCPv6 to facilitate ease early development, and forgotten.
3115 - Corrected a segmentation violation in DHCPv4 socket processing.
3117 - dhclient will now fork() into the background once it binds to an
3118 IPv6 address, or immediately if the -n flag is supplied.
3120 - -q is now the default behaviour on dhclient, with -d or -v enabling
3121 non-quiet (stderr logging) mode.
3123 - Fix documentation of the domain-search atom (quoted, with commas).
3125 - Document DHCPv6 options presently in the default table.
3127 - Replaced ./configure shellscripting with GNU Autoconf.
3129 Changes since 3.1.0 (NEW FEATURES)
3131 - DHCPv6 Client and Server protocol support. Use '-6' to run the daemons
3132 as v6-only. Use '-4' to run the daemons as v4-only (default. There is
3133 no support currently for both.
3135 - Server support for multiple IA_NA options, containing at most one
3138 - Client support for one IA_NA option, containing any number of IAADDR
3141 - Server support for the DHCPv6 Information-request message.
3143 - Inappropriate unicast DHCPv6 messages sent to the server are now
3144 discarded, and this has rearchitected the IO system slightly.
3146 - The DHCPv6 server DUID defaults to type 1, is persistently stored in
3147 the leases database, and can be over-ridden (either completely, or by
3148 specifying type 1 or type 2).
3150 - The server only uses Rapid-Commit if it has been configured with the
3151 Rapid-Commit option and the client requests it.
3153 - DDNS support. We now update AAAA records in the same place we would
3154 update A records, if we have an IPv6 address. We also generate IP6.ARPA
3155 style names for PTR records if we're dealing with an IPv6 address. Both
3156 A and AAAA updates are done using the same 'fqdn.' virtual option space
3157 (although the DHCPv4 FQDN and DHCPv6 FQDN options are formatted
3158 differently, they both use the same code here).
3160 - The Linux dhclient-script attempts to set and remove assigned addresses,
3161 and to configure /etc/resolv.conf from nameserver and domain name
3162 configurations. It can be extended to configure other parameters.
3164 - Initial DHCPv6 lease support.
3166 - The IO system now tracks all local IP addresses, so that the DHCP
3167 applications (particularly the dhcrelay) can discern between what frames
3168 were transmitted to it, and what frames are being carried through it which
3169 it should not intercept.
3171 Changes since 3.1.0 (Maintenance)
3173 - A bug was repaired where MAC Address Affinity for virgin leases always
3174 mapped to the primary. Virgin leases now have an interleaved preference
3175 between primary and secondary.
3177 - A bug was repaired where MAC Address Affinity for clients with no client
3178 identifier was sometimes mishashed to the peer. Load balancing during
3179 runtime and pool rebalancing were opposing.
3181 - An assertion in lease counting relating to reserved leases was repaired.
3183 - The subnet-mask option inclusion now conforms with RFC2132 section 3.3;
3184 it will only appear prior to the routers option if it is present on the
3185 Parameter-Request-List. The subnet-mask option will also only be
3186 included by default (if it is not on the PRL) in response to DISCOVER
3187 or REQUEST messages.
3189 - The FQDN option is only supplied if the client supplied an FQDN option or
3190 if the FQDN option was explicitly requested on the PRL.
3192 - Dynamic BOOTP leases are now load balanced in failover.
3194 Changes since 3.1.0rc1
3196 - The parse warning that 'deny dynamic bootp;' must be configured for
3197 failover protected subnets was removed.
3199 Changes since 3.1.0b2
3201 - Failover rebalance events no longer play ping pong with round errors
3202 (moving leases between free and back to backup where there are an
3203 odd number of leases).
3205 - The 'pool' log line has been split into two messages, one before the
3206 rebalance run, and one after.
3208 - Any queued BNDACKs are transmitted before transmitting new BNDUPDs.
3209 This enforces the correct sequence of events for the remote server
3210 processing these messages.
3212 Changes since 3.1.0b1
3214 - Fixed a bug that caused OMAPI clients to freeze when opening lease
3217 - A new server config option "fqdn-reply" specifies whether the server
3218 should send out option 81 (FQDN). Defaults to "on". If set to "off",
3219 the FQDN option is not sent, even if the client requested it. This is
3220 needed because some clients misbehave otherwise. Thanks to Christof Chen
3223 - Allow trace output files (-tf option) to be overwritten, rather than
3224 crashing dhcpd if the file already exists
3226 - A bug was fixed that caused dhcpd to segfault if a pool was declared
3227 outside the scope of a subnet in dhcpd.conf.
3229 - Some uninitialized values were repaired in dhcpleasequery.c that
3230 caused the server to abort.
3232 - A new server config option, 'do-reverse-updates', has been added
3233 which causes the server to abstain from performing updates on PTR
3234 records. Thanks to a patch from Christof Chen at Allianz.
3236 - A bug was repaired in subencapsulation support, where spaces separated
3237 by empty spaces would not get included.
3239 - A bug in dhclient was repaired which caused it to send parameter request
3240 lists of 55 bytes in length no matter how long the declared PRL was.
3242 - 'dhcp.c(3953): non-null pointer' has been repaired. This fixes a flaw
3243 wherein the DHCPv4 server may ignore a configured server-identifier.
3245 - A flaw in failover startup sequences was repaired that sometimes left
3246 the primary DHCP server's pool rebalance schedules unscheduled.
3248 - Corrected a flaw that broke encapsulated spaces included due to presence
3249 on the parameter request list.
3251 Changes since 3.1.0a3
3253 - Some spelling fixes.
3255 Changes since 3.1.0a2
3257 - A bug was fixed where attempting to permit leasequeries results in a
3258 fatal internal error, "Unable to find server option 49".
3260 - A bug was fixed in dhclient rendering the textual output form of the
3261 domain-search option syntax.
3263 Changes since 3.1.0a1
3265 - A bug in the FQDN universe that added FQDN codes to the NWIP universe's
3266 hash table was repaired.
3268 - The servers now try harder to transmit pending binding updates when
3269 entering normal state.
3271 - UPDREQ/UPDREQALL handling was optimized - it no longer dequeues and
3272 requeues all pending updates. This should reduce the number of spurious
3273 'xid mismatch' log messages.
3275 - An option definition referencing leak was fixed, which resulted in early
3276 termination of dhclient upon the renewal event.
3278 - Some default hash table sizes were tweaked, some upwards, some downwards.
3279 3.1.0a1's tables resulted in a reduction in default server memory use.
3280 The new selected values provide more of a zero sum (increasing the size
3281 of tables likely to be populated, decreasing the size of tables unlikely).
3283 - Lease structures appear in three separate hashes: by IP address, by UID,
3284 and by hardware address. One type of table was used for all three, and
3285 improvements to IP address hashing were applied to all three (so UID and
3286 hardware addresses were treated like 4-byte integers). There are now two
3287 types of tables, and the uid/hw hashes use functions more appropriate
3290 - The max-lease-misbalance percentage no longer causes scheduled rebalance
3291 runs to be skipped: it still governs the schedule, but every scheduled
3292 run will attempt balance.
3294 - A segfault bug in recursive encapsulation support has been corrected.
3296 Changes since 3.0 (New Features)
3298 - A workaround for certain STSN servers that send a mangled domain-name
3299 option was introduced for dhclient. The client will now accept corrupted
3300 server responses, if they contain a valid DHCP_MESSAGE_TYPE (OFFER, ACK,
3301 or NAK). The server will continue to not accept corrupt client packets.
3303 - Support for 'reserved' (pseudo-static) and BOOTP leases via failover
3306 - Support for adding, removing, and managing class and subclass statements
3309 - The failover implementation was updated to comply with revision 12 of
3312 - 'make install' now creates the initial zero-length dhcpd.leases file if
3313 one does not already exist on the system.
3315 - RFC3942 compliance, site-local option spaces start at 224 now, not 128.
3317 - The Load Balance Algorithm was misimplemented. The current implementation
3320 - lcase() and ucase() configuration expressions have been added which adjust
3321 their arguments from upper to lower and lower to upper cases respectively.
3322 Thanks to a patch from Albert Herranz.
3324 - The dhclient 'reject ...;' statement, which rejects leases given by named
3325 server-identifiers, now permits address ranges to be specified in CIDR
3326 notation. Thanks to a patch from David Boyce.
3328 - The subnet-mask option is now supplied by default, but at lowest
3329 priority. This helps a small minority of clients that provide parameter
3330 request lists, but do not list the subnet-mask option because they were
3331 designed to interoperate with a server that behaves in this manner.
3333 - The FQDN option is similarly supplied even if it does not appear on the
3334 parameter request list, but not to the exclusion of options that do
3335 appear at the parameter request list. Up until now it had ultimate
3336 priority over the client's parameter request list.
3338 - Varying option space code and length bit widths (8/16/32) are now
3339 supported. This is a milestone in achieving RFC 3925 "VIVSO" and
3342 - A new common (server or client) option, 'db-time-format local;', has
3343 been added which prints the local time in /var/db/dhcpd.leases rather
3344 than UTC. Thanks to a patch from Ken Lalonde.
3346 - Some patches to improve DHCP Server startup speed from Andrew Matheson
3347 have been incorporated.
3349 - Failover pairs now implement 'MAC Affinity' on leases moving from the
3350 active to free states. Leases that belonged to the failover secondary
3351 are moved to BACKUP state rather than FREE upon exiting EXPIRED state.
3352 If lease rebalancing must move leases, it tries first to move leases
3353 that belong to the peer in need.
3355 - The server no longer sends POOLREQ messages unless the pool is severely
3356 misbalanced in the peer's favor (see 'man dhcpd.conf' for more details).
3358 - Pool rebalance events no longer happen upon successfully allocating a
3359 lease. Instead, they happen on a schedule. See 'man dhcpd.conf' for the
3360 min-balance and max-balance statements for more information.
3362 - The DHCP Relay Agent Information Option / Link Selection Sub-Option
3363 is now supported. (See RFC3527 for details).
3365 - A new DDNS related server option, update-conflict-detection, has been
3366 added. If this option is enabled, dhcpd will perform normal DHCID
3367 conflict resolution (the default). If this option is disabled, it will
3368 instead trust the assigned name implicitly (removing any other bindings
3369 on that name). This option has not been made available in dhclient.
3371 - In those cases where the DHCP software manufactures an IP header (to
3372 transmit via bpf, lpf, etc), the IP TTL the software selects has been
3373 increased from 16 to 128. This is intended to match Microsoft Windows
3374 DHCP Client behaviour, to increase compatibility.
3376 - 'ignore client-updates;' now has behaviour that is different from
3377 'deny client-updates;'. The client's request is not truly ignored,
3378 rather it is encouraged. Should this value be configured, the server
3379 updates DNS as though client-updates were set to 'deny'. That is, it
3380 enters into DNS whatever it is configured to do already, provided it is
3381 configured to. Then it sends a response to the client that lets the
3382 client believe it is performing client updates (which it will), probably
3383 for a different name. In essence, this lets the client do as it will,
3384 ignoring this aspect of their request.
3386 - Support for compressed 'domain name list' style DHCP option contents, and
3387 in particular the domain search option (#119) was added.
3389 - The DHCP LEASEQUERY protocol as defined in RFC4388 is now implemented.
3390 LEASEQUERY lets you query the DHCP server for information about a lease,
3391 using either an IP address, MAC address, or client identifier. Thanks
3392 to a patch from Justin Haddad.
3394 - DHCPD is now RFC2131 section 4.1 compliant (broadcast to all-ones ip and
3395 ethernet mac address) on the SCO platform specifically without any strange
3396 ifconfig hacks. Many thanks go to the Kroger Co. for donating the
3397 hardware and funding the development.
3399 - A new common configuration executable statement, execute(), has been
3400 added. This permits dhcpd or dhclient to execute a named external
3401 program with command line arguments specified from other configuration
3402 language. Thanks to a patch written by Mattias Ronnblom, gotten to us
3405 - A new dhcp server option 'adaptive-lease-time-threshold' has been added
3406 which causes the server to substantially reduce lease-times if there are
3407 few (configured percentage) remaining leases. Thanks to a patch submitted
3410 - Encapsulated option spaces within encapsulated option spaces is now
3413 Changes since 3.0.6rc1
3415 - supersede_lease() now requeues leases in their respective hardware
3416 address hash bucket. This mirrors client identifier behaviour.
3420 - Assorted fixes for broken network devices: Packet length is now
3421 determined from the IP header length field to finally calculate the
3422 UDP payload length, because some NIC drivers return more data than
3423 they actually received.
3425 - UDP packets are now stored in aligned data structures.
3427 - A logic error in omapi interface code was repaired that might result in
3428 incorrectly indicating 'up' state when any flags were set, rather than
3429 specifically the INTERFACE_REQUESTED flag. Thanks to a patch from
3430 Jochen Voss which got to us via Andrew Pollock at Debian.
3432 - A reference leak on binding scopes set by ddns updates was repaired.
3434 - A memory leak in the minires_nsendsigned() function call was repaired.
3435 Effectively, this leaked ~176 bytes per DDNS update.
3437 - In the case where an "L2" DHCP Relay Agent (one that does not set giaddr)
3438 was directly attached to the same broadcast domain as the DHCP server,
3439 the RFC3046 relay agent information option was not being returned to the
3440 relay in the server's replies. This was fixed; the dhcp server no longer
3441 requires the giaddr to reply with relay agent information. Note that
3442 this also improves compatibility with L2 devices that "intercept" DHCP
3443 packets and expect relay agent information even in unicast (renewal)
3444 replies. Thanks to a patch from Pekka Silvonen.
3446 - A bug was fixed where the BOOTP header 'sname' field had a value, the
3447 copy written to persistent storage was actually the contents of the
3450 - A bug was fixed where the nwip virtual option space was referencing
3451 the fqdn option's virtual option space's option cache.
3453 - Timestamp parsing errors that indicated missing "minutes" fields rather
3454 than the actually missing "seconds" fields have been repaired thanks to
3455 a patch from Kevin Steves.
3457 - A grammar error in the dhclient.8 manpage was repaired thanks to a patch
3460 - Several spelling typos were repaired, and some cross-references to other
3461 relevant documents were included in the manpages, thanks to a patch
3462 by Andrew Pollock which got to us via Tomas Pospisek.
3464 - Some bugs were fixed in the 'emergency relay agent options hologram'
3465 which is used to retain relay agent option contents from when the
3466 client was in INIT or REBIND states. This should solve problems where
3467 relay agent options were not echoed from the server, even when giaddr
3470 - dhclient now closes its descriptor to dhclient.leases prior to executing
3471 dhclient-script. Thanks to a patch from Tomas Pospisek.
3473 - The server's "by client-id" and "by hardware address" hash table lists
3474 are now sorted according to the preference to re-allocate that lease to
3475 returning clients. This should eliminate pool starvation problems
3476 arising when "INIT" clients were given new leases rather than presently
3479 Changes since 3.0.5rc1
3481 - A bug was repaired in fixes to the dhclient, which sought to run the
3482 dhclient-script with the 'EXPIRE' state should it receive a NAK in
3483 response to a REQUEST. The client now iterates the PREINIT state
3484 after the EXPIRE state, so that interfaces that might be configured
3485 'down' can be brought back 'up' and initialized.
3487 - DHCPINFORM handling for clients that properly set ciaddr and come to the
3488 server via a relay aget has been repaired.
3492 - A warning that host statements declared within subnet or shared-network
3493 scopes are actually global has been added.
3495 - The default minimum lease time (if min-lease-time was not specified)
3496 was raised from 0 to 300. 0 is not thought to be sensible, and is
3497 known to be damaging.
3499 - Added additional fatal error sanity checks surrounding lease binding
3500 state count calculations (free/active counts used for failover pool
3503 - Some time value size fixes in 3.0.4 brought on from FreeBSD /usr/ports were
3504 misapplied to server values rather than client values. The server no longer
3505 advertises 8-byte lease-time options when on 64-bit platforms.
3507 - A bug where leases not in ACTIVE state would get billed to billed classes
3508 (classes with lease limitations) was fixed. Non-active leases OFFERed
3509 to clients are no longer billed (but billing is checked before offering).
3511 - The dhcpd.conf.5 manpage was updated in regard to the ddns-domainname
3512 configuration option - the default configuration and results should be
3515 - If the dhclient were to receive a DHCPNAK while it was in the RENEW
3516 state (and consequently, had an active, 'bound' address and related
3517 configuration options), it would fail to 'tear down' this information
3518 before proceeding into INIT state. dhclient now iterates the dhclient-
3519 script with the 'EXPIRE' action to cause these teardowns prior to entering
3520 INIT state. Thanks to a patch from Chris Zimmerman.
3522 - The omapi.1 manpage had some formatting errors repaired thanks to a patch
3523 from Yoshihiko Sarumaru.
3525 - A few lines of code that were failover-specific were moved within
3526 #if defined() clauses so that compilation without failover could be
3529 - The log message emitted when the 'leased-address' value was not available
3530 in dhcpd.conf "executable statements" has been updated to be more helpful.
3531 Manpage information for this value has also been updated.
3533 - Abandoned or dissociated (err condition) leases now remove any related
3534 dynamic dns bindings. Thanks to a patch from Patrick Schoo.
3536 - Attempting to write a new lease file to replace a corrupt (due to
3537 encountering non-retryable errors during writing) lease file should
3538 no longer result in an infinite recursion.
3540 - Host declaration hardware addresses and client identifiers may only be
3541 configured once. dhcpd will now fail to load config files that specify
3542 multiple identifiers (previous versions would silently over-ride the
3543 value with the later configured value).
3545 - Several option codes that have been allocated since our last release
3546 have been named and documented.
3548 - Option names of the form "unknown-123" have been removed from the in-
3549 memory hash tables. In order to support options of these names that
3550 may appear in dhclient.leases or similar in previous versions, the
3551 parser will now find the new option code definition, or mock up a
3552 generic option code definition. This should result in a smooth
3553 transition from one name to the other, as the new name is used to
3556 Changes since 3.0.4rc1
3558 - The dhcp-options.5 manpage was updated to correct indentation errors
3559 thanks to a patch from Jean Delvare.
3561 Changes since 3.0.4b3
3563 - Some manual pages were clarified pursuant to discussion on the dhcp-server
3566 Changes since 3.0.4b2
3568 - Null-termination sensing for certain clients that unfortunately require
3569 it in DHCPINFORM processing was repaired.
3571 - The host-name option and a few others were moved from "X" format to "t"
3572 format to be compatible with new NULL handling functions.
3574 - DHCPINFORM processing is a little more careful about return addressing
3575 its responses, or if responding via a relay. The INFORM related
3576 messages also log the 'effective client ip address' rather than the
3577 client's supplied ciaddr (since some clients produce null ciaddrs).
3579 - The server was inappropriately sending leases to the RESET state in the
3580 event that multiple active leases were found to match a singly-identified
3581 client. This was changed to RELEASED (by accepting a different, ACTIVE
3582 binding, the client is implicitly releasing its lease). This repairs a
3583 bug wherein secondary servers in failover pairs detecting this condition
3584 move leases to RESET, and primaries refuse to accept that state
3585 transition (properly).
3587 - The memset-after-dmalloc() changes made in 3.0.4b1 have been backed out.
3589 Changes since 3.0.4b1
3591 - Command line parsing in omshell was repaired - it no longer closes
3592 STDIN after reading one line.
3594 - The resolver library no longer closes the /etc/resolv.conf file
3595 descriptor it opened twice.
3597 - Changes to trailing NULL removal in 't' option-atoms has been rethought,
3598 it now includes 'd' (domain name) types, and tries hard not to rewind an
3599 option beyond the start of the text field it is un-terminating.
3603 - A DDNS update handling function was misusing the DNS error codes, rather
3604 than the internal generic result enumeration. The result is a confusing
3605 syslog line, logging the wrong condition.
3607 - The DHCP Server was not checking pool balance in the case where it brought
3608 a non-ACTIVE lease out of storage for a client that was returning to use
3609 a lease it once had long ago, and had since expired.
3611 - Failover peers no longer bother to look for free leases to allocate when
3612 they already found the client's ACTIVE lease. DISCOVERs are load balanced
3613 whether freely-allocated or not, unless the server doubts the peer has
3616 - Fixed a bug in dhcrelay agent addition code that suppressed trailing
3617 PAD options - it was suppressing only one trailing PAD option, rather
3618 than the entire block of them.
3620 ! Fixed some unlikely overlapping-region memcpy() bugs in dhcrelay agent
3621 option addition and stripping code. Added a few sanity checks. Although
3622 highly improbable, due to requiring the reception of a DHCP datagram well
3623 in excess of all known to be used physical MTU limitations, it is possible
3624 this may have been used in a stack overflow security vulnerability. Thanks
3625 to a patch from infamous42md.
3627 ! Added some sanity checks to OMAPI connection/authentication code.
3628 Although highly improbable, due to having to deliver in excess of 2^32
3629 bytes of data via the OMAPI channel, not to mention requiring dhcpd to
3630 be able to malloc() a memory region 2^32 bytes in size, it was possible
3631 this might have resulted in a heap overflow security vulnerability.
3632 Thanks to a patch from infamous42md.
3634 - dmalloc() memset()'s the non-debug (data) portion of the allocated
3635 memory to zero. Code that memset()'s the result returned by dmalloc() to
3636 zero is redundant. These redundancies were removed.
3638 - Some type declaration corrections to u_int16_t were made in common/tr.c
3639 (Token Ring support) thanks to a patch from Jason Vas Dias at Red Hat.
3641 - A failover bug that was allowing leases that EXPIRED or were RELEASED
3642 where tsfp and tstp are identical timestamps to languish in these
3643 transitional states has been repaired. As a side effect, lease
3644 databases should be kept more consistent overall, not just for these
3645 transitional states.
3647 - If the lease db is deleted out from under the daemon, and it moves to rewrite
3648 the db, it will go ahead with the operation and move the new db into place
3649 once it detects the old db does not exist.
3651 - dhclient now ignores IRDA, SIT, and IEEE1394 network interfaces, as it
3652 is either nonsensical or (in the case of IEEE1394) is not known to support
3653 these interfaces. Thanks to Marius Gedminas and Andrew Pollock of Debian.
3655 - Some previously undocumented reasons for dhclient-script invoking has
3656 been documented in the dhclient-script.8 manpage.
3658 - Failover potential expiry calculations (TSTP) have been corrected. Results
3659 should be substantially more consistent, and proper given the constraints.
3661 - Adjusted lease state validation checks in potential-conflict, to
3662 account for possible clock skew similarly to normal state, and several
3663 previously illegal transitions were made legal (ex: active->released).
3665 - An impossible sanity check was removed from omapi/buffer.c, thanks to a
3666 patch from 'infamous42md'.
3668 - An OMAPI host/network byte order problem in lease time values has been
3671 - Several minor bugs, largely relating to treating 8-byte time values as
3672 4-byte entities, have been repaired after careful review of the FreeBSD
3673 ports collection's patch set. Thanks to the nameless entities who have
3674 contributed to the FreeBSD ports.
3676 - When writing a trace file, the file is now created with permissions 0600,
3677 to help administrators avoid accidentally publicising sensitive config
3680 - The calculation of the maximum size of DHCP packets no longer includes
3681 Ethernet framing overhead. The result is that the 'Maximum Message
3682 Size' option advertised by clients, or the default value 576, is no
3683 longer reduced by 14 bytes, and instead directly reflects the IP level
3684 MTU (and the default, minimum allowed IP MTU of 576).
3686 - The special status of RELEASED/EXPIRED/RESET leases when a server
3687 is operating in partner-down was fixed. It no longer requires a
3688 lease be twice the MCLT beyond STOS to 'reallocate', and the expiry
3689 event to turn these into FREE leases without peer acknowledgement
3690 (after STOS+MCLT) has been repaired.
3692 - Compilation on older Solaris systems (lacking /usr/include/sys/int_types.h)
3695 - "append"ing a string onto the end of a "t" type option (such as the
3696 domain-name field) that had been improperly NULL-terminated by the
3697 DHCP server will no longer result in a truncated string containing
3698 only the option from the server, and not the expected appended value.
3699 Thanks to a patch from Jason Vas Dias at Red Hat.
3701 - File handlers on configuration state (config files and lease dbs) should
3702 be treated consistently, regardless of whether TRACING is defined or not.
3704 - The Linux build environment has had some minor improvements - better
3705 sensing of 64-bit pointer sizes (only used for establishing an icmp_id),
3706 and corrections to #if operators regarding LINUX_MAJOR should it ever
3709 - The server now tries harder to survive the condition where it is unable
3710 to open a new lease file to rewrite the lease state database.
3712 Changes since 3.0.3b3
3714 - dhclient.conf documentation for interface {} was updated to reflect recent
3715 discussion on the dhcp-hackers mailing list.
3717 - In response to reports that the software does not compile on GCC 4.0.0,
3718 -Werror was removed from Makefile.conf for all platforms that used it.
3719 We will address the true problem in a future release; this is a temporary
3722 Changes since 3.0.3b2
3724 - An error in code changes introduced in 3.0.3b2 was corrected, which caused
3725 static BOOTP clients to receive random addresses.
3727 Changes since 3.0.3b1
3729 - A bug was fixed in BOOTPREQUEST handling code wherein stale references to
3730 host records would be left behind on leases that were not allocated to the
3731 client currently booting (eg in the case where the host was denied booting).
3733 - The dhcpd.conf.5 manpage was updated to be more clear in regards to
3734 multiple host declarations (thanks to Vincent McIntyre). 'Interim' style
3735 dynamic updates were also retouched.
3739 - A bug was fixed where a server might load balance a DHCP REQUEST to its
3740 peer after already choosing not to load balance the preceding DISCOVER.
3741 The peer cannot allocate the originating server's lease.
3743 - In the case where a secondary server lost its stable storage while the
3744 primary was still in communications-interrupted, and came back online,
3745 the lease databases would not be fully transferred to the secondary.
3746 This was due to the secondary errantly sending an extra UPDREQ message
3747 when the primary made its state transition to PARTNER-DOWN known.
3749 - The package will now compile cleanly in gcc 3.3 and 3.4. As a side effect,
3750 lease structures will be 9 bytes smaller on all platforms. Thanks to
3751 Jason Vas Dias at Red Hat.
3753 - Interface discovery code in DISCOVER_UNCONFIGURED mode is now
3754 properly restricted to only detecting broadcast interfaces. Thanks
3755 to a patch from Jason Vas Dias at Red Hat.
3757 - decode_udp_ip_header was changed so that the IP address was copied out
3758 to a variable, rather than referenced by a pointer. This enforces 4-byte
3759 alignment of the 32-bit IP address value. Thanks to a patch from Dr.
3762 - An incorrect log message was corrected thanks to a patch from
3765 - A bug in DDNS was repaired, where if the server's first DDNS action was
3766 a DDNS removal rather than a DDNS update, the resolver library's
3767 retransmit timer and retry timer was set to the default, implying a
3768 15 second timeout interval. Which is a little excessive in a synchronous,
3769 single-threaded system. In all cases, ISC DHCP should now hold fast to
3770 a 1-second timeout, trying only once.
3772 - The siaddr field was being improperly set to the server-identifier when
3773 responding to DHCP messages. RFC2131 clarified the siaddr field as
3774 meaning the 'next server in the bootstrap process', eg a tftp server.
3775 The siaddr field is now left zeroed unless next-server is configured.
3777 - mockup_lease() could have returned in an error condition (or in the
3778 condition where no fixed-address was found matching the shared
3779 network) with stale references to a host record. This is probably not
3780 a memory leak since host records generally never die anyway.
3782 - A bug was repaired where failover servers would let stale client identifiers
3783 persist on leases that were reallocated to new clients not sending an id.
3785 - Binding scopes ("set var = value;") are now removed from leases allocated
3786 by failover peers if the lease had expired. This should help reduce the
3787 number of stale binding scopes on leases.
3789 - A small memory leak was closed involving client identifiers larger than
3790 7 bytes, and failover.
3792 - Configuring a subnet in dhcpd.conf with a subnet mask of 32 bits might
3793 cause an internal function to overflow heap. Thanks to Jason Vas Dias
3796 - Some inconsistencies in treating numbers that the lexer parsed as 'NUMBER'
3797 or 'NUMBER_OR_NAME' was repaired. Hexadecimal parsing is affected, and
3800 - In several cases, parse warnings were being issued before the lexical
3801 token had been advanced to the token whose value was causing an error...
3802 causing parse warnings to claim the problem is on the wrong token.
3804 - Host declarations matching on client identifier for dynamic leases will
3805 no longer match fixed-address host declarations (this is now identical
3806 to behaviour for host records matching on hardware address).
3808 Changes since 3.0.2rc3
3810 - A previously undocumented configuration directive, 'local-address',
3811 was documented in the dhcpd.conf manpage.
3813 Changes since 3.0.2rc2
3815 - Two variables introduced in 3.0.2b1 were used without being initialized
3816 in the case where neither the FILE nor SNAME fields were available for
3817 overloading. This was repaired.
3819 - A heretofore believed to be impossible corner case of the option
3820 overloading implementation turned out to be possible ("Unable to sort
3821 overloaded options after 10 tries."). The implementation was reworked
3822 to consider the case of an option so large it would require more than
3823 three chunks to fit.
3825 - Many other instances of variables being used without being initialized
3828 - An uninitialized variable in omapi_io_destroy() led to the discovery
3829 that this function may result in orphaned pointers (and hence, a memory
3832 Changes since 3.0.2rc1
3834 - allocate_lease() was rewritten to repair a bug in which the server would
3835 try to allocate an ABANDONED lease when FREE leases were available.
3837 Changes since 3.0.2b1
3839 - Some dhcp-eval.5 manpage formatting was repaired.
3843 - A bug was fixed in the server's 'option overloading' implementation,
3844 where options loaded into the 'file' and 'sname' packet fields were
3845 not aligned precisely as rfc2131 dictates.
3847 - The FreeBSD client script was changed to support the case where a domain
3848 name was not provided by the server.
3850 - A memory leak in 'omshell' per each command line parsed was
3851 repaired, thanks to a patch from Jarkko Torppa.
3853 - Log functions writing to stderr were adjusted to use the STDERR_FILENO
3854 system definition rather than '2'. This is a no-op for 90% of platforms.
3856 - One call to trace_write_packet_iov() counted the number of io vectors
3857 incorrectly, causing inconsistent tracefiles. This was fixed.
3859 - Some expression parse failure memory leaks were closed.
3861 - A host byte order problem in tracefiles was repaired.
3863 - Pools configured in DHCPD for failover possessing permission lists that
3864 previously were assumed to not include dynamic bootp clients are now
3865 a little more pessimistic. The result is, dhcpd will nag you about just
3866 about most pools that possess a 'allow' statement with no 'deny' that
3867 would definitely match a dynamic bootp client.
3869 - The 'ddns-update-style' configuration warning bit now insists that
3870 the configuration be globally scoped.
3872 - Two memory leaks in dhclient were closed thanks to a patch from Felix
3875 - Some minor but excellently pedantic documentation errors were fixed
3876 thanks to a patch from Thomas Klausner.
3878 - Bugs in operator precedence in executable statements have been repaired
3879 once again. More legal syntaxes should be parsed legally.
3881 - Failing to initialize a tracefile for any reason if a tracefile was
3882 specified is now a fatal error. Thanks to a patch from Albert Herranz.
3884 - Corrected a bug in which the number of leases transferred as calculated
3885 by the failover primary and sent to peers in POOLRESP responses may be
3886 incorrect. This value is not believed to be used by other failover
3887 implementations, excepting perhaps as logged information.
3889 - Corrected a bug in which 'dhcp_failover_send_poolresp()' was in fact
3890 sending POOLREQ messages instead of POOLRESP mesasges. This message
3891 was essentially ignored since failover secondaries effectively do not
3892 respond to POOLREQ messages.
3894 - Type definitions for various bitwidths of integers in the sunos5-5
3895 build of ISC DHCP have been fixed. It should compile and run more
3896 easily when built in 64-bit for this platform.
3898 - "allow known-clients;" is now a legal syntax, to avoid confusion.
3900 - If one dhcp server chooses to 'load balance' a request to its failover
3901 peer, it first checks to see if it believes said peer has a free
3902 lease to allocate before ignoring the DISCOVER.
3904 - log() was logging a work buffer, rather than the value returned by
3905 executing the statements configured by the user. In some cases,
3906 the work buffer and the intended results were the same. In some other
3907 cases, they were not. This was fixed thanks to a patch from Gunnar
3908 Fjone and directconnect.no.
3910 - Compiler warnings for some string type conversions was fixed, thanks
3911 to Andreas Gustafsson.
3913 - The netbsd build environments were simplified to one, in which
3914 -Wconversion is not used, thanks to Andreas Gustafsson.
3916 - How randomness in the backoff-cutoff dhclient configuration variable
3917 is implemented was better documented in the manpage, and the behaviour
3918 of dhclient in REQUEST timeout handling was changed to match that of
3919 DISCOVER timeout handling.
3921 - Omapi was hardened against clients that pass in null values, thanks
3922 to a patch from Mark Jason Dominus.
3924 - A bug was fixed in dhclient that kept it from doing client-side
3925 ddns updates. Thanks to a patch from Andreas Gustafsson, which
3926 underwent some modification after review by Jason Vas Dias.
3928 - Failover implementations disconnected due to the network between
3929 them (rather than one of the two shutting down) will now try to
3930 re-establish the failover connection every 5 seconds, rather than
3931 to simply try once and give up until one of them is restarted.
3932 Thanks to a patch from Ulf Ekberg from Infoblox, and field testing
3933 by Greger V. Teigre which led to an enhancement to it.
3935 - A problem that kept DHCP Failover secondaries from tearing down
3936 ddns records was repaired. Thanks to a patch from Ulf Ekberg from
3939 - 64bit pointer sizes are detected properly on FreeBSD now.
3941 - A bug was repaired where the DHCP server would leave stale references
3942 to host records on leases it once thought about offering to certain
3943 clients. The result would be to apply host and 'known' scopes to the
3944 wrong clients (possibly denying booting). NOTE: The 'mis-host' patch
3945 that was being circulated as a workaround is not the way this bug was
3946 fixed. If you were a victim of this bug in 3.0.1, you are cautioned
3947 to proceed carefully and see if it fixes your problem.
3949 - A bug was repaired in the server's DHCPINFORM handling, where it
3950 tried to divine the client's address from the source packet and
3951 would get it wrong. Thanks to Anshuman Singh Rawat.
3953 - A log message was introduced to help illuminate the case where the
3954 server was unable to find a lease to assign to any BOOTP client.
3955 Thanks to Daniel Baker.
3957 - A minor dhcpd.conf.5 manpage error was fixed.
3959 Changes since 3.0.1rc14
3961 - The global variable 'cur_time' was centralized and is now uniformly of a
3962 type #defined in system-dependent headers. It had previously been defined
3963 in one of many places as a 32-bit value, and this causes mayhem on 64-bit
3964 big endian systems. It probably wasn't too healthy on little endian
3967 - A printf format string error introduced in rc14 was repaired.
3969 - AIX system-dependent header file was altered to only define NO_SNPRINTF
3970 if the condition used to #ifdef in vsnprintf in AIX' header files
3973 - The Alpha/OSF system-dependent header file was altered to define
3974 NO_SNPRINTF on OS revisions older than 4.0G.
3976 - omapip/test.c had string.h added to its includes.
3978 Changes since 3.0.1rc13
3980 ! CAN-2004-0460 - CERT VU#317350: Five stack overflow exploits were closed
3981 in logging messages with excessively long hostnames provided by the
3982 clients. It is highly probable that these could have been used by
3983 attackers to gain arbitrary root access on systems using ISC DHCP 3.0.1
3984 release candidates 12 or 13. Special thanks to Gregory Duchemin for
3985 both finding and solving the problem.
3987 ! CAN-2004-0461 - CERT VU#654390: Once the above was closed, an opening
3988 in log_*() functions was evidenced, on some specific platforms where
3989 vsnprintf() was not believed to be available and calls were wrapped to
3990 sprintf() instead. Again, credit goes to Gregory Duchemin for finding
3991 the problem. Calls to snprintf() are now linked to a distribution-local
3992 snprintf implementation, only in those cases where the architecture is
3993 not known to provide one (see includes/cf/[arch].h). If you experience
3994 linking problems with snprintf/vsnprintf or 'isc_print_' functions, this
3995 is where to look. This vulnerability did not exist in any previously
3996 published version of ISC DHCP.
3998 - Compilation on hpux 11.11 was repaired.
4000 - 'The cross-compile bug fix' was backed out.
4002 Changes since 3.0.1rc12
4004 - Fixed a bug in omapi lease lookup function, to form the hardware
4005 address for the hash lookup correctly, thanks to a patch from
4008 - Fixed a bug where dhcrelay was sending relayed responses back to the
4009 broadcast address, but with the source's unicast mac address. Should
4010 now conform to rfc2131 section 4.1.
4012 - Cross-compile bug fix; use $(AR) instead of ar. Thanks to Morten Brorup.
4014 - Fixed a crash bug in dhclient where dhcpd servers that do not provide
4015 renewal times results in an FPE. As a side effect, dhclient can now
4016 properly handle 0xFFFFFFFF (-1) expiry times supplied by servers. Thanks
4017 to a patch from Burt Silverman.
4019 - The 'ping timeout' debugs from rc12 were removed to -DDEBUG only,
4020 and reformatted to correct a compilation error on Solaris platforms.
4022 - A patch was applied which fixes a case where leases read from the
4023 leases database do not properly over-ride previously read leases.
4025 - dhcpctl.3 manpage was tweaked.
4027 Changes since 3.0.1rc11
4029 - A patch from Steve Campbell was applied with minor modifications to
4030 permit reverse dns PTR record updates with values containing spaces.
4032 - A patch from Florian Lohoff was applied with some modifications to
4033 dhcrelay. It now discards packets whose hop count exceeds 10 by default,
4034 and a command-line option (-c) can be used to set this threshold.
4036 - A failover bug relating to identifying peers by name length instead of
4039 - Declaring failover configs within shared-network statements should no
4040 longer result in error.
4042 - The -nw command line option to dhclient now works.
4044 - Thanks to a patch from Michael Richardson:
4045 - Some problems with long option processing have been fixed.
4046 - Some fixes to minires so that updates of KEY records will work.
4048 - contrib/ms2isc was updated by Shu-Min Chang of the Intel Corporation.
4049 see contrib/ms2isc/readme.txt for revision notes.
4051 - Dhclient no longer uses shell commands to kill another instance of
4052 itself, it sends the signal directly. Thanks to a patch from Martin
4055 - The FreeBSD dhclient-script was changed so that a failure to write to
4056 /etc/resolv.conf does not prematurely end the script. This keeps dhclient
4057 from looping infinitely when this is the case. Thanks to a patch from
4060 - A patch from Bill Stephens was applied which resolves a problem with lease
4061 expiry times in failover configurations.
4063 - A memory leak in configuration parsing was closed thanks to a patch from
4066 - The function which discovers interfaces will now skip non-broadcast or
4067 point-to-point interfaces, thanks to a patch from David Brownlee.
4069 - Options not yet known by the dhcpd or dhclient have had their names
4070 changed such that they do not contain # symbols, in case they should ever
4071 appear in a lease file. An option that might have been named "#144" is
4074 - Another patch from Bill Stephens which allows the ping-check timeout to
4075 be configured as 'ping-timeout'. Defaults to 1.
4077 Changes since 3.0.1rc10
4079 - Potential buffer overflows in minires repaired.
4081 - A change to the linux client script to use /bin/bash, since /bin/sh may
4084 - Some missing va_end cleanups thanks to a patch from Thomas Klausner.
4086 - A correction of boolean parsing syntax validation - some illegal syntaxes
4087 that worked before are now detected and produce errs, some legal syntaxes
4088 that errored before will now work properly.
4090 - Some search-and-replace errors that caused some options to change their
4093 - Shu-min Chang of the Intel corporation has contributed a perl script and
4094 module that converts the MS NT4 DHCP configuration to a ISC DHCP3
4097 - Applied the remainder of the dhcpctl memory leak patch provided by Bill
4098 Squier at ReefEdge, Inc. (groo@reefedge.com).
4100 - Missing non-optional failover peer configurations will now result in a soft
4101 error rather than a null dereference.
4103 Changes since 3.0.1rc9
4105 - A format string was corrected to fix compiler warnings.
4107 - A number of spelling corrections were made in the man pages.
4109 - The dhclient.conf.5 man page was changed to refer to do-forward-updates
4110 rather than a configuration option that doesn't exist.
4112 - A FreeBSD-specific bug in the interface removal handling was fixed.
4114 - A Linux-specific Token Ring detection problem was fixed.
4116 - Hashes removed from as-yet-unknown agent options, having those options
4117 appear in reality before we know about them will no longer produce
4118 self-corrupting lease databases.
4120 - dhclient will use the proper port numbers now when using the -g option.
4122 - A order-of-operations bug with 2 match clauses in 1 class statement is
4123 fixed thanks to a patch from Andrew Matheson.
4125 - Compilation problems on Solaris were fixed.
4127 - Compilation problems when built with DEBUG or DEBUG_PACKET were repaired.
4129 - A fix to the dhcp ack process which makes certain group options will be
4130 included in the first DHCPOFFER message was made thanks to a patch from
4133 - A few memory leaks were repaired thanks to patches from Bill Squier at
4134 ReefEdge, Inc. (groo@reefedge.com).
4136 - A fix for shared-networks that sometimes give clients options for the
4137 wrong subnets (in particular, 'option routers') was applied, thanks to
4138 Ted Lemon for the patch.
4140 - Omshell's handling of dotted octets as values was changed such that dots
4141 one after the other produce zero values in the integer string.
4143 Changes since 3.0.1rc8
4145 - Fix a format string vulnerability in the server that could lead to a
4146 remote root compromise (discovered by NGSEC Research Team, www.ngsec.com).
4148 - Add additional support for NetBSD/sparc64.
4150 - Fix a bug in the command-line parsing of the client. Also, resolve
4153 - Add better support for shells other than bash in the Linux client
4156 - Various build fixes for modern versions of FreeBSD and Linux.
4158 - Fix a bad bounds check when printing binding state names.
4160 - Clarify documentation about fixed-address and multiple addresses.
4162 - Fix a typo in the authoritative error message.
4164 - Make a log entry when we can't write a billing class.
4166 - Use conversion targets that are the right size on all architectures.
4168 - Increment the hop count when relaying.
4170 - Log a message when lease state is changed through OMAPI.
4172 - Don't rerun the shared_network when evaluating the pool.
4174 - Fix a reversed test in the parser.
4176 - Change the type of rbuf_max.
4178 - Make FTS_LAST a manifest constant to quiet warnings.
4180 Changes since 3.0.1rc7
4182 - Fix two compiler warnings that are generated when compiling on Solaris
4183 with gcc. These stop the build, even though they weren't actually
4184 errors, because we prefer that our builds generate no warnings.
4186 Changes since 3.0.1rc6
4188 - Don't allow a lease that's in the EXPIRED, RELEASED or RESET state
4191 - Implement lease stealing for cases where the primary has fewer leases
4192 than the secondary, as called for by the standard.
4194 - Add a fudge factor to the lease expiry acceptance code, (suggested
4195 by Kevin Miller of CMU).
4197 - Fix a bug in permit_list_match that made it much too willing to say
4198 that two permit lists matched.
4200 - Unless DEBUG_DNS_UPDATES is defined, print more user-friendly (and
4201 also more compact) messages about DNS updates.
4203 - Fix a bug in generating wire-format domain names for the FQDN option.
4205 - Fix a bug where the FQDN option would not be returned if the client
4206 requested it, contrary to the standard.
4208 - On Darwin, use the FreeBSD DHCP client script.
4210 - On NetBSD/sparc, don't check for casting warnings.
4212 - Add a flag in the DHCP client to disable updating the client's A
4213 record when sending an FQDN option indicating that the client is
4214 going to update its A record.
4216 - In the client, don't attempt a DNS update until one second after
4217 configuring the new IP address, and if the update times out, keep
4218 trying until a response, positive or negative, is received from the
4221 - Fix an uninitialized memory bug in the DHCP client.
4223 - Apply some FreeBSD-specific bug fixes suggested by Murray Stokely.
4225 - Fix a bug in ns_parserr(), where it was returning the wrong sort
4226 of result code in some cases (suggested by Ben Harris of the
4229 - Fix a bug in is_identifier(), where it was checking against EOF
4230 instead of the END_OF_FILE token (also suggested by Ben Harris).
4232 - Fix a bug where if an option universe contained no options, the
4233 DHCP server could dump core (Walter Steiner).
4235 - Fix a bug in the handling of encapsulated options.
4237 - Fix a bug that prevented NWIP suboptions from being processed.
4239 - Delete the FTS_BOOTP and FTS_RESERVED states and implement them
4240 as modifier flags to the FTS_ACTIVE state, as called for in the
4241 failover protocol standard.
4243 - Fix bugs in the pool merging code that resulted in references and
4244 dereferences of null pointers. This bug had no impact unless the
4245 POINTER_DEBUG flag was defined.
4247 - In the server, added a do-forward-updates flag that can be used to
4248 disable forward updates in all cases, so that sites that want the
4249 clients to take sole responsibility for updating their A record can
4252 - Make it possible to disable optimization of PTR record updates.
4254 Changes since 3.0.1rc5
4256 - Include some new documentation and changes provided by Karl Auer.
4258 - Add a workaround for some Lexmark printers that send a double-NUL-
4259 terminated host-name option, which would break DNS updates.
4261 - Fix an off-by-one error in the MAC-address checking code for
4262 DHCPRELEASE that was added in 3.0.1rc5.
4264 - Fix a bug where client-specific information was not being discarded
4265 from the lease when it expired or was released, resulting in
4266 problems if the lease was reallocated to a different client.
4268 - If more than one allocation pool is specified that has the same set
4269 of constraints as another allocation pool on the same shared
4270 network, merge the two pools.
4272 - Don't print an error in fallback_discard, since this just causes
4273 confusion and does not appear to be helping to encourage anyone to
4276 Changes since 3.0.1rc4
4278 - Fix a bug that would cause the DHCP server to spin if asked to parse
4279 a certain kind of incorrect statement.
4281 - Fix a related bug that would prevent an error from being reported in
4284 - Additional documentation.
4286 - Make sure that the hardware address matches the lease when
4287 processing a DHCPRELEASE message.
4289 Changes since 3.0.1rc3
4291 - A minor bug fix in the arguments to a logging function call.
4292 - Documentation update for dhcpd.conf.
4294 Changes since 3.0.1rc2
4296 - Allow the primary to send a POOLREQ message. This isn't what the current
4297 failover draft says to do, so we may have to back it out if I can't get the
4298 authors to relent, but the scheme for balancing that's specified in the
4299 current draft seems needlessly hairy, so I'm floating a trial balloon.
4300 The rc1 code did not implement the method described in the draft either.
4302 Changes since 3.0.1rc1
4304 - Treat NXDOMAIN and NXRRSET as success when we are trying to delete a
4305 domain or RRSET. This allows the DHCP server to forget about a name
4306 it added to the DNS once it's been removed, even if the DHCP server
4307 wasn't the one that removed it.
4309 - Install defaults for failover maximum outstanding updates and maximum
4310 silent time. This prevents problems that might occur if these values
4311 were not configured.
4313 - Don't do DDNS deletes if ddns-update-style is none.
4315 - Return relay agent information options in DHCPNAK. This prevents DHCPNAK
4316 messages from being dropped when the relay agent information option contains
4317 routing information.
4319 - Fix a problem where coming up in recover wouldn't result in an update
4322 - Add some more chatty messages when we start a recovery update and when it's
4325 - Fix a possible problem where some state might have been left around
4326 after the peer lost contact and regained contact about how many updates
4329 - Don't nix a lease update because of a lease conflict. This test has
4330 never (as far as I know) prevented a mistake, and it appears to cause
4331 problems with failover.
4333 - Add support in rc history code for keeping a selective history, rather
4334 than a history of all references and dereferences. This code is only used
4335 when extensive additional debugging is enabled.
4339 - Make allocators for hash tables. As a side effect, this fixes a memory
4340 smash in the subclass allocation code.
4342 - Fix a small bug in omshell where if you try to close an object when
4343 no object is open, it dumps core.
4345 - Fix an obscure coredump that could occur on shutdown.
4347 - Fix a bug in the recording of host declaration rubouts in the lease file.
4349 - Fix two potential spins in the host deletion code.
4351 - Fix a core dump that would happen if an application tried to update
4352 a host object attribute with a null value.
4354 Changes since 3.0 Release Candidate 12
4356 - Fix a memory leak in the evaluation code.
4358 - Fix an obscure core dump.
4360 - Print a couple of new warnings when parsing the configuration file
4361 when crucial information is left out.
4363 - Log "no free leases" as an error.
4365 - Documentation updates.
4367 Changes since 3.0 Release Candidate 11
4369 - Always return a subnet selection option if one is sent.
4371 - Fix a warning that was being printed because an automatic data
4372 structure wasn't zeroed.
4374 - Fix some failover state transitions that were being handled
4377 - When supersede_lease is called on a lease whose end time has already
4378 expired, but for which a state transition has not yet been done, do
4379 a state transition. This fixes the case where if the secondary
4380 allocated a lease to a client and the lease "expired" while the
4381 secondary was in partner-down, no expiry event would actually
4382 happen, so the lease would remain active until the primary was
4385 Changes since 3.0 Release Candidate 10
4387 - Fix a bug that was preventing released leases from changing state
4388 in failover-enabled pools.
4390 - Fix a core dump in the client identifier finder code (for host
4393 - Finish fixing a bug where bogus data would sometimes get logged to
4394 the dhclient.leases file because it was opened as descriptor 2.
4396 - Fix the Linux dhclient-script according to suggestions made by
4397 several people on the dhcp-client mailing list.
4399 - Log successful DNS updates at LOG_INFO, not LOG_ERROR.
4401 - Print an error message and refuse to run if a failover peer is
4402 defined but not referenced by any pools.
4404 - Correct a confusing error message in failover.
4406 Changes since 3.0 Release Candidate 9
4408 - Fix a bug in lease allocation for Dynamic BOOTP clients.
4410 Changes since 3.0 Release Candidate 8 Patchlevel 2
4412 - Fix a bug that prevented update-static-leases from working.
4414 - Document failover-state OMAPI object.
4416 - Fix a compilation error on SunOS 4.
4418 Changes since 3.0 Release Candidate 8 Patchlevel 1
4420 - Fix a parsing bug that broke dns updates (both interim and ad-hoc).
4421 This was introduced in rc8pl1 as an unintended result of the memory
4422 leakage fixes that were in pl1.
4424 - Fix a long-standing bug where the server would record that an update
4425 had been done for a client with no name, even though no update had
4426 been done, and then when the client's lease expired the deletion of
4427 that nonexistant record would time out because the name was the null
4430 - Clean up the omshell, dhcpctl and omapi man pages a bit.
4432 Changes since 3.0 Release Candidate 8
4434 - Fix a bug that could cause the DHCP server to spin if
4435 one-lease-per-client was enabled.
4437 - Fix a bug that was causing core dumps on BSD/os in the presence of
4440 - In partner-down state, don't restrict lease lengths to MCLT.
4442 - On the failover secondary, record the MCLT received from the primary
4443 so that if we come up without a connection to the primary we don't
4444 wind up giving out zero-length leases.
4446 - Fix some compilation problems on BSD/os.
4448 - Fix a bunch of memory leaks.
4450 - Fix a couple of bugs in the option printer.
4452 - Fix an obscure error reporting bug in the dns update code, and also
4453 make the message clearer when a key algorithm isn't supported.
4455 - Fix a bug in the tracing code that prevented trace runs that used
4456 tcp connections from being played back.
4458 - Add some additional debugging capability for catching memory leaks
4461 - Make the client release the lease correctly on shutdown.
4463 - Add some configurability to the build system.
4465 - Install omshell manual page in man1, not man8.
4467 - Craig Gwydir sent in a patch that fixes a long-standing bug in the
4468 DHCP client that could cause core dumps, but that for some reason
4469 hadn't been noticed until now.
4471 Changes since 3.0 Release Candidate 7
4473 - Fix a bug in failover where we weren't sending updates after a
4474 transition from communications-interrupted to normal.
4476 - Handle expired/released/reset -> free transition according to the
4477 protocol specification (this works - the other way not only wasn't
4478 conformant, but also didn't work).
4480 - Add a control object in both client and server that allows either
4481 daemon to be shut down cleanly.
4483 - When writing a lease, if we run out of disk space, shut down the
4484 output file and insist on writing a new one before proceeding.
4486 - In the server, if the OMAPI listener port is occupied, keep trying
4487 to get it, rather than simply giving up and exiting.
4489 - Support fetching variables from leases and also updating and adding
4490 variables to leases via OMAPI.
4492 - If two failover peers have wildly different clocks, refuse to start
4495 - Fix a bug in the DNS update code that could cause core dumps when
4496 running on alpha processors.
4498 - Fixed a bug in ddns updates for static lease entries, thanks to a
4499 patch from Andrey M Linkevitch.
4501 - Add support for Darwin/MacOS X
4503 - Install omshell (including new documentation).
4505 - Support DNS updates in the client (this is a very obscure feature
4506 that most DHCP client users probably will not be able to use).
4508 - Somewhat cleaner status logging in the client.
4510 - Make OMAPI key naming syntax compatible with the way keys are
4511 actually named (key names are domain names).
4513 - Fix a bug in the lease file writer.
4515 - Install DHCP ISC headers in a different place than BIND 9 ISC
4516 headers, to avoid causing trouble in BIND 9 builds.
4518 - Don't send updates for attributes on an object when the attributes
4519 haven't changed. Support deleting attributes on remote objects.
4521 - Fix a number of bugs in omshell, and add the unset and refresh
4524 - Handle disconnects in OMAPI a little bit more intelligently (so that
4525 the caller gets ECONNRESET instead of EINVAL).
4527 - Fix a bunch of bugs in the handling of clients that have existing
4528 leases when the try to renew their leases while failover is
4531 Changes since 3.0 Release Candidate 6
4533 - Fix a core dump that could happen when processing a DHCPREQUEST from
4534 a client that had a host declaration that contained both a
4535 fixed-address declaration and a dhcp-client-identifier option
4536 declaration, if the client identifier was longer than nine bytes.
4538 - Fix a memory leak that could happen in certain obscure cases when
4539 using omapi to manipulate leases.
4541 - Fix some bugs and omissions in omshell.
4543 Changes since 3.0 Release Candidate 5
4545 - Fix a bug in omapi_object_dereference that prevented objects in
4546 chains from having their reference counts decreased on dereference.
4548 - Fix a bug in omapi_object_dereference that would prevent object
4549 chains from being freed upon removal of the last reference external
4552 - Fix a number of other memory leaks in the OMAPI protocol subsystem.
4554 - Add code in the OMAPI protocol handler to trace memory leakage.
4556 - Clean up the memory allocation/reference history printer.
4558 - Support input of dotted quads and colon-separated hex lists as
4559 attribute values in omshell.
4561 - Fix a typo in the Linux interface discovery code.
4563 - Conditionalize a piece of trace code that wasn't conditional.
4565 Changes since 3.0 Release Candidate 4
4567 - Fix a bug that would prevent leases from being abandoned properly on
4570 - Fix failover peer OMAPI support.
4572 - In failover, correctly handle expiration of leases. Previously,
4573 leases would never be reclaimed because they couldn't make the
4574 transition from EXPIRED to FREE.
4576 - Fix some broken failover state transitions.
4578 - Documentation fixes.
4580 - Take out an unnecessary check in DHCP relay agent information option
4581 stashing code that was preventing REBINDING clients from rebinding.
4583 - Prevent failover peers from allocating leases in DHCPREQUEST
4584 processing if the lease belongs to the other server.
4586 - Record server version in lease file introductory comment.
4588 - Correctly report connection errors in OMAPI and failover.
4590 - Make authentication signature algorithm name comparisons in OMAPI
4593 - Fix compile problem on SunOS 4.x
4595 - If a signature algorithm is not terminated with '.', terminate it so
4596 that comparisons between fully-qualified names will work
4599 - Different SIOCGIFCONF probe code, may "fix" problem on some Linux
4600 systems with the probe not working correctly.
4602 - Don't allow user to type omapi key on command line of omshell.
4604 Changes since 3.0 Release Candidate 3
4606 - Do lease billing on startup in a way that I *think* will finally do
4607 the billing correctly - the previous method could overbill as a
4608 result of duplicate leases.
4610 - Document OMAPI server objects.
4612 Changes since 3.0 Release Candidate 2 Patchlevel 1
4614 - Fix some problems in the DDNS update code. Thanks to Albert
4615 Herranz for figuring out the main problem.
4617 - Fix some reference counting errors on host entries that were causing
4620 - Fix a byte-swap bug in the token ring code, thanks to Jochen
4623 - Fix a bug in lease billing, thanks to Jonas Bulow.
4625 Changes since 3.0 Release Candidate 2
4627 - Change the conditions under which a DHCPRELEASE is actually
4628 committed to be consistent with lease binding states rather than
4629 using the lease end time. This may fix some problems with the
4632 - Fix a bug where lease updates would fail on Digital Unix (and maybe
4633 others) because malloc was called with a size of zero.
4635 - Fix a core dump that happens when the DHCP server can't create its
4638 Changes since 3.0 Release Candidate 1 Patchlevel 1
4640 - Fix the dhcp_failover_put_message to not attempt to allocate a
4641 zero-length buffer. Some versions of malloc() fail if you try to
4642 allocate a zero-length buffer, and this was causing problems on,
4645 - Fix a case where the failover code was printing an error message
4646 when no error had occurred.
4648 - Fix a problem where when a server went down and back up again, the
4649 peer would not see a state transition and so would stay in the
4650 non-communicating state.
4652 - Be smart about going into recover_wait.
4654 - Fix a problem in the failover implementation where peers would fail
4655 to come into sync if interrupted in the RECOVER state. This could
4656 have been the cause of some problems people have reported recently.
4658 - Fix a problem with billing classes where they would not be unbilled
4659 when the client lease expired.
4661 - If select fails, figure out which descriptor is bad, and cut it out
4662 of the I/O loop. This prevents a potentially nasty spin. I
4663 haven't heard any report it in a while, but it came up consistently
4666 - Fix a bug in the relay agent where if you specified interfaces on
4667 the command line, it would fail.
4669 - Fix a couple of small bugs in the omapi connection object (no known
4672 - Add the missing 3.0 Beta 1 lease conversion script.
4674 - Read dhcp client script hooks if they exist, rather than only if
4677 Changes since 3.0 Release Candidate 1
4679 - Fix a memory smash that happens when fixed-address leases are used.
4680 ANY SITE AT WHICH FIXED-ADDRESS STATEMENTS ARE BEING USED SHOULD
4681 UPGRADE IMMEDIATELY. This has been a long-standing bug - thanks to
4682 Alvise Nobile for discovering it and helping me to find it!
4684 - Fix a small bug in binary-to-ascii, thanks to H. Peter Anvin of
4687 - There is a known problem with the DHCP server doing failover on
4688 Compaq Alpha systems. This patchlevel is not a release candidate
4689 because of this bug. The bug should be straightforward to fix, so
4690 a new release candidate is expected shortly.
4692 - There is a known problem in the DDNS update code that is probably a
4693 bug, and is not, as far as we know, fixed in this patchlevel.
4695 Changes since 3.0 Beta 2 Patchlevel 24
4697 - Went over problematic failover state transitions and made them all
4698 work, so that failover should now much less fragile.
4700 - Add some dhcpctl and omapi documentation
4702 - Fix compile errors when compiling with unusual predefines.
4704 - Make Token Ring work on Linux 2.4
4706 - Fix the Digital Unix BPF_WORDALIGN bug.
4708 - Fix some dhcp client documentation errors.
4710 - Update some parts of the README file.
4712 - Support GCC on SCO.
4714 Changes since 3.0 Beta 2 Patchlevel 23
4716 - Fix a bug in the DNS update code where a status code was not being
4717 checked. This may have been causing core dumps.
4719 - When parsing the lease file, if a lease declaration includes a
4720 billing class statement, and the lease already has a billing class,
4721 unbill the old class.
4723 - When processing failover transactions, where acks will be deferred,
4724 process the state transition immediately.
4726 - Don't try to use the new SIOCGIFCONF buffer size detection code on
4727 Linux 2.0, which doesn't provide this functionality.
4729 - Apply a patch suggested by Tuan Uong for a problem in dlpi.c.
4731 - Fix a problem in using the which command in the configure script.
4733 - Fix a parse error in the client when setting up an omapi listener.
4735 - Document the -n and -g flags to the client.
4737 - Make sure there is always a stdin and stdout on startup. This
4738 prevents shell scripts from accidentally writing error messages into
4739 configuration files that happen to be opened as stderr.
4741 - If an interface is removed, the client will now notice that it is
4742 gone rather than spinning. This has only been tested on NetBSD.
4744 - The client will attempt to get an address even if it can't create a
4747 - Don't overwrite tracefiles.
4749 - Fix some memory allocation bugs in failover.
4751 Changes since 3.0 Beta 2 Patchlevel 22
4753 - Apply some patches suggested by Cyrille Lefevre, who is maintaining
4754 the FreeBSD ISC DHCP Distribution port.
4756 - Fix a core dump in DHCPRELEASE.
4758 Changes since 3.0 Beta 2 Patchlevel 21
4760 - This time for sure: fix the spin described in the changes for pl20.
4762 Changes since 3.0 Beta 2 Patchlevel 20
4764 - Fix a problem with Linux detecting large numbers of interfaces (Ben)
4766 - Fix a memory smash in the quotify code, which was introduced in
4769 - Actually fix the spin described in the changes for pl20. The
4770 previous fix only partially fixed the problem - enough to get it
4771 past the regression test.
4773 Changes since 3.0 Beta 2 Patchlevel 19
4775 - Fix a bug that could cause the server to abort if compiled with
4776 POINTER_DEBUG enabled.
4778 - Fix a bug that could cause the server to spin when responding to a
4781 - Apply Joost Mulders' suggested patches for DLPI on x86.
4783 - Support NUL characters in quoted strings.
4785 - Install unformatted man pages on SunOS.
4787 Changes since 3.0 Beta 2 Patchlevel 18
4789 - Allow the server to be placed in partner-down state using OMAPI.
4792 - Implement omshell, which can be used to do arbitrary things to the
4793 server (in theory). (Damien Neil)
4795 - Fix a case where if a client had two different leases the server could
4796 actually dereference the second one when it hadn't been referenced,
4797 leading to memory corruption and a core dump. (James Brister)
4799 - Fix a case where a client could request the address of another client's
4800 lease, but find_lease wouldn't detect that the other client had it, and
4801 would attempt to allocate it to the client, resulting in a lease conflict
4804 - Fix a case where a client with more than one client identifier could be
4805 given a lease where the hardware address was correct but the client
4806 identifier was not, resulting in a lease conflict message.
4808 - Fix a problem where the server could write out a colon-separated
4809 hex list as a value for a variable, which would then not parse.
4810 The fix is to always write strings as quoted strings, with any
4811 non-printable characters quoted as octal escape sequences. So
4812 a file written the old way still won't work, but new files written
4815 - Fix documentation for sending non-standard options.
4817 - Use unparsable names for unknown options. WARNING: this will
4818 break any configuration files that use the option-nnn convention.
4819 If you want to continue to use this convention for some options,
4820 please be sure to write a definition, like this:
4822 option option-nnn code nnn = string;
4824 You can use a descriptive name instead of option-nnn if you like.
4826 - Fix a problem where we would see a DHCPDISCOVER/DHCPOFFER/
4827 DHCPREQUEST/DHCPACK/DHCPREQUEST/DHCPNAK sequence. This was the
4828 result of a deceptively silly bug in supersede_lease.
4830 - Fix client script exit status check, according to a fix supplied by
4833 - Fix an endianness bug in the tracefile support, regarding ICMP
4836 - Fix a bug in the client where the medium would not work correctly if
4837 it contained quoted strings.
4839 ** there was no pl17 **
4841 Changes since 3.0 Beta 2 Patchlevel 16
4843 - Add support for transaction tracing. This allows the state of the
4844 DHCP server on startup, and all the subsequent transactions, to be
4845 recorded in a file which can then be played back to reproduce the
4846 behaviour of the DHCP server. This can be used to quickly
4847 reproduce bugs that cause core dumps or corruption, and also for
4848 tracking down memory leaks.
4850 - Incorporate some bug fixes provided by Joost Mulders for the DLPI
4851 package which should clear up problems people have been seeing on
4854 - Fix bugs in the handling of options stored as linked lists (agent
4855 options, fqdn options and nwip options) that could cause memory
4856 corruption and core dumps.
4858 - Fix a bug in DHCPREQUEST handling that resulted in DHCPNAK messages
4859 not being send in some cases when they were needed.
4861 - Make the lease structure somewhat more compact.
4863 - Make initial failover startup *much* faster. This was researched
4864 and implemented by Damien Neil.
4866 - Add a --version flag to all executables, which prints the program
4867 name and version to standard output.
4869 - Don't rewrite the lease file every thousand leases.
4871 - A bug in nit.c for older SunOS machines was fixed by a patch sent in
4872 by Takeshi Hagiwara.
4874 - Fix a memory corruption bug in the DHCP client.
4876 - Lots of documentation updates.
4878 - Add a feature allowing environment variables to be passed to the
4879 DHCP client script on the DHCP client command line.
4881 - Fix client medium support, which had been broken for some time.
4883 - Fix a bug in the DHCP client initial startup backoff interval, which
4884 would cause two DHCPDISCOVERS to be sent back-to-back on startup.
4886 Changes since 3.0 Beta 2 Patchlevel 15
4888 - Some documentation tweaks.
4890 - Maybe fix a problem in the DLPI code.
4892 - Fix some error code space inconsistencies in ddns update code.
4894 - Support relay agents that intercept unicast DHCP messages to stuff
4895 agent options into them.
4897 - Fix a small memory leak in the relay agent option support code.
4899 - Fix a core dump that would occur if a packet was sent with no
4902 Changes since 3.0 Beta 2 Patchlevel 14
4904 - Finish fixing a long-standing bug in the agent options code. This
4905 was causing core dumps and failing to operate correctly - in
4906 particular, agent option stashing wasn't working. Agent option
4907 stashing should now be working, meaning that agent options can be
4908 used in class statements to control address allocation.
4910 - Fix up documentation.
4912 - Fix a couple of small memory leaks that would have added up
4913 significantly in a high-demand situation.
4915 - Add a log-facility configuration parameter.
4917 - Fix a compile error on some older operating systems.
4919 - Add the ability in the client to execute certain statements before
4920 transmitting packets to the server. Handy for debugging; not much
4921 practical use otherwise.
4923 - Don't send faked-out giaddr when renewing or bound - again, useful
4926 Changes since 3.0 Beta 2 Patchlevel 13
4928 - Fixed a problem where the fqdn decoder would sometimes try to store
4929 an option with an (unsigned) negative length, resulting in a core
4930 dump on some systems.
4932 - Work around the Win98 DHCP client, which NUL-terminates the FQDN
4935 - Work around Win98 and Win2k clients that will claim they want to do
4936 the update even when they don't have any way to do it.
4938 - Fix some log messages that can be printed when failover is operating
4939 that were not printing enough information.
4941 - It was possible for a DHCPDISCOVER to get an allocation even when
4942 the state machine said the server shouldn't be responding.
4944 - Don't load balance DHCPREQUESTs from clients in RENEWING and
4945 REBINDING, since in RENEWING, if we heard it, it's for us, and in
4946 REBINDING, the client wouldn't have got to REBINDING if its primary
4949 - When we get a bogus state lease binding state transition, don't do
4953 Changes since 3.0 Beta 2 Patchlevel 12
4955 - Fixed a couple of silly compile errors.
4957 Changes since 3.0 Beta 2 Patchlevel 11
4959 - Albert Herranz tracked down and fixed a subtle bug in the base64
4960 decoder that would prevent any key with an 'x' in its base64
4961 representation from working correctly.
4963 - Thanks to Chris Cheney and Michael Sanders, we have a fix for the
4964 hang that they both spotted in the DHCP server - when
4965 one-lease-per-client was set, the code to release the "other" lease
4968 - Fix a problem with alignment of the input buffer in bpf in cases
4969 where two packets arrive in the same bpf read.
4971 - Fix a problem where the relay agent would crash if you specified an
4972 interface name on the command line.
4974 - Add the ability to conditionalize client behaviour based on the
4977 - Add support for the FQDN option, and added support for a new way of
4978 doing ddns updates (ddns update style interim) that allows more than
4979 one DHCP server to update the DNS for the same network(s). This
4980 was implemented by Damien Neil with some additional functionality
4983 - Damien added a "log" statement, so that the configuration file can
4984 be made to log debugging information and other information.
4986 - Fixed a bug that caused option buffers not to be terminated with an
4989 - Fixed a long-standing bug in the support for option spaces where the
4990 options are stored as an ordered list rather than in a hash table,
4991 which could theoretically result in memory pool corruption.
4993 - Prevent hardware declarations with no actual hardware address from
4994 being written as something unparsable, and behave correctly in the
4995 face of a null hardware address on input.
4997 - Allow key names to be FQDNs, and qualify the algorithm name if it is
4998 specified unqualified.
5000 - Modify the DDNS update code so that it never prints the "resolver
5001 failed" message, but instead says *why* the resolver failed.
5003 - Officially support the subnet selection option, which now has an
5006 - Fix a build bug on MacOS X.
5008 - Allow administrator to disable ping checking.
5010 - Clean up dhcpd.conf documentation and add more information about how
5013 Changes since 3.0 Beta 2 Patchlevel 10
5015 - Fix a bug introduced during debugging (!) and accidentally committed
5018 Changes since 3.0 Beta 2 Patchlevel 9
5020 - Fix DHCP client handling of vendor encapsulated options.
5022 - Fix a bug in the handling of relay agent information options introduced
5025 - Stash agent options on client leases by default, and use the stashed
5026 options at renewal time.
5028 - Add the ability to test the client's binding state in the client
5029 configuration language.
5031 - Fix a core dump in the DNS update code.
5033 - Fix some expression evaluation bugs that were causing updates to be
5034 done when no client hostname was received.
5036 - Fix expression evaluation debugging printfs.
5038 - Teach pretty_print_option to print options in option spaces other than
5039 the DHCP option space.
5041 - Add a warning message if the RHS of a not is not boolean.
5043 - Never select for more than a day, because some implementations of
5044 select will just fail if the timeout is too long (!).
5046 - Fix a case where a DHCPDISCOVER from an unknown network would be
5049 - Fix a bug where if a client requested an IP address for which a different
5050 client had the lease, the DHCP server would reallocate it anyway.
5052 - Fix the DNS update code so that if the client changes its name, the DNS
5053 will be correctly updated.
5055 Changes since 3.0 Beta 2 Patchlevel 8
5057 - Oops, there was another subtle math error in the header-length
5060 Changes since 3.0 Beta 2 Patchlevel 7
5062 - Oops, forgot to byte-swap udp header length before bounds-checking it.
5064 Changes since 3.0 Beta 2 Patchlevel 6
5066 - Fix a possible DoS attack where a client could cause the checksummer
5067 to dump core. This was a read, not a write, so it shouldn't be
5068 possible to exploit it any further than that.
5070 - Implement client- and server-side support for using the Client FQDN
5073 - Support for other option spaces in the client has been added. This
5074 means that it is now possible to define a vendor option space on the
5075 client, request options in that space from the server (which must
5076 define the same option space), and then use those options in the
5077 client. This also allows NWIP and Client FQDN options to be used
5080 - Add object initializer support. This means that objects can now be
5081 initialized to something other than all-zeros when allocated, which
5082 makes, e.g., the interface object support code a little more robust.
5084 - Fix an off-by-one bug in the host stuffer. This was causing host
5085 deletes not the work, and may also have been causing OMAPI
5086 connections to get dropped. Thanks to James Brister for tracking
5089 - Fixed a core dump in the interface discovery code that is triggered
5090 when there is no subnet declaration for an interface, but the server
5091 decides to continue running. Thanks to Shane Kerr for tracking
5092 down and fixing this problem.
5094 Changes since 3.0 Beta 2 Patchlevel 5
5096 - Fix a bug in the recent enhancement to the interface discovery code
5097 to support arbitrary-length interface lists.
5099 - Support NUL-terminated DHCP options when initializing client-script
5102 - Fix suffix operator.
5104 - Fix NetWare/IP option parsing.
5106 - Better error/status checking in dhcpctl initialization and omapi
5109 - Fix a potential memory smash in dhcpctl code.
5111 - Fix SunOS4 and (maybe) Ultrix builds.
5113 - Fix a bug where a certain sort of incoming packet could cause a core
5114 dump on Solaris (and probably elsewhere).
5116 - Add some more safety checks in error logging code.
5118 - Add support for ISC_R_INCOMPLETE in OMAPI protocol connection code.
5120 - Fix relay agent so that if an interface is specified on the command
5121 line, the relay agent does not dump core.
5123 - Fix class matching so that match if can be combined with match or
5126 - Do not allow spurious leases in the lease database to introduce
5127 potentially bogus leases into the in-memory database.
5129 - Fix a byte-order problem in the client hardware address type code
5132 - Be slightly less picky about what sort of hardware addresses OMAPI
5133 can install in host declarations.
5135 Changes since 3.0 Beta 2 Patchlevel 4
5137 - Incorporated Peter Marschall's proposed change to array/record
5138 parsing, which allows things like the slp-agent option to be encoded
5139 correctly. Thanks very much to Peter for taking the initiative to
5140 do this, and for doing such a careful job of it (e.g., updating the
5143 - Added an encoding for the slp-agent option. :')
5145 - Fixed SunOS 4 build. Thanks to Robert Elz for responding to my
5146 request for help on this with patches!
5148 - Incorporated a change that should fix a problem reported by Philippe
5149 Jumelle where when the network connection between two servers is
5150 lost, they never reconnect.
5152 - Fix client script files other than that for NetBSD to actually use
5153 make_resolv_conf as documented in the manual page.
5155 - Fix a bug in the packet handling code that could result in a core
5158 - Fix a bug in the bootp code where responses on the local net would
5159 be sent to the wrong MAC address. Thanks to Jerry Schave for
5162 Changes since 3.0 Beta 2 Patchlevel 3
5164 - In the DHCP client, execute client statements prior to using the values
5165 of options, so that the client configuration can overridden, e.g., the
5168 - Fix a reference counting error that would result in very reproducible
5169 failures in updates, as well as occasional core dumps, if a zone was
5170 declared without a key.
5172 - Fix some Linux 2.0 compilation problems.
5174 - Fix a bug in scope evaluation during execution of "on" statements that
5175 caused values not to be recorded on leases.
5177 - If the dhcp-max-message-size option is specified in scope, and the
5178 client didn't send this option, use the one specified in scope to
5179 determine the maximum size of the response.
5181 Changes since 3.0 Beta 2 Patchlevel 2
5183 - Fix a case where spawning subclasses were being allocated
5184 incorrectly, resulting in a core dump.
5186 - Fix a case where the DHCP server might inappropriately NAK a
5189 - Fix a place dhcprequest() where static leases could leak.
5191 - Include memory.h in omapip_p.h so that we don't get warnings about
5194 Changes since 3.0 Beta 2 Patchlevel 1
5196 - Notice when SIOCFIGCONF returns more data than fit in the buffer -
5197 allocate a larger buffer, and retry. Thanks to Greg Fausak for
5200 - In the server, if no interfaces were configured, report an error and
5203 - Don't ever record a state of 'startup'.
5205 - Don't try to evaluate the local failover binding address if none was
5206 specified. Thanks to Joseph Breu for finding this.