From 0 Mon Sep 17 00:00:00 2001

From: Mikhail Efremov <sem@altlinux.org>

Date: Tue, 30 Oct 2012 18:37:14 +0400

Subject: [PATCH 20] Document ALT-specific in the dhclient-script manpage.

diff --git a/dhcp/client/dhclient-script.8 b/dhcp/client/dhclient-script.8

index defaced..defaced 100644

--- a/dhcp/client/dhclient-script.8

+++ b/dhcp/client/dhclient-script.8

@@ -40,10 +40,7 @@ any, and also called once if no valid lease can be identified.

 .PP

 This script is not meant to be customized by the end user.  If local

 customizations are needed, they should be possible using the enter and

-exit hooks provided (see HOOKS for details).   These hooks will allow the

-user to override the default behaviour of the client in creating a

-.B /etc/resolv.conf

-file.

+exit hooks provided (see HOOKS for details).

 .PP

 No standard client script exists for some operating systems, even though

 the actual client may work, so a pioneering user may well need to create

@@ -55,38 +52,12 @@ customizing

 .B ETCDIR/dhclient.conf

 or using the enter and exit hooks, please submit a bug report.

 .SH HOOKS

-When it starts, the client script first defines a shell function,

-.B make_resolv_conf ,

-which is later used to create the

-.B /etc/resolv.conf

-file.   To override the default behaviour, redefine this function in

-the enter hook script.

+The dhclient-script is used to run any system and user defined hook scripts.

 .PP

-On after defining the make_resolv_conf function, the client script checks

-for the presence of an executable

-.B ETCDIR/dhclient-enter-hooks

-script, and if present, it invokes the script inline, using the Bourne

-shell \'.\' command.   The entire environment documented under OPERATION

-is available to this script, which may modify the environment if needed

-to change the behaviour of the script.   If an error occurs during the

-execution of the script, it can set the exit_status variable to a nonzero

-value, and

-.B CLIENTBINDIR/dhclient-script

-will exit with that error code immediately after the client script exits.

-.PP

-After all processing has completed,

-.B CLIENTBINDIR/dhclient-script

-checks for the presence of an executable

-.B ETCDIR/dhclient-exit-hooks

-script, which if present is invoked using the \'.\' command.  The exit

-status of dhclient-script will be passed to dhclient-exit-hooks in the

-exit_status shell variable, and will always be zero if the script

-succeeded at the task for which it was invoked.   The rest of the

-environment as described previously for dhclient-enter-hooks is also

-present.   The

-.B ETCDIR/dhclient-exit-hooks

-script can modify the valid of exit_status to change the exit status

-of dhclient-script.

+System hook scripts are found in /etc/dhcp/dhclient-hooks.d/ and the user

+defined hooks are /etc/dhcp/dhclient-enter-hooks and /etc/dhcp/dhclient-exit-hooks.

+You can disable some hooks in the /etc/sysconfig/dhclient config file

+using SKIP_HOOKS option.

 .SH OPERATION

 When dhclient needs to invoke the client configuration script, it

 defines a set of variables in the environment, and then invokes