1 Internet Systems Consortium DHCP Distribution
2 Version V4.0.0-2007041300
5 **********************************************************************
6 *** This is NOT a public release, and should not be redistributed. ***
7 **********************************************************************
13 The DHCP server in version 4.0.x of the ISC DHCP Distribution supports
14 DHCPv6 in addition to DHCP for IPv4.
16 Several new options have been added to the dhcpd executable, which are
17 documented in the man page. Several changes have been made to the
18 configuration file as well, which are also documented in the man
21 There are a number of DHCPv6 limitiations and features missing in this
22 release, which will be addressed shortly:
24 - Only Solaris, Linux, FreeBSD, NetBSD, and OpenBSD are supported.
26 - There is no DHCPv6 Relay support.
28 - Only a single fixed address is supported per IA.
30 - IA_TA addresses are not supported.
32 - IA_PD prefixes are not supported.
34 - DHCPv6 includes human-readable text in status code messages. These
35 should be configurable, and probably localized via gettext() or the
38 - The "host-identifier" option is limited to a simple token.
40 - Dynamically allocated leases do not respond to Confirm messages.
42 - The client and server can only operate DHCPv4 or DHCPv6 at a time,
43 not both, so two instances of the daemons are required with the
44 "-6" command line option.
46 For information on how to install, configure and run this software,
47 as well as how to find documentation and report bugs, please consult
51 Changes since 4.0.0-20070413
53 - Old (expired) leases are now cleaned.
55 - IPv6 subnets now have support for arbitrary allocation ranges via
56 a new 'range6' configuration directive.
58 - An obviated option code hash lookup to find D6O_CLIENTID was removed.
60 - Corrected some situations where variables might be used without being
63 - Silenced several other compiler warnings.
65 - Include the more standard sys/uio.h rather than rely upon other
66 header files to include it (fixes a BSDI compile failure).
68 Changes since 3.1.0 (NEW FEATURES)
70 - DHCPv6 Client and Server protocol support. Use '-6' to run the daemons
71 as v6-only. Use '-4' to run the daemons as v4-only (default. There is
72 no support currently for both.
74 - Server support for multiple IA_NA options, containing at most one
77 - Client support for one IA_NA option, containing any number of IAADDR
80 - Server support for the DHCPv6 Information-request message.
82 - Inappropriate unicast DHCPv6 messages sent to the server are now
83 discarded, and this has rearchitected the IO system slightly.
85 - The DHCPv6 server DUID defaults to type 1, is persistently stored in
86 the leases database, and can be over-ridden (either completely, or by
87 specifying type 1 or type 2).
89 - The server only uses Rapid-Commit if it has been configured with the
90 Rapid-Commit option and the client requests it.
92 - DDNS support. We now update AAAA records in the same place we would
93 update A records, if we have an IPv6 address. We also generate IP6.ARPA
94 style names for PTR records if we're dealing with an IPv6 address. Both
95 A and AAAA updates are done using the same 'fqdn.' virtual option space
96 (although the DHCPv4 FQDN and DHCPv6 FQDN options are formatted
97 differently, they both use the same code here).
99 - The Linux dhclient-script attempts to set and remove assigned addresses,
100 and to configure /etc/resolv.conf from nameserver and domain name
101 configurations. It can be extended to configure other parameters.
103 - Initial DHCPv6 lease support.
105 - The IO system now tracks all local IP addresses, so that the DHCP
106 applications (particularly the dhcrelay) can discern between what frames
107 were transmitted to it, and what frames are being carried through it which
108 it should not intercept.
110 Chagnes since 3.1.0b1
112 - Fixed a bug that caused OMAPI clients to freeze when opening lease
115 - A new server config option "fqdn-reply" specifies whether the server
116 should send out option 81 (FQDN). Defaults to "on". If set to "off",
117 the FQDN option is not sent, even if the client requested it. This is
118 needed because some clients misbehave otherwise. Thanks to Christof Chen
121 - Allow trace output files (-tf option) to be overwritten, rather than
122 crashing dhcpd if the file already exists
124 - A bug was fixed that caused dhcpd to segfault if a pool was declared
125 outside the scope of a subnet in dhcpd.conf.
127 - Some uninitialized values were repaired in dhcpleasequery.c that
128 caused the server to abort.
130 - A new server config option, 'do-reverse-updates', has been added
131 which causes the server to abstain from performing updates on PTR
132 records. Thanks to a patch from Christof Chen at Allianz.
134 - A bug was repaired in subencapsulation support, where spaces separated
135 by empty spaces would not get included.
137 Changes since 3.1.0a3
139 - Some spelling fixes.
141 Changes since 3.1.0a2
143 - A bug was fixed where attempting to permit leasequeries results in a
144 fatal internal error, "Unable to find server option 49".
146 - A bug was fixed in dhclient rendering the textual output form of the
147 domain-search option syntax.
149 Changes since 3.1.0a1
151 - A bug in the FQDN universe that added FQDN codes to the NWIP universe's
152 hash table was repaired.
154 - The servers now try harder to transmit pending binding updates when
155 entering normal state.
157 - UPDREQ/UPDREQALL handling was optimized - it no longer dequeues and
158 requeues all pending updates. This should reduce the number of spurious
159 'xid mismatch' log messages.
161 - An option definition referencing leak was fixed, which resulted in early
162 termination of dhclient upon the renewal event.
164 - Some default hash table sizes were tweaked, some upwards, some downwards.
165 3.1.0a1's tables resulted in a reduction in default server memory use.
166 The new selected values provide more of a zero sum (increasing the size
167 of tables likely to be populated, decreasing the size of tables unlikely).
169 - Lease structures appear in three spearate hashes: by IP address, by UID,
170 and by hardware address. One type of table was used for all three, and
171 improvements to IP address hashing were applied to all three (so UID and
172 hardware addresses were treated like 4-byte integers). There are now two
173 types of tables, and the uid/hw hashes use functions more appropriate
176 - The max-lease-misbalance percentage no longer causes scheduled rebalance
177 runs to be skipped: it still governs the schedule, but every scheduled
178 run will attempt balance.
180 - A segfault bug in recursive encapsulation support has been corrected.
182 Changes since 3.0 (New Features)
184 - A workaround for certain STSN servers that send a mangled domain-name
185 option was introduced for dhclient. The client will now accept corrupted
186 server responses, if they contain a valid DHCP_MESSAGE_TYPE (OFFER, ACK,
187 or NAK). The server will continue to not accept corrupt client packets.
189 - Support for 'reserved' (pseudo-static) and BOOTP leases via failover
192 - Support for adding, removing, and managing class and subclass statements
195 - The failover implementation was updated to comply with revision 12 of
198 - 'make install' now creates the initial zero-length dhcpd.leases file if
199 one does not already exist on the system.
201 - RFC3942 compliance, site-local option spaces start at 224 now, not 128.
203 - The Load Balance Algorithm was misimplemented. The current implementation
206 - lcase() and ucase() configuration expressions have been added which adjust
207 their arguments from upper to lower and lower to upper cases respectively.
208 Thanks to a patch from Albert Herranz.
210 - The dhclient 'reject ...;' statement, which rejects leases given by named
211 server-identifiers, now permits address ranges to be specified in CIDR
212 notation. Thanks to a patch from David Boyce.
214 - The subnet-mask option is now supplied by default, but at lowest
215 priority. This helps a small minority of clients that provide parameter
216 request lists, but do not list the subnet-mask option because they were
217 designed to interoperate with a server that behaves in this manner.
219 - The FQDN option is similarly supplied even if it does not appear on the
220 parameter request list, but not to the exclusion of options that do
221 appear at the parameter request list. Up until now it had ultimate
222 priority over the client's parameter request list.
224 - Varying option space code and length bit widths (8/16/32) are now
225 supported. This is a milestone in achieving RFC 3925 "VIVSO" and
228 - A new common (server or client) option, 'db-time-format local;', has
229 been added which prints the local time in /var/db/dhcpd.leases rather
230 than UTC. Thanks to a patch from Ken Lalonde.
232 - Some patches to improve DHCP Server startup speed from Andrew Matheson
233 have been incorporated.
235 - Failover pairs now implement 'MAC Affinity' on leases moving from the
236 active to free states. Leases that belonged to the failover secondary
237 are moved to BACKUP state rather than FREE upon exiting EXPIRED state.
238 If lease rebalancing must move leases, it tries first to move leases
239 that belong to the peer in need.
241 - The server no longer sends POOLREQ messages unless the pool is severely
242 misbalanced in the peer's favor (see 'man dhcpd.conf' for more details).
244 - Pool rebalance events no longer happen upon successfully allocating a
245 lease. Instead, they happen on a schedule. See 'man dhcpd.conf' for the
246 min-balance and max-balance statements for more information.
248 - The DHCP Relay Agent Information Option / Link Selection Sub-Option
249 is now supported. (See RFC3527 for details).
251 - A new DDNS related server option, update-conflict-detection, has been
252 added. If this option is enabled, dhcpd will perform normal DHCID
253 conflict resolution (the default). If this option is disabled, it will
254 instead trust the assigned name implicitly (removing any other bindings
255 on that name). This option has not been made available in dhclient.
257 - In those cases where the DHCP software manufactures an IP header (to
258 transmit via bpf, lpf, etc), the IP TTL the software selects has been
259 increased from 16 to 128. This is intended to match Microsoft Windows
260 DHCP Client behaviour, to increase compatibility.
262 - 'ignore client-updates;' now has behaviour that is different from
263 'deny client-updates;'. The client's request is not truly ignored,
264 rather it is encouraged. Should this value be configured, the server
265 updates DNS as though client-updates were set to 'deny'. That is, it
266 enters into DNS whatever it is configured to do already, provided it is
267 configured to. Then it sends a response to the client that lets the
268 client believe it is performing client updates (which it will), probably
269 for a different name. In essence, this lets the client do as it will,
270 ignoring this aspect of their request.
272 - Support for compressed 'domain name list' style DHCP option contents, and
273 in particular the domain search option (#119) was added.
275 - The DHCP LEASEQUERY protocol as defined in RFC4388 is now implemented.
276 LEASEQUERY lets you query the DHCP server for information about a lease,
277 using either an IP address, MAC address, or client identifier. Thanks
278 to a patch from Justin Haddad.
280 - DHCPD is now RFC2131 section 4.1 compliant (broadcast to all-ones ip and
281 ethernet mac address) on the SCO platform specifically without any strange
282 ifconfig hacks. Many thanks go to the Kroger Co. for donating the
283 hardware and funding the development.
285 - A new common configuration executable statement, execute(), has been
286 added. This permits dhcpd or dhclient to execute a named external
287 program with command line arguments specified from other configuration
288 language. Thanks to a patch written by Mattias Ronnblom, gotten to us
291 - A new dhcp server option 'adaptive-lease-time-threshold' has been added
292 which causes the server to substantially reduce lease-times if there are
293 few (configured percentage) remaining leases. Thanks to a patch submitted
296 - Encapsulated option spaces within encapsulated option spaces is now
301 - Assorted fixes for broken network devices: Packet length is now
302 determined from the IP header length field to finally calculate the
303 UDP payload length, because some NIC drivers return more data than
304 they actually received.
306 - UDP packets are now stored in aligned data structures.
308 - A logic error in omapi interface code was repaired that might result in
309 incorrectly indicating 'up' state when any flags were set, rather than
310 specifically the INTERFACE_REQUESTED flag. Thanks to a patch from
311 Jochen Voss which got to us via Andrew Pollock at Debian.
313 - A reference leak on binding scopes set by ddns updates was repaired.
315 - A memory leak in the minires_nsendsigned() function call was repaired.
316 Effectively, this leaked ~176 bytes per DDNS update.
318 - In the case where an "L2" DHCP Relay Agent (one that does not set giaddr)
319 was directly attached to the same broadcast domain as the DHCP server,
320 the RFC3046 relay agent information option was not being returned to the
321 relay in the server's replies. This was fixed; the dhcp server no longer
322 requires the giaddr to reply with relay agent information. Note that
323 this also improves compatibility with L2 devices that "intercept" DHCP
324 packets and expect relay agent information even in unicast (renewal)
325 replies. Thanks to a patch from Pekka Silvonen.
327 - A bug was fixed where the BOOTP header 'sname' field had a value, the
328 copy written to persistent storage was actually the contents of the
331 - A bug was fixed where the nwip virtual option space was referencing
332 the fqdn option's virtual option space's option cache.
334 - Timestamp parsing errors that indicated missing "minutes" fields rather
335 than the actually missing "seconds" fields have been repaired thanks to
336 a patch from Kevin Steves.
338 - A grammar error in the dhclient.8 manpage was repaired thanks to a patch
341 - Several spelling typos were repaired, and some cross-references to other
342 relevant documents were included in the manpages, thanks to a patch
343 by Andrew Pollock which got to us via Tomas Pospisek.
345 - Some bugs were fixed in the 'emergency relay agent options hologram'
346 which is used to retain relay agent option contents from when the
347 client was in INIT or REBIND states. This should solve problems where
348 relay agent options were not echoed from the server, even when giaddr
351 - dhclient now closes its descriptor to dhclient.leases prior to executing
352 dhclient-script. Thanks to a patch from Tomas Pospisek.
354 - The server's "by client-id" and "by hardware address" hash table lists
355 are now sorted according to the preference to re-allocate that lease to
356 returning clients. This should eliminate pool starvation problems
357 arising when "INIT" clients were given new leases rather than presently
360 Changes since 3.0.5rc1
362 - A bug was repaired in fixes to the dhclient, which sought to run the
363 dhclient-script with the 'EXPIRE' state should it receive a NAK in
364 response to a REQUEST. The client now iterates the PREINIT state
365 after the EXPIRE state, so that interfaces that might be configured
366 'down' can be brought back 'up' and initialized.
368 - DHCPINFORM handling for clients that properly set ciaddr and come to the
369 server via a relay aget has been repaired.
373 - A warning that host statements declared within subnet or shared-network
374 scopes are actually global has been added.
376 - The default minimum lease time (if min-lease-time was not specified)
377 was raised from 0 to 300. 0 is not thought to be sensible, and is
378 known to be damaging.
380 - Added additional fatal error sanity checks surrounding lease binding
381 state count calculations (free/active counts used for failover pool
384 - Some time value size fixes in 3.0.4 brought on from FreeBSD /usr/ports were
385 misapplied to server values rather than client values. The server no longer
386 advertises 8-byte lease-time options when on 64-bit platforms.
388 - A bug where leases not in ACTIVE state would get billed to billed classes
389 (classes with lease limitations) was fixed. Non-active leases OFFERed
390 to clients are no longer billed (but billing is checked before offering).
392 - The dhcpd.conf.5 manpage was updated in regard to the ddns-domainname
393 configuration option - the default configuration and results should be
396 - If the dhclient were to receive a DHCPNAK while it was in the RENEW
397 state (and consequently, had an active, 'bound' address and related
398 configuration options), it would fail to 'tear down' this information
399 before proceeding into INIT state. dhclient now iterates the dhclient-
400 script with the 'EXPIRE' action to cause these teardowns prior to entering
401 INIT state. Thanks to a patch from Chris Zimmerman.
403 - The omapi.1 manpage had some formatting errors repaired thanks to a patch
404 from Yoshihiko Sarumaru.
406 - A few lines of code that were failover-specific were moved within
407 #if defined() clauses so that compilation without failover could be
410 - The log message emitted when the 'leased-address' value was not available
411 in dhcpd.conf "executable statements" has been updated to be more helpful.
412 Manpage information for this value has also been updated.
414 - Abandoned or dissociated (err condition) leases now remove any related
415 dynamic dns bindings. Thanks to a patch from Patrick Schoo.
417 - Attempting to write a new lease file to replace a corrupt (due to
418 encountering non-retryable errors during writing) lease file should
419 no longer result in an infinite recursion.
421 - Host declaration hardware addresses and client identifiers may only be
422 configured once. dhcpd will now fail to load config files that specify
423 multiple identifiers (previous versions would silently over-ride the
424 value with the later configured value).
426 - Several option codes that have been allocated since our last release
427 have been named and documented.
429 - Option names of the form "unknown-123" have been removed from the in-
430 memory hash tables. In order to support options of these names that
431 may appear in dhclient.leases or similar in previous versions, the
432 parser will now find the new option code definition, or mock up a
433 generic option code definition. This should result in a smooth
434 transition from one name to the other, as the new name is used to
437 Changes since 3.0.4rc1
439 - The dhcp-options.5 manpage was updated to correct indentation errors
440 thanks to a patch from Jean Delvare.
442 Changes since 3.0.4b3
444 - Some manual pages were clarified pursuant to discussion on the dhcp-server
447 Changes since 3.0.4b2
449 - Null-termination sensing for certain clients that unfortunatley require
450 it in DHCPINFORM processing was repaired.
452 - The host-name option and a few others were moved from "X" format to "t"
453 format to be compatible with new NULL handling functions.
455 - DHCPINFORM processing is a little more careful about return addressing
456 its responses, or if responding via a relay. The INFORM related
457 messages also log the 'effective client ip address' rather than the
458 client's supplied ciaddr (since some clients produce null ciaddrs).
460 - The server was inappropriately sending leases to the RESET state in the
461 event that multiple active leases were found to match a singly-identified
462 client. This was changed to RELEASED (by accepting a different, ACTIVE
463 binding, the client is implicitly releasing its lease). This repairs a
464 bug wherein secondary servers in failover pairs detecting this condition
465 move leases to RESET, and primaries refuse to accept that state
466 transition (properly).
468 - The memset-after-dmalloc() changes made in 3.0.4b1 have been backed out.
470 Changes since 3.0.4b1
472 - Command line parsing in omshell was repaired - it no longer closes
473 STDIN after reading one line.
475 - The resolver library no longer closes the /etc/resolv.conf file
476 descriptor it opened twice.
478 - Changes to trailing NULL removal in 't' option-atoms has been rethought,
479 it now includes 'd' (domain name) types, and tries hard not to rewind an
480 option beyond the start of the text field it is un-terminating.
484 - A DDNS update handling function was misusing the DNS error codes, rather
485 than the internal generic result enumeration. The result is a confusing
486 syslog line, logging the wrong condition.
488 - The DHCP Server was not checking pool balance in the case where it brought
489 a non-ACTIVE lease out of storage for a client that was returning to use
490 a lease it once had long ago, and had since expired.
492 - Failover peers no longer bother to look for free leases to allocate when
493 they already found the client's ACTIVE lease. DISCOVERs are load balanced
494 whether freely-allocated or not, unless the server doubts the peer has
497 - Fixed a bug in dhcrelay agent addition code that suppressed trailing
498 PAD options - it was suppressing only one trailng PAD option, rather
499 than the entire block of them.
501 ! Fixed some unlikely overlapping-region memcpy() bugs in dhcrelay agent
502 option addition and stripping code. Added a few sanity checks. Although
503 highly improbable, due to requiring the reception of a DHCP datagram well
504 in excess of all known to be used physical MTU limitations, it is possible
505 this may have been used in a stack overflow security vulnerability. Thanks
506 to a patch from infamous42md.
508 ! Added some sanity checks to OMAPI connection/authentication code.
509 Although highly improbable, due to having to deliver in excess of 2^32
510 bytes of data via the OMAPI channel, not to mention requiring dhcpd to
511 be able to malloc() a memory region 2^32 bytes in size, it was possible
512 this might have resulted in a heap overflow security vulnerability.
513 Thanks to a patch from infamous42md.
515 - dmalloc() memset()'s the non-debug (data) portion of the allocated
516 memory to zero. Code that memset()'s the result returned by dmalloc() to
517 zero is redundant. These redundancies were removed.
519 - Some type declaration corrections to u_int16_t were made in common/tr.c
520 (Token Ring support) thanks to a patch from Jason Vas Dias at RedHat.
522 - A failover bug that was allowing leases that EXPIRED or were RELEASED
523 where tsfp and tstp are identical timestamps to languish in these
524 transitional states has been repaired. As a side effect, lease
525 databases should be kept more consistent overall, not just for these
528 - If the lease db is deleted out from under the daemon, and it moves to rewrite
529 the db, it will go ahead with the operation and move the new db into place
530 once it detects the old db does not exist.
532 - dhclient now ignores IRDA, SIT, and IEEE1394 network interfaces, as it
533 is either nonsensical or (in the case of IEEE1394) is not known to support
534 these interfaces. Thanks to Marius Gedminas and Andrew Pollock of Debian.
536 - Some previously undocumented reasons for dhclient-script invoking has
537 been doucmented in the dhclient-script.8 manpage.
539 - Failover potential expiry calculations (TSTP) have been corrected. Results
540 should be substantially more consistent, and proper given the constraints.
542 - Adjusted lease state validation checks in potential-conflict, to
543 account for possible clock skew similarly to normal state, and several
544 previously illegal transitions were made legal (ex: active->released).
546 - An impossible sanity check was removed from omapi/buffer.c, thanks to a
547 patch from 'infamous42md'.
549 - An OMAPI host/network byte order problem in lease time values has been
552 - Several minor bugs, largely relating to treating 8-byte time values as
553 4-byte entities, have been repaired after careful review of the FreeBSD
554 ports collection's patch set. Thanks to the nameless entities who have
555 contributed to the FreeBSD ports.
557 - When writing a trace file, the file is now created with permissions 0600,
558 to help administrators avoid accidentally publicising sensitive config
561 - The calculation of the maximum size of DHCP packets no longer includes
562 Ethernet framing overhead. The result is that the 'Maximum Message
563 Size' option advertised by clients, or the default value 576, is no
564 longer reduced by 14 bytes, and instead directly reflects the IP level
565 MTU (and the default, minimum allowed IP MTU of 576).
567 - The special status of RELEASED/EXPIRED/RESET leases when a server
568 is operating in partner-down was fixed. It no longer requires a
569 lease be twice the MCLT beyond STOS to 'reallocate', and the expiry
570 event to turn these into FREE leases without peer acknowledgement
571 (after STOS+MCLT) has been repaired.
573 - Compilation on older Solaris systems (lacking /usr/include/sys/int_types.h)
576 - "append"ing a string onto the end of a "t" type option (such as the
577 domain-name field) that had been improperly NULL-terminated by the
578 DHCP server will no longer result in a truncated string containing
579 only the option from the server, and not the expected appended value.
580 Thanks to a patch from Jason Vas Dias at RedHat.
582 - File handlers on configuration state (config files and lease dbs) should
583 be treated consistently, regardless of whether TRACING is defined or not.
585 - The linux build environment has had some minor improvements - better
586 sensing of 64-bit pointer sizes (only used for establishing an icmp_id),
587 and corrections to #if operators regarding LINUX_MAJOR should it ever
590 - The server now tries harder to survive the condition where it is unable
591 to open a new lease file to rewrite the lease state database.
593 Changes since 3.0.3b3
595 - dhclient.conf documentation for interface {} was updated to reflect recent
596 discussion on the dhcp-hackers mailing list.
598 - In response to reports that the software does not compile on GCC 4.0.0,
599 -Werror was removed from Makefile.conf for all platforms that used it.
600 We will address the true problem in a future release; this is a temporary
603 Changes since 3.0.3b2
605 - An error in code changes introduced in 3.0.3b2 was corrected, which caused
606 static BOOTP clients to receive random addresses.
608 Changes since 3.0.3b1
610 - A bug was fixed in BOOTPREQUEST handling code wherein stale references to
611 host records would be left behind on leases that were not allocated to the
612 client currently booting (eg in the case where the host was denied booting).
614 - The dhcpd.conf.5 manpage was updated to be more clear in regards to
615 multiple host declarations (thanks to Vincent McIntyre). 'Interim' style
616 dynamic updates were also retouched.
620 - A bug was fixed where a server might load balance a DHCP REQUEST to its
621 peer after already choosing not to load balance the preceeding DISCOVER.
622 The peer cannot allocate the originating server's lease.
624 - In the case where a secondary server lost its stable storage while the
625 primary was still in communications-interrupted, and came back online,
626 the lease databases would not be fully transferred to the secondary.
627 This was due to the secondary errantly sending an extra UPDREQ message
628 when the primary made its state transition to PARTNER-DOWN known.
630 - The package will now compile cleanly in gcc 3.3 and 3.4. As a side effect,
631 lease structures will be 9 bytes smaller on all platforms. Thanks to
632 Jason Vas Dias at Redhat.
634 - Interface discovery code in DISCOVER_UNCONFIGURED mode is now
635 properly restricted to only detecting broadcast interfaces. Thanks
636 to a patch from Jason Vas Dias at RedHat.
638 - decode_udp_ip_header was changed so that the IP address was copied out
639 to a variable, rather than referenced by a pointer. This enforces 4-byte
640 alignment of the 32-bit IP address value. Thanks to a patch from Dr.
643 - An incorrect log message was corrected thanks to a patch from
646 - A bug in DDNS was repaired, where if the server's first DDNS action was
647 a DDNS removal rather than a DDNS update, the resolver library's
648 retransmit timer and retry timer was set to the default, implying a
649 15 second timeout interval. Which is a little excessive in a synchronous,
650 single-threaded system. In all cases, ISC DHCP should now hold fast to
651 a 1-second timeout, trying only once.
653 - The siaddr field was being improperly set to the server-identifier when
654 responding to DHCP messages. RFC2131 clarified the siaddr field as
655 meaning the 'next server in the bootstrap process', eg a tftp server.
656 The siaddr field is now left zeroed unless next-server is configured.
658 - mockup_lease() could have returned in an error condition (or in the
659 condition where no fixed-address was found matching the shared
660 network) with stale references to a host record. This is probably not
661 a memory leak since host records generally never die anyway.
663 - A bug was repaired where failover servers would let stale client identifiers
664 persist on leases that were reallocated to new clients not sending an id.
666 - Binding scopes ("set var = value;") are now removed from leases allocated
667 by failover peers if the lease had expired. This should help reduce the
668 number of stale binding scopes on leases.
670 - A small memory leak was closed involving client identifiers larger than
671 7 bytes, and failover.
673 - Configuring a subnet in dhcpd.conf with a subnet mask of 32 bits might
674 cause an internal function to overflow heap. Thanks to Jason Vas Dias
677 - Some inconsistencies in treating numbers that the lexer parsed as 'NUMBER'
678 or 'NUMBER_OR_NAME' was repaired. Hexadecimal parsing is affected, and
681 - In several cases, parse warnings were being issued before the lexical
682 token had been advanced to the token whose value was causing an error...
683 causing parse warnings to claim the problem is on the wrong token.
685 - Host declarations matching on client identifier for dynamic leases will
686 no longer match fixed-address host declarations (this is now identical
687 to behaviour for host records matching on hardware address).
689 Changes since 3.0.2rc3
691 - A previously undocumented configuration directive, 'local-address',
692 was documented in the dhcpd.conf manpage.
694 Changes since 3.0.2rc2
696 - Two varaibles introduced in 3.0.2b1 were used without being initialized
697 in the case where neither the FILE nor SNAME fields were available for
698 overloading. This was repaired.
700 - A heretofore believed to be impossible corner case of the option
701 overloading implementation turned out to be possible ("Unable to sort
702 overloaded options after 10 tries."). The implementation was reworked
703 to consider the case of an option so large it would require more than
706 - Many other instances of variables being used without being initialized
709 - An uninitialized variable in omapi_io_destroy() led to the discovery
710 that this function may result in orphaned pointers (and hence, a memory
713 Changes since 3.0.2rc1
715 - allocate_lease() was rewritten to repair a bug in which the server would
716 try to allocate an ABANDONED lease when FREE leases were available.
718 Changes since 3.0.2b1
720 - Some dhcp-eval.5 manpage formatting was repaired.
724 - A bug was fixed in the server's 'option overloading' implementation,
725 where options loaded into the 'file' and 'sname' packet fields were
726 not aligned precisely as rfc2131 dictates.
728 - The FreeBSD client script was changed to support the case where a domain
729 name was not provided by the server.
731 - A memory leak in 'omshell' per each command line parsed was
732 repaired, thanks to a patch from Jarkko Torppa.
734 - Log functions writing to stderr were adjusted to use the STDERR_FILENO
735 system definition rather than '2'. This is a no-op for 90% of platforms.
737 - One call to trace_write_packet_iov() counted the number of io vectors
738 incorrectly, causing inconsistent tracefiles. This was fixed.
740 - Some expression parse failure memory leaks were closed.
742 - A host byte order problem in tracefiles was repaired.
744 - Pools configured in DHCPD for failover possessing permission lists that
745 previously were assumed to not include dyanmic bootp clients are now
746 a little more pessimistic. The result is, dhcpd will nag you about just
747 about most pools that possess a 'allow' statement with no 'deny' that
748 would definitely match a dynamic bootp client.
750 - The 'ddns-update-style' configuration warning bit now insists that
751 the configuration be globally scoped.
753 - Two memory leaks in dhclient were closed thanks to a patch from Felix
756 - Some minor but excellently pedantic documentation errors were fixed
757 thanks to a patch from Thomas Klausner.
759 - Bugs in operator precedence in executable statements have been repaired
760 once again. More legal syntaxes should be parsed legally.
762 - Failing to initialize a tracefile for any reason if a tracefile was
763 specified is now a fatal error. Thanks to a patch from Albert Herranz.
765 - Corrected a bug in which the number of leases transferred as calculated
766 by the failover primary and sent to peers in POOLRESP responses may be
767 incorrect. This value is not believed to be used by other failover
768 implementations, excepting perhaps as logged information.
770 - Corrected a bug in which 'dhcp_failover_send_poolresp()' was in fact
771 sending POOLREQ messages instead of POOLRESP mesasges. This message
772 was essentially ignored since failover secondaries effectively do not
773 respond to POOLREQ messages.
775 - Type definitions for various bitwidths of integers in the sunos5-5
776 build of ISC DHCP have been fixed. It should compile and run more
777 easily when built in 64-bit for this platform.
779 - "allow known-clients;" is now a legal syntax, to avoid confusion.
781 - If one dhcp server chooses to 'load balance' a request to its failover
782 peer, it first checks to see if it believes said peer has a free
783 lease to allocate before ignoring the DISCOVER.
785 - log() was logging a work buffer, rather than the value returned by
786 executing the statements configured by the user. In some cases,
787 the work buffer and the intended results were the same. In some other
788 cases, they were not. This was fixed thanks to a patch from Gunnar
789 Fjone and directconnect.no.
791 - Compiler warnings for some string type conversions was fixed, thanks
792 to Andreas Gustafsson.
794 - The netbsd build environments were simplified to one, in which
795 -Wconversion is not used, thanks to Andreas Gustafsson.
797 - How randomness in the backoff-cutoff dhclient configuration variable
798 is implemented was better documented in the manpage, and the behaviour
799 of dhclient in REQUEST timeout handling was changed to match that of
800 DISCOVER timeout handling.
802 - Omapi was hardened against clients that pass in null values, thanks
803 to a patch from Mark Jason Dominus.
805 - A bug was fixed in dhclient that kept it from doing client-side
806 ddns updates. Thanks to a patch from Andreas Gustafsson, which
807 underwent some modification after review by Jason Vas Dias.
809 - Failover implementations disconnected due to the network between
810 them (rather than one of the two shutting down) will now try to
811 re-establish the failover connection every 5 seconds, rather than
812 to simply try once and give up until one of them is restarted.
813 Thanks to a patch from Ulf Ekberg from Infoblox, and field testing
814 by Greger V. Teigre which led to an enhancement to it.
816 - A problem that kept DHCP Failover secondaries from tearing down
817 ddns records was repaired. Thanks to a patch from Ulf Ekberg from
820 - 64bit pointer sizes are detected properly on FreeBSD now.
822 - A bug was repaired where the DHCP server would leave stale references
823 to host records on leases it once thought about offering to certain
824 clients. The result would be to apply host and 'known' scopes to the
825 wrong clients (possibly denying booting). NOTE: The 'mis-host' patch
826 that was being circulated as a workaround is not the way this bug was
827 fixed. If you were a victim of this bug in 3.0.1, you are cautioned
828 to proceed carefully and see if it fixes your problem.
830 - A bug was repaired in the server's DHCPINFORM handling, where it
831 tried to divine the client's address from the source packet and
832 would get it wrong. Thanks to Anshuman Singh Rawat.
834 - A log message was introduced to help illuminate the case where the
835 server was unable to find a lease to assign to any BOOTP client.
836 Thanks to Daniel Baker.
838 - A minor dhcpd.conf.5 manpage error was fixed.
840 Changes since 3.0.1rc14
842 - The global variable 'cur_time' was centralized and is now uniformly of a
843 type #defined in system-dependent headers. It had previously been defined
844 in one of many places as a 32-bit value, and this causes mayhem on 64-bit
845 big endian systems. It probably wasn't too healthy on little endian
848 - A printf format string error introduced in rc14 was repaired.
850 - AIX system-dependent header file was altered to only define NO_SNPRINTF
851 if the condition used to #ifdef in vsnprintf in AIX' header files
854 - The Alpha/OSF system-dependent header file was altered to define
855 NO_SNPRINTF on OS revisions older than 4.0G.
857 - omapip/test.c had string.h added to its includes.
859 Changes since 3.0.1rc13
861 ! CAN-2004-0460 - CERT VU#317350: Five stack overflow exploits were closed
862 in logging messages with excessively long hostnames provided by the
863 clients. It is highly probable that these could have been used by
864 attackers to gain arbitrary root access on systems using ISC DHCP 3.0.1
865 release candidates 12 or 13. Special thanks to Gregory Duchemin for
866 both finding and solving the problem.
868 ! CAN-2004-0461 - CERT VU#654390: Once the above was closed, an opening
869 in log_*() functions was evidented, on some specific platforms where
870 vsnprintf() was not believed to be available and calls were wrapped to
871 sprintf() instead. Again, credit goes to Gregory Duchemin for finding
872 the problem. Calls to snprintf() are now linked to a distribution-local
873 snprintf implementation, only in those cases where the architecture is
874 not known to provide one (see includes/cf/[arch].h). If you experience
875 linking problems with snprintf/vsnprintf or 'isc_print_' functions, this
876 is where to look. This vulnerability did not exist in any previously
877 published version of ISC DHCP.
879 - Compilation on hpux 11.11 was repaired.
881 - 'The cross-compile bug fix' was backed out.
883 Changes since 3.0.1rc12
885 - Fixed a bug in omapi lease lookup function, to form the hardware
886 address for the hash lookup correctly, thanks to a patch from
889 - Fixed a bug where dhcrelay was sending relayed responses back to the
890 broadcast address, but with the source's unicast mac address. Should
891 now conform to rfc2131 section 4.1.
893 - Cross-compile bug fix; use $(AR) instead of ar. Thanks to Morten Brorup.
895 - Fixed a crash bug in dhclient where dhcpd servers that do not provide
896 renewal times results in an FPE. As a side effect, dhclient can now
897 properly handle 0xFFFFFFFF (-1) expiry times supplied by servers. Thanks
898 to a patch from Burt Silverman.
900 - The 'ping timeout' debugs from rc12 were removed to -DDEBUG only,
901 and reformatted to correct a compilation error on solaris platforms.
903 - A patch was applied which fixes a case where leases read from the
904 leases database do not properly over-ride previously read leases.
906 - dhcpctl.3 manpage was tweaked.
908 Changes since 3.0.1rc11
910 - A patch from Steve Campbell was applied with minor modifications to
911 permit reverse dns PTR record updates with values containing spaces.
913 - A patch from Florian Lohoff was applied with some modifications to
914 dhcrelay. It now discards packets whose hop count exceeds 10 by default,
915 and a command-line option (-c) can be used to set this threshold.
917 - A failover bug relating to identifying peers by name length instead of
920 - Delcaring failover configs within shared-network statements should no
921 longer result in error.
923 - The -nw command line option to dhclient now works.
925 - Thanks to a patch from Michael Richardson:
926 - Some problems with long option processing have been fixed.
927 - Some fixes to minires so that updates of KEY records will work.
929 - contrib/ms2isc was updated by Shu-Min Chang of the Intel Corporation.
930 see contrib/ms2isc/readme.txt for revision notes.
932 - Dhclient no longer uses shell commands to kill another instance of
933 itself, it sends the signal directly. Thanks to a patch from Martin
936 - The FreeBSD dhclient-script was changed so that a failure to write to
937 /etc/resolv.conf does not prematurely end the script. This keeps dhclient
938 from looping infinitely when this is the case. Thanks to a patch from
941 - A patch from Bill Stephens was applied which resolves a problem with lease
942 expiry times in failover configurations.
944 - A memory leak in configuration parsing was closed thanks to a patch from
947 - The function which discovers interfaces will now skip non-broadcast or
948 point-to-point interfaces, thanks to a patch from David Brownlee.
950 - Options not yet known by the dhcpd or dhclient have had their names
951 changed such that they do not contain # symbols, in case they should ever
952 appear in a lease file. An option that might have been named "#144" is
955 - Another patch from Bill Stephens which allows the ping-check timeout to
956 be configured as 'ping-timeout'. Defaults to 1.
958 Changes since 3.0.1rc10
960 - Potential buffer overflows in minires repaired.
962 - A change to the linux client script to use /bin/bash, since /bin/sh may
965 - Some missing va_end cleanups thanks to a patch from Thomas Klausner.
967 - A correction of boolean parsing syntax validation - some illegal syntaxes
968 that worked before are now detected and produce errs, some legal syntaxes
969 that errored before will now work properly.
971 - Some search-and-replace errors that caused some options to change their
974 - Shu-min Chang of the Intel corporation has contributed a perl script and
975 module that converts the MS NT4 DHCP configuration to a ISC DHCP3
978 - Applied the remainder of the dhcpctl memory leak patch provided by Bill
979 Squier at ReefEdge, Inc. (groo@reefedge.com).
981 - Missing non-optional failover peer configurations will now result in a soft
982 error rather than a null dereference.
984 Changes since 3.0.1rc9
986 - A format string was corrected to fix compiler warnings.
988 - A number of spelling corrections were made in the man pages.
990 - The dhclient.conf.5 man page was changed to refer to do-forward-updates
991 rather than a configuration option that doesn't exist.
993 - A FreeBSD-specific bug in the interface removal handling was fixed.
995 - A Linux-specific Token Ring detection problem was fixed.
997 - Hashes removed from as-yet-unknown agent options, having those options
998 appear in reality before we know about them will no longer produce
999 self-corrupting lease databases.
1001 - dhclient will use the proper port numbers now when using the -g option.
1003 - A order-of-operations bug with 2 match clauses in 1 class statement is
1004 fixed thanks to a patch from Andrew Matheson.
1006 - Compilation problems on Solaris were fixed.
1008 - Compilation problems when built with DEBUG or DEBUG_PACKET were repaired.
1010 - A fix to the dhcp ack process which makes certain group options will be
1011 included in the first DHCPOFFER message was made thanks to a patch from
1014 - A few memory leaks were repaired thanks to patches from Bill Squier at
1015 ReefEdge, Inc. (groo@reefedge.com).
1017 - A fix for shared-networks that sometimes give clients options for the
1018 wrong subnets (in particular, 'option routers') was applied, thanks to
1019 Ted Lemon for the patch.
1021 - Omshell's handling of dotted octets as values was changed such that dots
1022 one after the other produce zero values in the integer string.
1024 Changes since 3.0.1rc8
1026 - Fix a format string vulnerability in the server that could lead to a
1027 remote root compromise (discovered by NGSEC Research Team, www.ngsec.com).
1029 - Add additional support for NetBSD/sparc64.
1031 - Fix a bug in the command-line parsing of the client. Also, resolve
1034 - Add better support for shells other than bash in the Linux client
1037 - Various build fixes for modern versions of FreeBSD and Linux.
1039 - Fix a bad bounds check when printing binding state names.
1041 - Clarify documentation about fixed-address and multiple addresses.
1043 - Fix a typo in the authoritative error message.
1045 - Make a log entry when we can't write a billing class.
1047 - Use conversion targets that are the right size on all architectures.
1049 - Increment the hop count when relaying.
1051 - Log a message when lease state is changed through OMAPI.
1053 - Don't rerun the shared_network when evaluating the pool.
1055 - Fix a reversed test in the parser.
1057 - Change the type of rbuf_max.
1059 - Make FTS_LAST a manifest constant to quiet warnings.
1061 Changes since 3.0.1rc7
1063 - Fix two compiler warnings that are generated when compiling on Solaris
1064 with gcc. These stop the build, even though they weren't actually
1065 errors, because we prefer that our builds generate no warnings.
1067 Changes since 3.0.1rc6
1069 - Don't allow a lease that's in the EXPIRED, RELEASED or RESET state
1072 - Implement lease stealing for cases where the primary has fewer leases
1073 than the secondary, as called for by the standard.
1075 - Add a fudge factor to the lease expiry acceptance code, (suggested
1076 by Kevin Miller of CMU).
1078 - Fix a bug in permit_list_match that made it much too willing to say
1079 that two permit lists matched.
1081 - Unless DEBUG_DNS_UPDATES is defined, print more user-friendly (and
1082 also more compact) messages about DNS updates.
1084 - Fix a bug in generating wire-format domain names for the FQDN option.
1086 - Fix a bug where the FQDN option would not be returned if the client
1087 requested it, contrary to the standard.
1089 - On Darwin, use the FreeBSD DHCP client script.
1091 - On NetBSD/sparc, don't check for casting warnings.
1093 - Add a flag in the DHCP client to disable updating the client's A
1094 record when sending an FQDN option indicating that the client is
1095 going to update its A record.
1097 - In the client, don't attempt a DNS update until one second after
1098 configuring the new IP address, and if the update times out, keep
1099 trying until a response, positive or negative, is received from the
1102 - Fix an uninitialized memory bug in the DHCP client.
1104 - Apply some FreeBSD-specific bug fixes suggested by Murray Stokely.
1106 - Fix a bug in ns_parserr(), where it was returning the wrong sort
1107 of result code in some cases (suggested by Ben Harris of the
1110 - Fix a bug in is_identifier(), where it was checking against EOF
1111 instead of the END_OF_FILE token (also suggested by Ben Harris).
1113 - Fix a bug where if an option universe contained no options, the
1114 DHCP server could dump core (Walter Steiner).
1116 - Fix a bug in the handling of encapsulated options.
1118 - Fix a bug that prevented NWIP suboptions from being processed.
1120 - Delete the FTS_BOOTP and FTS_RESERVED states and implement them
1121 as modifier flags to the FTS_ACTIVE state, as called for in the
1122 failover protocol standard.
1124 - Fix bugs in the pool merging code that resulted in references and
1125 dereferences of null pointers. This bug had no impact unless the
1126 POINTER_DEBUG flag was defined.
1128 - In the server, added a do-forward-updates flag that can be used to
1129 disable forward updates in all cases, so that sites that want the
1130 clients to take sole responsibility for updating their A record can
1133 - Make it possible to disable optimization of PTR record updates.
1135 Changes since 3.0.1rc5
1137 - Include some new documentation and changes provided by Karl Auer.
1139 - Add a workaround for some Lexmark printers that send a double-NUL-
1140 terminated host-name option, which would break DNS updates.
1142 - Fix an off-by-one error in the MAC-address checking code for
1143 DHCPRELEASE that was added in 3.0.1rc5.
1145 - Fix a bug where client-specific information was not being discarded
1146 from the lease when it expired or was released, resulting in
1147 problems if the lease was reallocated to a different client.
1149 - If more than one allocation pool is specified that has the same set
1150 of constraints as another allocation pool on the same shared
1151 network, merge the two pools.
1153 - Don't print an error in fallback_discard, since this just causes
1154 confusion and does not appear to be helping to encourage anyone to
1157 Changes since 3.0.1rc4
1159 - Fix a bug that would cause the DHCP server to spin if asked to parse
1160 a certain kind of incorrect statement.
1162 - Fix a related bug that would prevent an error from being reported in
1165 - Additional documentation.
1167 - Make sure that the hardware address matches the lease when
1168 processing a DHCPRELEASE message.
1170 Changes since 3.0.1rc3
1172 - A minor bug fix in the arguments to a logging function call.
1173 - Documentation update for dhcpd.conf.
1175 Changes since 3.0.1rc2
1177 - Allow the primary to send a POOLREQ message. This isn't what the current
1178 failover draft says to do, so we may have to back it out if I can't get the
1179 authors to relent, but the scheme for balancing that's specified in the
1180 current draft seems needlessly hairy, so I'm floating a trial balloon.
1181 The rc1 code did not implement the method described in the draft either.
1183 Changes since 3.0.1rc1
1185 - Treat NXDOMAIN and NXRRSET as success when we are trying to delete a
1186 domain or RRSET. This allows the DHCP server to forget about a name
1187 it added to the DNS once it's been removed, even if the DHCP server
1188 wasn't the one that removed it.
1190 - Install defaults for failover maximum outstanding updates and maximum
1191 silent time. This prevents problems that might occur if these values
1192 were not configured.
1194 - Don't do DDNS deletes if ddns-update-style is none.
1196 - Return relay agent information options in DHCPNAK. This prevents DHCPNAK
1197 messages from being dropped when the relay agent information option contains
1198 routing information.
1200 - Fix a problem where coming up in recover wouldn't result in an update
1203 - Add some more chatty messages when we start a recovery update and when it's
1206 - Fix a possible problem where some state might have been left around
1207 after the peer lost contact and regained contact about how many updates
1210 - Don't nix a lease update because of a lease conflict. This test has
1211 never (as far as I know) prevented a mistake, and it appears to cause
1212 problems with failover.
1214 - Add support in rc history code for keeping a selective history, rather
1215 than a history of all references and dereferences. This code is only used
1216 when extensive additional debugging is enabled.
1220 - Make allocators for hash tables. As a side effect, this fixes a memory
1221 smash in the subclass allocation code.
1223 - Fix a small bug in omshell where if you try to close an object when
1224 no object is open, it dumps core.
1226 - Fix an obscure coredump that could occur on shutdown.
1228 - Fix a bug in the recording of host declaration rubouts in the lease file.
1230 - Fix two potential spins in the host deletion code.
1232 - Fix a core dump that would happen if an application tried to update
1233 a host object attribute with a null value.
1235 Changes since 3.0 Release Candidate 12
1237 - Fix a memory leak in the evaluation code.
1239 - Fix an obscure core dump.
1241 - Print a couple of new warnings when parsing the configuration file
1242 when crucial information is left out.
1244 - Log "no free leases" as an error.
1246 - Documentation updates.
1248 Changes since 3.0 Release Candidate 11
1250 - Always return a subnet selection option if one is sent.
1252 - Fix a warning that was being printed because an automatic data
1253 structure wasn't zeroed.
1255 - Fix some failover state transitions that were being handled
1258 - When supersede_lease is called on a lease whose end time has already
1259 expired, but for which a state transition has not yet been done, do
1260 a state transition. This fixes the case where if the secondary
1261 allocated a lease to a client and the lease "expired" while the
1262 secondary was in partner-down, no expiry event would actually
1263 happen, so the lease would remain active until the primary was
1266 Changes since 3.0 Release Candidate 10
1268 - Fix a bug that was preventing released leases from changing state
1269 in failover-enabled pools.
1271 - Fix a core dump in the client identifier finder code (for host
1274 - Finish fixing a bug where bogus data would sometimes get logged to
1275 the dhclient.leases file because it was opened as descriptor 2.
1277 - Fix the Linux dhclient-script according to suggestions made by
1278 several people on the dhcp-client mailing list.
1280 - Log successful DNS updates at LOG_INFO, not LOG_ERROR.
1282 - Print an error message and refuse to run if a failover peer is
1283 defined but not referenced by any pools.
1285 - Correct a confusing error message in failover.
1287 Changes since 3.0 Release Candidate 9
1289 - Fix a bug in lease allocation for Dynamic BOOTP clients.
1291 Changes since 3.0 Release Candidate 8 Patchlevel 2
1293 - Fix a bug that prevented update-static-leases from working.
1295 - Document failover-state OMAPI object.
1297 - Fix a compilation error on SunOS 4.
1299 Changes since 3.0 Release Candidate 8 Patchlevel 1
1301 - Fix a parsing bug that broke dns updates (both interim and ad-hoc).
1302 This was introduced in rc8pl1 as an unintended result of the memory
1303 leakage fixes that were in pl1.
1305 - Fix a long-standing bug where the server would record that an update
1306 had been done for a client with no name, even though no update had
1307 been done, and then when the client's lease expired the deletion of
1308 that nonexistant record would time out because the name was the null
1311 - Clean up the omshell, dhcpctl and omapi man pages a bit.
1313 Changes since 3.0 Release Candidate 8
1315 - Fix a bug that could cause the DHCP server to spin if
1316 one-lease-per-client was enabled.
1318 - Fix a bug that was causing core dumps on BSD/os in the presence of
1321 - In partner-down state, don't restrict lease lengths to MCLT.
1323 - On the failover secondary, record the MCLT received from the primary
1324 so that if we come up without a connection to the primary we don't
1325 wind up giving out zero-length leases.
1327 - Fix some compilation problems on BSD/os.
1329 - Fix a bunch of memory leaks.
1331 - Fix a couple of bugs in the option printer.
1333 - Fix an obscure error reporting bug in the dns update code, and also
1334 make the message clearer when a key algorithm isn't supported.
1336 - Fix a bug in the tracing code that prevented trace runs that used
1337 tcp connections from being played back.
1339 - Add some additional debugging capability for catching memory leaks
1342 - Make the client release the lease correctly on shutdown.
1344 - Add some configurability to the build system.
1346 - Install omshell manual page in man1, not man8.
1348 - Craig Gwydir sent in a patch that fixes a long-standing bug in the
1349 DHCP client that could cause core dumps, but that for some reason
1350 hadn't been noticed until now.
1352 Changes since 3.0 Release Candidate 7
1354 - Fix a bug in failover where we weren't sending updates after a
1355 transition from communications-interrupted to normal.
1357 - Handle expired/released/reset -> free transition according to the
1358 protocol specification (this works - the other way not only wasn't
1359 conformant, but also didn't work).
1361 - Add a control object in both client and server that allows either
1362 daemon to be shut down cleanly.
1364 - When writing a lease, if we run out of disk space, shut down the
1365 output file and insist on writing a new one before proceeding.
1367 - In the server, if the OMAPI listener port is occupied, keep trying
1368 to get it, rather than simply giving up and exiting.
1370 - Support fetching variables from leases and also updating and adding
1371 variables to leases via OMAPI.
1373 - If two failover peers have wildly different clocks, refuse to start
1376 - Fix a bug in the DNS update code that could cause core dumps when
1377 running on alpha processors.
1379 - Fixed a bug in ddns updates for static lease entries, thanks to a
1380 patch from Andrey M Linkevitch.
1382 - Add support for Darwin/MacOS X
1384 - Install omshell (including new documentation).
1386 - Support DNS updates in the client (this is a very obscure feature
1387 that most DHCP client users probably will not be able to use).
1389 - Somewhat cleaner status logging in the client.
1391 - Make OMAPI key naming syntax compatible with the way keys are
1392 actually named (key names are domain names).
1394 - Fix a bug in the lease file writer.
1396 - Install DHCP ISC headers in a different place than BIND 9 ISC
1397 headers, to avoid causing trouble in BIND 9 builds.
1399 - Don't send updates for attributes on an object when the attributes
1400 haven't changed. Support deleting attributes on remote objects.
1402 - Fix a number of bugs in omshell, and add the unset and refresh
1405 - Handle disconnects in OMAPI a little bit more intelligently (so that
1406 the caller gets ECONNRESET instead of EINVAL).
1408 - Fix a bunch of bugs in the handling of clients that have existing
1409 leases when the try to renew their leases while failover is
1412 Changes since 3.0 Release Candidate 6
1414 - Fix a core dump that could happen when processing a DHCPREQUEST from
1415 a client that had a host declaration that contained both a
1416 fixed-address declaration and a dhcp-client-identifier option
1417 declaration, if the client identifier was longer than nine bytes.
1419 - Fix a memory leak that could happen in certain obscure cases when
1420 using omapi to manipulate leases.
1422 - Fix some bugs and omissions in omshell.
1425 Changes since 3.0 Release Candidate 5
1427 - Fix a bug in omapi_object_dereference that prevented objects in
1428 chains from having their reference counts decreased on dereference.
1430 - Fix a bug in omapi_object_dereference that would prevent object
1431 chains from being freed upon removal of the last reference external
1434 - Fix a number of other memory leaks in the OMAPI protocol subsystem.
1436 - Add code in the OMAPI protocol handler to trace memory leakage.
1438 - Clean up the memory allocation/reference history printer.
1440 - Support input of dotted quads and colon-separated hex lists as
1441 attribute values in omshell.
1443 - Fix a typo in the Linux interface discovery code.
1445 - Conditionalize a piece of trace code that wasn't conditional.
1447 Changes since 3.0 Release Candidate 4
1449 - Fix a bug that would prevent leases from being abandoned properly on
1452 - Fix failover peer OMAPI support.
1454 - In failover, correctly handle expiration of leases. Previously,
1455 leases would never be reclaimed because they couldn't make the
1456 transition from EXPIRED to FREE.
1458 - Fix some broken failover state transitions.
1460 - Documentation fixes.
1462 - Take out an unnecessary check in DHCP relay agent information option
1463 stashing code that was preventing REBINDING clients from rebinding.
1465 - Prevent failover peers from allocating leases in DHCPREQUEST
1466 processing if the lease belongs to the other server.
1468 - Record server version in lease file introductory comment.
1470 - Correctly report connection errors in OMAPI and failover.
1472 - Make authentication signature algorithm name comparisons in OMAPI
1475 - Fix compile problem on SunOS 4.x
1477 - If a signature algorithm is not terminated with '.', terminate it so
1478 that comparisons between fully-qualified names will work
1481 - Different SIOCGIFCONF probe code, may "fix" problem on some Linux
1482 systems with the probe not working correctly.
1484 - Don't allow user to type omapi key on command line of omshell.
1486 Changes since 3.0 Release Candidate 3
1488 - Do lease billing on startup in a way that I *think* will finally do
1489 the billing correctly - the previous method could overbill as a
1490 result of duplicate leases.
1492 - Document OMAPI server objects.
1494 Changes since 3.0 Release Candidate 2 Patchlevel 1
1496 - Fix some problems in the DDNS update code. Thanks to Albert
1497 Herranz for figuring out the main problem.
1499 - Fix some reference counting errors on host entries that were causing
1502 - Fix a byte-swap bug in the token ring code, thanks to Jochen
1505 - Fix a bug in lease billing, thanks to Jonas Bulow.
1507 Changes since 3.0 Release Candidate 2
1509 - Change the conditions under which a DHCPRELEASE is actually
1510 committed to be consistent with lease binding states rather than
1511 using the lease end time. This may fix some problems with the
1514 - Fix a bug where lease updates would fail on Digital Unix (and maybe
1515 others) because malloc was called with a size of zero.
1517 - Fix a core dump that happens when the DHCP server can't create its
1520 Changes since 3.0 Release Candidate 1 Patchlevel 1
1522 - Fix the dhcp_failover_put_message to not attempt to allocate a
1523 zero-length buffer. Some versions of malloc() fail if you try to
1524 allocate a zero-length buffer, and this was causing problems on,
1527 - Fix a case where the failover code was printing an error message
1528 when no error had occurred.
1530 - Fix a problem where when a server went down and back up again, the
1531 peer would not see a state transition and so would stay in the
1532 non-communicating state.
1534 - Be smart about going into recover_wait.
1536 - Fix a problem in the failover implementation where peers would fail
1537 to come into sync if interrupted in the RECOVER state. This could
1538 have been the cause of some problems people have reported recently.
1540 - Fix a problem with billing classes where they would not be unbilled
1541 when the client lease expired.
1543 - If select fails, figure out which descriptor is bad, and cut it out
1544 of the I/O loop. This prevents a potentially nasty spin. I
1545 haven't heard any report it in a while, but it came up consistently
1548 - Fix a bug in the relay agent where if you specified interfaces on
1549 the command line, it would fail.
1551 - Fix a couple of small bugs in the omapi connection object (no known
1554 - Add the missing 3.0 Beta 1 lease conversion script.
1556 - Read dhcp client script hooks if they exist, rather than only if
1559 Changes since 3.0 Release Candidate 1
1561 - Fix a memory smash that happens when fixed-address leases are used.
1562 ANY SITE AT WHICH FIXED-ADDRESS STATEMENTS ARE BEING USED SHOULD
1563 UPGRADE IMMEDIATELY. This has been a long-standing bug - thanks to
1564 Alvise Nobile for discovering it and helping me to find it!
1566 - Fix a small bug in binary-to-ascii, thanks to H. Peter Anvin of
1569 - There is a known problem with the DHCP server doing failover on
1570 Compaq Alpha systems. This patchlevel is not a release candidate
1571 because of this bug. The bug should be straightforward to fix, so
1572 a new release candidate is expected shortly.
1574 - There is a known problem in the DDNS update code that is probably a
1575 bug, and is not, as far as we know, fixed in this patchlevel.
1577 Changes since 3.0 Beta 2 Patchlevel 24
1579 - Went over problematic failover state transitions and made them all
1580 work, so that failover should now much less fragile.
1582 - Add some dhcpctl and omapi documentation
1584 - Fix compile errors when compiling with unusual predefines.
1586 - Make Token Ring work on Linux 2.4
1588 - Fix the Digital Unix BPF_WORDALIGN bug.
1590 - Fix some dhcp client documentation errors.
1592 - Update some parts of the README file.
1594 - Support GCC on SCO.
1596 Changes since 3.0 Beta 2 Patchlevel 23
1598 - Fix a bug in the DNS update code where a status code was not being
1599 checked. This may have been causing core dumps.
1601 - When parsing the lease file, if a lease declaration includes a
1602 billing class statement, and the lease already has a billing class,
1603 unbill the old class.
1605 - When processing failover transactions, where acks will be deferred,
1606 process the state transition immediately.
1608 - Don't try to use the new SIOCGIFCONF buffer size detection code on
1609 Linux 2.0, which doesn't provide this functionality.
1611 - Apply a patch suggested by Tuan Uong for a problem in dlpi.c.
1613 - Fix a problem in using the which command in the configure script.
1615 - Fix a parse error in the client when setting up an omapi listener.
1617 - Document the -n and -g flags to the client.
1619 - Make sure there is always a stdin and stdout on startup. This
1620 prevents shell scripts from accidentally writing error messages into
1621 configuration files that happen to be opened as stderr.
1623 - If an interface is removed, the client will now notice that it is
1624 gone rather than spinning. This has only been tested on NetBSD.
1626 - The client will attempt to get an address even if it can't create a
1629 - Don't overwrite tracefiles.
1631 - Fix some memory allocation bugs in failover.
1633 Changes since 3.0 Beta 2 Patchlevel 22
1635 - Apply some patches suggested by Cyrille Lefevre, who is maintaining
1636 the FreeBSD ISC DHCP Distribution port.
1638 - Fix a core dump in DHCPRELEASE.
1640 Changes since 3.0 Beta 2 Patchlevel 21
1642 - This time for sure: fix the spin described in the changes for pl20.
1644 Changes since 3.0 Beta 2 Patchlevel 20
1646 - Fix a problem with Linux detecting large numbers of interfaces (Ben)
1648 - Fix a memory smash in the quotify code, which was introduced in
1651 - Actually fix the spin described in the changes for pl20. The
1652 previous fix only partially fixed the problem - enough to get it
1653 past the regression test.
1655 Changes since 3.0 Beta 2 Patchlevel 19
1657 - Fix a bug that could cause the server to abort if compiled with
1658 POINTER_DEBUG enabled.
1660 - Fix a bug that could cause the server to spin when responding to a
1663 - Apply Joost Mulders' suggested patches for DLPI on x86.
1665 - Support NUL characters in quoted strings.
1667 - Install unformatted man pages on SunOS.
1669 Changes since 3.0 Beta 2 Patchlevel 18
1671 - Allow the server to be placed in partner-down state using OMAPI.
1674 - Implement omshell, which can be used to do arbitrary things to the
1675 server (in theory). (Damien Neil)
1677 - Fix a case where if a client had two different leases the server could
1678 actually dereference the second one when it hadn't been referenced,
1679 leading to memory corruption and a core dump. (James Brister)
1681 - Fix a case where a client could request the address of another client's
1682 lease, but find_lease wouldn't detect that the other client had it, and
1683 would attempt to allocate it to the client, resulting in a lease conflict
1686 - Fix a case where a client with more than one client identifier could be
1687 given a lease where the hardware address was correct but the client
1688 identifier was not, resulting in a lease conflict message.
1690 - Fix a problem where the server could write out a colon-separated
1691 hex list as a value for a variable, which would then not parse.
1692 The fix is to always write strings as quoted strings, with any
1693 non-printable characters quoted as octal escape sequences. So
1694 a file written the old way still won't work, but new files written
1697 - Fix documentation for sending non-standard options.
1699 - Use unparsable names for unknown options. WARNING: this will
1700 break any configuration files that use the option-nnn convention.
1701 If you want to continue to use this convention for some options,
1702 please be sure to write a definition, like this:
1704 option option-nnn code nnn = string;
1706 You can use a descriptive name instead of option-nnn if you like.
1708 - Fix a problem where we would see a DHCPDISCOVER/DHCPOFFER/
1709 DHCPREQUEST/DHCPACK/DHCPREQUEST/DHCPNAK sequence. This was the
1710 result of a deceptively silly bug in supersede_lease.
1712 - Fix client script exit status check, according to a fix supplied by
1715 - Fix an endianness bug in the tracefile support, regarding ICMP
1718 - Fix a bug in the client where the medium would not work correctly if
1719 it contained quoted strings.
1721 ** there was no pl17 **
1723 Changes since 3.0 Beta 2 Patchlevel 16
1725 - Add support for transaction tracing. This allows the state of the
1726 DHCP server on startup, and all the subsequent transactions, to be
1727 recorded in a file which can then be played back to reproduce the
1728 behaviour of the DHCP server. This can be used to quickly
1729 reproduce bugs that cause core dumps or corruption, and also for
1730 tracking down memory leaks.
1732 - Incorporate some bug fixes provided by Joost Mulders for the DLPI
1733 package which should clear up problems people have been seeing on
1736 - Fix bugs in the handling of options stored as linked lists (agent
1737 options, fqdn options and nwip options) that could cause memory
1738 corruption and core dumps.
1740 - Fix a bug in DHCPREQUEST handling that resulted in DHCPNAK messages
1741 not being send in some cases when they were needed.
1743 - Make the lease structure somewhat more compact.
1745 - Make initial failover startup *much* faster. This was researched
1746 and implemented by Damien Neil.
1748 - Add a --version flag to all executables, which prints the program
1749 name and version to standard output.
1751 - Don't rewrite the lease file every thousand leases.
1753 - A bug in nit.c for older SunOS machines was fixed by a patch sent in
1754 by Takeshi Hagiwara.
1756 - Fix a memory corruption bug in the DHCP client.
1758 - Lots of documentation updates.
1760 - Add a feature allowing environment variables to be passed to the
1761 DHCP client script on the DHCP client command line.
1763 - Fix client medium support, which had been broken for some time.
1765 - Fix a bug in the DHCP client initial startup backoff interval, which
1766 would cause two DHCPDISCOVERS to be sent back-to-back on startup.
1769 Changes since 3.0 Beta 2 Patchlevel 15
1771 - Some documentation tweaks.
1773 - Maybe fix a problem in the DLPI code.
1775 - Fix some error code space inconsistencies in ddns update code.
1777 - Support relay agents that intercept unicast DHCP messages to stuff
1778 agent options into them.
1780 - Fix a small memory leak in the relay agent option support code.
1782 - Fix a core dump that would occur if a packet was sent with no
1785 Changes since 3.0 Beta 2 Patchlevel 14
1787 - Finish fixing a long-standing bug in the agent options code. This
1788 was causing core dumps and failing to operate correctly - in
1789 particular, agent option stashing wasn't working. Agent option
1790 stashing should now be working, meaning that agent options can be
1791 used in class statements to control address allocation.
1793 - Fix up documentation.
1795 - Fix a couple of small memory leaks that would have added up
1796 significantly in a high-demand situation.
1798 - Add a log-facility configuration parameter.
1800 - Fix a compile error on some older operating systems.
1802 - Add the ability in the client to execute certain statements before
1803 transmitting packets to the server. Handy for debugging; not much
1804 practical use otherwise.
1806 - Don't send faked-out giaddr when renewing or bound - again, useful
1809 Changes since 3.0 Beta 2 Patchlevel 13
1811 - Fixed a problem where the fqdn decoder would sometimes try to store
1812 an option with an (unsigned) negative length, resulting in a core
1813 dump on some systems.
1815 - Work around the Win98 DHCP client, which NUL-terminates the FQDN
1818 - Work around Win98 and Win2k clients that will claim they want to do
1819 the update even when they don't have any way to do it.
1821 - Fix some log messages that can be printed when failover is operating
1822 that were not printing enough information.
1824 - It was possible for a DHCPDISCOVER to get an allocation even when
1825 the state machine said the server shouldn't be responding.
1827 - Don't load balance DHCPREQUESTs from clients in RENEWING and
1828 REBINDING, since in RENEWING, if we heard it, it's for us, and in
1829 REBINDING, the client wouldn't have got to REBINDING if its primary
1832 - When we get a bogus state lease binding state transition, don't do
1836 Changes since 3.0 Beta 2 Patchlevel 12
1838 - Fixed a couple of silly compile errors.
1840 Changes since 3.0 Beta 2 Patchlevel 11
1842 - Albert Herranz tracked down and fixed a subtle bug in the base64
1843 decoder that would prevent any key with an 'x' in its base64
1844 representation from working correctly.
1846 - Thanks to Chris Cheney and Michael Sanders, we have a fix for the
1847 hang that they both spotted in the DHCP server - when
1848 one-lease-per-client was set, the code to release the "other" lease
1851 - Fix a problem with alignment of the input buffer in bpf in cases
1852 where two packets arrive in the same bpf read.
1854 - Fix a problem where the relay agent would crash if you specified an
1855 interface name on the command line.
1857 - Add the ability to conditionalize client behaviour based on the
1860 - Add support for the FQDN option, and added support for a new way of
1861 doing ddns updates (ddns update style interim) that allows more than
1862 one DHCP server to update the DNS for the same network(s). This
1863 was implemented by Damien Neil with some additional functionality
1866 - Damien added a "log" statement, so that the configuration file can
1867 be made to log debugging information and other information.
1869 - Fixed a bug that caused option buffers not to be terminated with an
1872 - Fixed a long-standing bug in the support for option spaces where the
1873 options are stored as an ordered list rather than in a hash table,
1874 which could theoretically result in memory pool corruption.
1876 - Prevent hardware declarations with no actual hardware address from
1877 being written as something unparsable, and behave correctly in the
1878 face of a null hardware address on input.
1880 - Allow key names to be FQDNs, and qualify the algorithm name if it is
1881 specified unqualified.
1883 - Modify the DDNS update code so that it never prints the "resolver
1884 failed" message, but instead says *why* the resolver failed.
1886 - Officially support the subnet selection option, which now has an
1889 - Fix a build bug on MacOS X.
1891 - Allow administrator to disable ping checking.
1893 - Clean up dhcpd.conf documentation and add more information about how
1896 Changes since 3.0 Beta 2 Patchlevel 10
1898 - Fix a bug introduced during debugging (!) and accidentally committed
1901 Changes since 3.0 Beta 2 Patchlevel 9
1903 - Fix DHCP client handling of vendor encapsulated options.
1905 - Fix a bug in the handling of relay agent information options introduced
1908 - Stash agent options on client leases by default, and use the stashed
1909 options at renewal time.
1911 - Add the ability to test the client's binding state in the client
1912 configuration language.
1914 - Fix a core dump in the DNS update code.
1916 - Fix some expression evaluation bugs that were causing updates to be
1917 done when no client hostname was received.
1919 - Fix expression evaluation debugging printfs.
1921 - Teach pretty_print_option to print options in option spaces other than
1922 the DHCP option space.
1924 - Add a warning message if the RHS of a not is not boolean.
1926 - Never select for more than a day, because some implementations of
1927 select will just fail if the timeout is too long (!).
1929 - Fix a case where a DHCPDISCOVER from an unknown network would be
1932 - Fix a bug where if a client requested an IP address for which a different
1933 client had the lease, the DHCP server would reallocate it anyway.
1935 - Fix the DNS update code so that if the client changes its name, the DNS
1936 will be correctly updated.
1938 Changes since 3.0 Beta 2 Patchlevel 8
1940 - Oops, there was another subtle math error in the header-length
1943 Changes since 3.0 Beta 2 Patchlevel 7
1945 - Oops, forgot to byte-swap udp header length before bounds-checking it.
1947 Changes since 3.0 Beta 2 Patchlevel 6
1949 - Fix a possible DoS attack where a client could cause the checksummer
1950 to dump core. This was a read, not a write, so it shouldn't be
1951 possible to exploit it any further than that.
1953 - Implement client- and server-side support for using the Client FQDN
1956 - Support for other option spaces in the client has been added. This
1957 means that it is now possible to define a vendor option space on the
1958 client, request options in that space from the server (which must
1959 define the same option space), and then use those options in the
1960 client. This also allows NWIP and Client FQDN options to be used
1963 - Add object initializer support. This means that objects can now be
1964 initialized to something other than all-zeros when allocated, which
1965 makes, e.g., the interface object support code a little more robust.
1967 - Fix an off-by-one bug in the host stuffer. This was causing host
1968 deletes not the work, and may also have been causing OMAPI
1969 connections to get dropped. Thanks to James Brister for tracking
1972 - Fixed a core dump in the interface discovery code that is triggered
1973 when there is no subnet declaration for an interface, but the server
1974 decides to continue running. Thanks to Shane Kerr for tracking
1975 down and fixing this problem.
1977 Changes since 3.0 Beta 2 Patchlevel 5
1979 - Fix a bug in the recent enhancement to the interface discovery code
1980 to support arbitrary-length interface lists.
1982 - Support NUL-terminated DHCP options when initializing client-script
1985 - Fix suffix operator.
1987 - Fix NetWare/IP option parsing.
1989 - Better error/status checking in dhcpctl initialization and omapi
1992 - Fix a potential memory smash in dhcpctl code.
1994 - Fix SunOS4 and (maybe) Ultrix builds.
1996 - Fix a bug where a certain sort of incoming packet could cause a core
1997 dump on Solaris (and probably elsewhere).
1999 - Add some more safety checks in error logging code.
2001 - Add support for ISC_R_INCOMPLETE in OMAPI protocol connection code.
2003 - Fix relay agent so that if an interface is specified on the command
2004 line, the relay agent does not dump core.
2006 - Fix class matching so that match if can be combined with match or
2009 - Do not allow spurious leases in the lease database to introduce
2010 potentially bogus leases into the in-memory database.
2012 - Fix a byte-order problem in the client hardware address type code
2015 - Be slightly less picky about what sort of hardware addresses OMAPI
2016 can install in host declarations.
2018 Changes since 3.0 Beta 2 Patchlevel 4
2020 - Incorporated Peter Marschall's proposed change to array/record
2021 parsing, which allows things like the slp-agent option to be encoded
2022 correctly. Thanks very much to Peter for taking the initiative to
2023 do this, and for doing such a careful job of it (e.g., updating the
2026 - Added an encoding for the slp-agent option. :')
2028 - Fixed SunOS 4 build. Thanks to Robert Elz for responding to my
2029 request for help on this with patches!
2031 - Incorporated a change that should fix a problem reported by Philippe
2032 Jumelle where when the network connection between two servers is
2033 lost, they never reconnect.
2035 - Fix client script files other than that for NetBSD to actually use
2036 make_resolv_conf as documented in the manual page.
2038 - Fix a bug in the packet handling code that could result in a core
2041 - Fix a bug in the bootp code where responses on the local net would
2042 be sent to the wrong MAC address. Thanks to Jerry Schave for
2045 Changes since 3.0 Beta 2 Patchlevel 3
2047 - In the DHCP client, execute client statements prior to using the values
2048 of options, so that the client configuration can overried, e.g., the
2051 - Fix a reference counting error that would result in very reproducible
2052 failures in updates, as well as occasional core dumps, if a zone was
2053 declared without a key.
2055 - Fix some Linux 2.0 compilation problems.
2057 - Fix a bug in scope evaluation during execution of "on" statements that
2058 caused values not to be recorded on leases.
2060 - If the dhcp-max-message-size option is specified in scope, and the
2061 client didn't send this option, use the one specified in scope to
2062 determine the maximum size of the response.
2064 Changes since 3.0 Beta 2 Patchlevel 2
2066 - Fix a case where spawning subclasses were being allocated
2067 incorrectly, resulting in a core dump.
2069 - Fix a case where the DHCP server might inappropriately NAK a
2072 - Fix a place dhcprequest() where static leases could leak.
2074 - Include memory.h in omapip_p.h so that we don't get warnings about
2077 Changes since 3.0 Beta 2 Patchlevel 1
2079 - Notice when SIOCFIGCONF returns more data than fit in the buffer -
2080 allocate a larger buffer, and retry. Thanks to Greg Fausak for
2083 - In the server, if no interfaces were configured, report an error and
2086 - Don't ever record a state of 'startup'.
2088 - Don't try to evaluate the local failover binding address if none was
2089 specified. Thanks to Joseph Breu for finding this.