diff options
author | Bob Beck <beck@cvs.openbsd.org> | 2002-03-25 03:43:53 +0000 |
---|---|---|
committer | Bob Beck <beck@cvs.openbsd.org> | 2002-03-25 03:43:53 +0000 |
commit | e193f4c0989577c4128b443457476046b1706516 (patch) | |
tree | fe6b2292e0ee5bed1ff5ae9df130ffe25f6249c9 /usr.sbin/dhcp/dhclient | |
parent | 0f0d9ebbb0f57c39b293556f9ade78b449709072 (diff) |
make docs match reality - we don't support hooks in dhclient-script
Diffstat (limited to 'usr.sbin/dhcp/dhclient')
-rw-r--r-- | usr.sbin/dhcp/dhclient/dhclient-script.8 | 41 |
1 files changed, 2 insertions, 39 deletions
diff --git a/usr.sbin/dhcp/dhclient/dhclient-script.8 b/usr.sbin/dhcp/dhclient/dhclient-script.8 index 9211a7e9e8f..180fc2f05f5 100644 --- a/usr.sbin/dhcp/dhclient/dhclient-script.8 +++ b/usr.sbin/dhcp/dhclient/dhclient-script.8 @@ -47,49 +47,12 @@ interface's final configuration once a lease has been acquired. If no lease is acquired, the script is used to test predefined leases, if 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. -.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 a new script or modify an existing one. In general, customizations specific to a particular computer should be done in the -.B ETCDIR/dhclient.conf -file. If you find that you can't make such a customization without -customizing -.B dhclient-script -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. -.PP -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 ETCDIR/dhclient-script -will exit with that error code immediately after the client script exits. -.PP -After all processing has completed, -.B ETCDIR/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 -is passed in the exit_status shell variable, and will always be zero if the -script succeeded at the task for which it was invoked. +.B /etc/dhclient.conf +file. .SH OPERATION When dhclient needs to invoke the client configuration script, it writes a shell script into /tmp which defines a variety of variables. |