Diff from rev 1.5.2.3 to rev 1.5.2.4

Submitted by:	mistral@imasy.or.jp (Yoshihiko SARUMARU)
This commit is contained in:
Kazuo Horikawa 2002-05-08 03:27:27 +00:00
parent 2dfe4b2ed4
commit 90b5eaace0
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=13000

View file

@ -1,8 +1,6 @@
.\" dhclient-script.8
.\"
.\" Copyright (c) 1997 The Internet Software Consortium.
.\" All rights reserved.
.\"
.\" Copyright (c) 1996-2001 Internet Software Consortium.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@ -31,13 +29,13 @@
.\" SUCH DAMAGE.
.\"
.\" This software has been written for the Internet Software Consortium
.\" by Ted Lemon <mellon@fugue.com> in cooperation with Vixie
.\" Enterprises. To learn more about the Internet Software Consortium,
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\" by Ted Lemon in cooperation with Vixie Enterprises and Nominum, Inc.
.\" To learn more about the Internet Software Consortium, see
.\" ``http://www.isc.org/''. To learn more about Vixie Enterprises,
.\" see ``http://www.vix.com''. To learn more about Nominum, Inc., see
.\" ``http://www.nominum.com''.
.\"
.\"
.\" %FreeBSD: src/contrib/isc-dhcp/client/dhclient-script.8,v 1.5.2.3 2002/01/23 21:57:01 keramida Exp %
.\" %FreeBSD: src/contrib/isc-dhcp/client/dhclient-script.8,v 1.5.2.4 2002/04/11 10:16:45 murray Exp %
.\"
.\" $FreeBSD$
.TH dhclient-script 8
@ -95,22 +93,29 @@ make_resolv_conf
スクリプト実行中にエラーが発生した場合、
exit_status 変数を非 0 値に設定することが可能であり、
クライアントスクリプト終了直後に
.B /etc/dhclient-script
.B /sbin/dhclient-script
はそのエラーコードで終了します。
.PP
すべての処理の完了後に、
.B /etc/dhclient-script
.B /sbin/dhclient-script
は実行可能な
.B /etc/dhclient-exit-hooks
スクリプトの存在を検査し、存在する場合には '.' コマンドでこれを起動します。
終了状態は exit_status シェル変数に渡され、
dhclient-script の
終了状態は dhclient-exit-hooks の exit_status シェル変数に渡され、
起動された仕事にスクリプトが成功した場合には値は常に 0 になります。
dhclient-enter-hooks の項で前述したその他の環境も引き継がれます。
.B /etc/dhclient-exit-hooks
は exit_status に手を加えて
dhclient-script の戻り値を変更できます。
.SH 操作
dhclient がクライアント設定スクリプトを起動する必要があるとき、
様々な変数を定義するシェルスクリプトを /tmp に書き込みます。
様々な変数を環境に定義してから
.B /sbin/dhclient-script
を起動します。
すべての場合において、$reason にはスクリプトが起動される理由名が設定されます。
次の理由が現在定義されています:
MEDIUM, PREINIT, ARPCHECK, ARPSEND, BOUND, RENEW, REBIND, REBOOT,
MEDIUM, PREINIT, BOUND, RENEW, REBIND, REBOOT,
EXPIRE, FAIL, TIMEOUT。
.PP
.SH MEDIUM
@ -132,20 +137,6 @@ IP
このアドレスが $alias_ip_address で渡されます。
本 IP アドレスへの経路とともに、
本 IP アドレスを対象インタフェースから削除する必要があります。
.SH ARPSEND
DHCP クライアントは、
与えられたアドレスを他の誰かが使用しているか確認する目的で、
本アドレスの ARP 要求の送信を求めています。
実装方法は明確ではありませんので、例はまだありません。
確認対象の IP アドレスは $new_ip_address で渡され、
インタフェース名は $interface で渡されます。
.SH ARPCHECK
DHCP クライアントは、
ARPSEND を使用した ARP 要求の送信に対する応答の有無を、知りたがっています。
応答があった場合、スクリプトは非 0 の状態で終了することにより、
提供されたアドレスは既に要求されているものであり、
拒否されるべきであることを示します。
$new_ip_address および $interface は、ARPSEND と同様に設定されます。
.SH BOUND
DHCP クライアントは、新アドレスへの初期の結合を完了しました。
新しい IP アドレスは $new_ip_address で渡され、
@ -158,6 +149,13 @@ DHCP
変数名は new_ で開始します。
例えば、新しいサブネットマスクは $new_subnet_mask で渡されます。
.PP
アドレスを実際に設定する前に、dhclient-script は何らかの方法で
そのアドレスに対して ARP を行い、返事を受け取った場合には非 0 の値で
終了するべきです。この場合クライアントは DHCPDECLINE メッセージをサーバ
に送信し、違うアドレスを取得します。
この作業は RENEW, REBIND, REBOOT 状態でも同様に行いますが、
必ずしも必要ではなく、実際好ましくないでしょう。
.PP
結合が完了すると、
ネットワークに関する多くのパラメータを設定する必要があるでしょう。
$new_domain_name および $new_domain_name_servers
@ -237,14 +235,14 @@ client/scripts
どちらのサーバから提供される情報も有効である場合には、
実際上問題とはならないものの、混乱のもとになりえます。
.SH 関連項目
dhclient.conf(5), dhclient.leases(5), dhclient(8), dhcpd(8), dhcrelay(8)
dhclient.conf(5), dhclient.leases(5), dhclient(8)
.SH 作者
.B dhclient-script(8)
は Ted Lemon <mellon@fugue.com>
は Ted Lemon が
Vixie Enterprises と協力して Internet Software Consortium のために
書きました。
Internet Software Consortium についてより詳しくは、
.B http://www.vix.com/isc
.B http://www.isc.org
をご覧ください。
Vixie Enterprises についてより詳しくは、
.B http://www.vix.com