From 5826d73733ea63088fa56d6fbc4eedee61fea9fa Mon Sep 17 00:00:00 2001 From: David Hankins Date: Wed, 28 Sep 2005 19:17:08 +0000 Subject: - Document STOP, RELEASE, NBI dhclient-script states. --- RELNOTES | 3 +++ client/dhclient-script.8 | 19 ++++++++++++++++--- 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 -- cgit v1.2.1