summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Hankins <dhankins@isc.org>2005-09-28 19:17:08 +0000
committerDavid Hankins <dhankins@isc.org>2005-09-28 19:17:08 +0000
commit5826d73733ea63088fa56d6fbc4eedee61fea9fa (patch)
tree358b35c79fa8bec08c1c3cabe295b8fcb708ce3c
parent450a30a85a12a07dc08e59559e82a345a91c8293 (diff)
downloadisc-dhcp-5826d73733ea63088fa56d6fbc4eedee61fea9fa.tar.gz
- Document STOP, RELEASE, NBI dhclient-script states.
-rw-r--r--RELNOTES3
-rw-r--r--client/dhclient-script.819
2 files changed, 19 insertions, 3 deletions
diff --git a/RELNOTES b/RELNOTES
index f9987473..4ce280b0 100644
--- a/RELNOTES
+++ b/RELNOTES
@@ -89,6 +89,9 @@ and for prodding me into improving it.
is either nonsensical or (in the case of IEEE1394) is not known to support
these interfaces. Thanks to Marius Gedminas and Andrew Pollock of Debian.
+- Some previously undocumented reasons for dhclient-script invoking has
+ been doucmented in the dhclient-script.8 manpage.
+
Changes since 3.0.3b3
- dhclient.conf documentation for interface {} was updated to reflect recent
diff --git a/client/dhclient-script.8 b/client/dhclient-script.8
index d81cf411..6b881f53 100644
--- a/client/dhclient-script.8
+++ b/client/dhclient-script.8
@@ -1,6 +1,6 @@
.\" dhclient-script.8
.\"
-.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
+.\" Copyright (c) 2004-2005 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
@@ -28,7 +28,7 @@
.\" see ``http://www.vix.com''. To learn more about Nominum, Inc., see
.\" ``http://www.nominum.com''.
.\"
-.\" $Id: dhclient-script.8,v 1.8.2.5 2004/06/10 17:59:12 dhankins Exp $
+.\" $Id: dhclient-script.8,v 1.8.2.6 2005/09/28 19:17:08 dhankins Exp $
.\"
.TH dhclient-script 8
.SH NAME
@@ -97,7 +97,8 @@ defines a set of variables in the environment, and then invokes
.B CLIENTBINDIR/dhclient-script.
In all cases, $reason is set to the name of the reason why the script
has been invoked. The following reasons are currently defined:
-MEDIUM, PREINIT, BOUND, RENEW, REBIND, REBOOT, EXPIRE, FAIL and TIMEOUT.
+MEDIUM, PREINIT, BOUND, RENEW, REBIND, REBOOT, EXPIRE, FAIL, STOP, RELEASE,
+NBI and TIMEOUT.
.PP
.SH MEDIUM
The DHCP client is requesting that an interface's media type
@@ -175,6 +176,18 @@ The DHCP client has been unable to contact any DHCP servers, and any
leases that have been tested have not proved to be valid. The
parameters from the last lease tested should be deconfigured. This
can be handled in the same way as EXPIRE.
+.SH STOP
+The dhclient has been informed to shut down gracefully, the
+dhclient-script should unconfigure or shutdown the interface as
+appropriate.
+.SH RELEASE
+The dhclient has been executed using the -r flag, indicating that the
+administrator wishes it to release its lease(s). dhclient-script should
+unconfigure or shutdown the interface.
+.SH NBI
+No-Broadcast-Interfaces...dhclient was unable to find any interfaces
+upon which it believed it should commence DHCP. What dhclient-script
+should do in this situation is entirely up to the implementor.
.SH TIMEOUT
The DHCP client has been unable to contact any DHCP servers.
However, an old lease has been identified, and its parameters have