From f960d193a2403e0aeb67a58633d60644637a64be Mon Sep 17 00:00:00 2001 From: Shawn Routhier Date: Mon, 25 Apr 2011 23:49:52 +0000 Subject: [PATCH] Documentation fixes [ISC-Bugs #17959] add text to AIX section describing how to have it send responses to the all-ones address. [ISC-Bugs #19615] update the includes in dhcpctl/dhcpctl.3 to be more correct [ISC-Bugs #20676] update dhcpd.conf.5 to include the RFC numbers for DDNS --- README | 16 +++++++++++++ RELNOTES | 6 +++++ dhcpctl/dhcpctl.3 | 17 +++++++++----- server/dhcpd.conf.5 | 57 ++++++++++++++++++++++++++++----------------- 4 files changed, 68 insertions(+), 28 deletions(-) diff --git a/README b/README index d57c179f5..a42c05060 100644 --- a/README +++ b/README @@ -477,10 +477,26 @@ server and relay will work only on a single interface. (They do work on multi-interface machines if configured to listen on only one of the interfaces.) +We have reports of Windows XP clients having difficutly retrieving +addresses from a server running on an AIX machine. This issue +was traced to the client requiring messages be sent to the all ones +broadcast address (255.255.255.255) while the AIX server was sending +to 192.168.0.255. + +You may be able to solve this by including a relay between the client +and server with the relay configured to use a broadcast of all-ones. + +A second option that worked for AIX 5.1 but doesn't seem to work for +AIX 5.3 was to: + create a host file entry for all-ones (255.255.255.255) +and then add a route: + route add -host all-ones -interface + The ISC DHCP distribution does not include a dhclient-script for AIX-- AIX comes with a DHCP client. Contribution of a working dhclient-script for AIX would be welcome. + MacOS X The MacOS X system uses a TCP/IP stack derived from FreeBSD with a diff --git a/RELNOTES b/RELNOTES index 779510c8e..0cd11a581 100644 --- a/RELNOTES +++ b/RELNOTES @@ -105,6 +105,12 @@ work on other platforms. Please report any problems and suggested fixes to subnet the root configuration area is examined. Server now also returns vendor-class-id option, if client sent it. [ISC-Bugs #21094] +- Documentation fixes + [ISC-Bugs #17959] add text to AIX section describing how to have it send + responses to the all-ones address. + [ISC-Bugs #19615] update the includes in dhcpctl/dhcpctl.3 to be more correct + [ISC-Bugs #20676] update dhcpd.conf.5 to include the RFC numbers for DDNS + Changes since 4.2.1rc1 - None diff --git a/dhcpctl/dhcpctl.3 b/dhcpctl/dhcpctl.3 index 4abdbf787..102f47e92 100644 --- a/dhcpctl/dhcpctl.3 +++ b/dhcpctl/dhcpctl.3 @@ -2,8 +2,9 @@ .\" .\" Project: DHCP .\" File: dhcpctl.3 -.\" RCSId: $Id: dhcpctl.3,v 1.7.24.1 2009/11/20 01:49:01 sar Exp $ +.\" RCSId: $Id: dhcpctl.3,v 1.7.24.2 2011/04/25 23:49:52 sar Exp $ .\" +.\" Copyright (c) 2011 by Internet Systems Consortium, Inc. ("ISC") .\" Copyright (c) 2004,2009 by Internet Systems Consortium, Inc. ("ISC") .\" Copyright (c) 2000-2003 by Internet Software Consortium .\" Copyright (c) 2000 Nominum, Inc. @@ -417,16 +418,20 @@ released. The following program will connect to the DHCP server running on the local host and will get the details of the existing lease for IP address 10.0.0.101. It will then print out the time the lease is due to expire. Note -that most error checking has been ommitted for brevity. +that most error checking has been ommitted for brevity. .Bd -literal -offset indent -#include #include -#include #include +#include +#include +#include + +#include #include +#include -#include -#include +#include "omapip/result.h" +#include "dhcpctl.h" int main (int argc, char **argv) { dhcpctl_data_string ipaddrstring = NULL; diff --git a/server/dhcpd.conf.5 b/server/dhcpd.conf.5 index 932f82198..2b3796f21 100644 --- a/server/dhcpd.conf.5 +++ b/server/dhcpd.conf.5 @@ -1,6 +1,6 @@ .\" dhcpd.conf.5 .\" -.\" Copyright (c) 2004-2010 by Internet Systems Consortium, Inc. ("ISC") +.\" Copyright (c) 2004-2011 by Internet Systems Consortium, Inc. ("ISC") .\" Copyright (c) 1996-2003 by Internet Software Consortium .\" .\" Permission to use, copy, modify, and distribute this software for any @@ -27,7 +27,7 @@ .\" Support and other services are available for ISC products - see .\" https://www.isc.org for more information or to learn more about ISC. .\" -.\" $Id: dhcpd.conf.5,v 1.106.18.2 2010/07/06 19:03:12 sar Exp $ +.\" $Id: dhcpd.conf.5,v 1.106.18.3 2011/04/25 23:49:52 sar Exp $ .\" .TH dhcpd.conf 5 .SH NAME @@ -1074,13 +1074,13 @@ compliant so any DNS server supporting RFC 2136 should be able to accept updates from the DHCP server. .PP Two DNS update schemes are currently implemented, and another is -planned. The two that are currently available are the ad-hoc DNS +planned. The two that are currently implemented are the ad-hoc DNS update mode and the interim DHCP-DNS interaction draft update mode. -If and when the DHCP-DNS interaction draft and the DHCID draft make it -through the IETF standards process, there will be a third mode, which -will be the standard DNS update method. The DHCP server must be -configured to use one of the two currently-supported methods, or not -to do dns updates. This can be done with the +In the future we plan to add a third mode which will be the standard +DNS update method based on the RFCS for DHCP-DNS interaction and DHCID +The DHCP server must be configured to use one of the two +currently-supported methods, or not to do dns updates. +This can be done with the .I ddns-update-style configuration parameter. .SH THE AD-HOC DNS UPDATE SCHEME @@ -1172,15 +1172,31 @@ by sending a DHCPRELEASE message, the server will likewise remove the A and PTR records. .SH THE INTERIM DNS UPDATE SCHEME The interim DNS update scheme operates mostly according to several -drafts that are being considered by the IETF and are expected to -become standards, but are not yet standards, and may not be -standardized exactly as currently proposed. These are: +drafts considered by the IETF. While the drafts have since become +RFCs the code was written before they were finalized and there are +some differences between our code and the final RFCs. We plan to +update our code, probably adding a standard DNS update option, at +some time. The basic framework is similar with the main material +difference being that a DHCID RR was assigned in the RFCs whereas +our code continues to use an experimental TXT record. The format +of the TXT record bears a resemblance to the DHCID RR but it is not +equivalent (MD5 vs SHA1, field length differences etc). +The standard RFCs are: +.PP +.nf +.ce 3 +RFC 4701 (updated by RF5494) +RFC 4702 +RFC 4703 +.fi +.PP +And the corresponding drafts were: .PP .nf .ce 3 -draft-ietf-dhc-ddns-resolution-??.txt -draft-ietf-dhc-fqdn-option-??.txt draft-ietf-dnsext-dhcid-rr-??.txt +draft-ietf-dhc-fqdn-option-??.txt +draft-ietf-dhc-ddns-resolution-??.txt .fi .PP Because our implementation is slightly different than the standard, we @@ -1259,15 +1275,12 @@ gives up trying to do a DNS update for the client until the client chooses a new name. .PP The interim DNS update scheme is called interim for two reasons. -First, it does not quite follow the drafts. The current versions of -the drafts call for a new DHCID RRtype, but this is not yet -available. The interim DNS update scheme uses a TXT record -instead. Also, the existing ddns-resolution draft calls for the DHCP -server to put a DHCID RR on the PTR record, but the \fIinterim\fR -update method does not do this. It is our position that this is not -useful, and we are working with the author in hopes of removing it -from the next version of the draft, or better understanding why it is -considered useful. +First, it does not quite follow the RFCs. The RFCs call for a +new DHCID RRtype while he interim DNS update scheme uses a TXT record. +The ddns-resolution draft cllaed for the DHCP server to put a DHCID RR +on the PTR record, but the \fIinterim\fR update method does not do this. +In the final RFC this requirement was relaxed such that a server may +add a DHCID RR to the PTR record. .PP In addition to these differences, the server also does not update very aggressively. Because each DNS update involves a round trip to the -- 2.47.3