Annotation of embedaddon/dhcp/doc/ja_JP.eucJP/dhcp-eval.5, revision 1.1.1.1
1.1.1.1 ! misho 1: .\" $Id: dhcp-eval.5,v 1.3.456.2 2009/07/24 22:04:52 sar Exp $
1.1 misho 2: .\"
3: .\" Copyright (c) 2004,2009 by Internet Systems Consortium, Inc. ("ISC")
4: .\" Copyright (c) 1996-2003 by Internet Software Consortium
5: .\"
6: .\" Permission to use, copy, modify, and distribute this software for any
7: .\" purpose with or without fee is hereby granted, provided that the above
8: .\" copyright notice and this permission notice appear in all copies.
9: .\"
10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
16: .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17: .\"
18: .\" Internet Systems Consortium, Inc.
19: .\" 950 Charter Street
20: .\" Redwood City, CA 94063
21: .\" <info@isc.org>
22: .\" https://www.isc.org/
23: .\"
24: .\" This software has been written for Internet Systems Consortium
25: .\" by Ted Lemon in cooperation with Vixie Enterprises and Nominum, Inc.
26: .\" To learn more about Internet Systems Consortium, see
27: .\" ``https://www.isc.org/''. To learn more about Vixie Enterprises,
28: .\" see ``http://www.vix.com''. To learn more about Nominum, Inc., see
29: .\" ``http://www.nominum.com''.
30: .\" $FreeBSD: doc/ja_JP.eucJP/man/man5/dhcp-eval.5,v 1.2 2002/05/23 04:17:13 horikawa Exp $
31: .TH dhcp-eval 5
32: .SH 名称
33: dhcp-eval - ISC DHCP における条件付き評価
34: .SH 解説
35: Internet Systems Consortium の DHCP クライアントとサーバは、どちらも
36: 受信するパケットに依存した条件付き動作を行う能力を持ちます。
37: 条件付き動作の文法をここに示します。
38: .SH 参照: 条件付き動作
39: 条件付き動作は、if, else, elsif 文を使用して指定します。
40: 条件文は、通常文 (option 文) が登場可能な場所はどこにでも登場可能であり、
41: またこのような文を括ることも可能です。
42: サーバにおける条件文は次のようになることが多いでしょう:
43: .PP
44: .nf
45: if option dhcp-user-class = "accounting" {
46: max-lease-time 17600;
47: option domain-name "accounting.example.org";
48: option domain-name-servers ns1.accounting.example.org,
49: ns2.accounting.example.org;
50: } elsif option dhcp-user-class = "sales" {
51: max-lease-time 17600;
52: option domain-name "sales.example.org";
53: option domain-name-servers ns1.sales.example.org,
54: ns2.sales.example.org;
55: } elsif option dhcp-user-class = "engineering" {
56: max-lease-time 17600;
57: option domain-name "engineering.example.org";
58: option domain-name-servers ns1.engineering.example.org,
59: ns2.engineering.example.org;
60: } else {
61: max-lease-time 600;
62: option domain-name "misc.example.org";
63: option domain-name-servers ns1.misc.example.org,
64: ns2.misc.example.org;
65: }
66: .fi
67: .PP
68: クライアント側では、条件付き評価の例は次のようになるでしょう:
69: .PP
70: .nf
71: # example.org はファイヤウォールで DNS をフィルタするので、
72: # example.org ネットワークに繋がるときのみ、その DNS サーバを使用します。
73: # example.org に繋がるのではない場合、自己の DNS サーバを優先使用します。
74: if not option domain-name = "example.org" {
75: prepend domain-name-servers 127.0.0.1;
76: }
77: .fi
78: .PP
79: .B if
80: 文と
81: .B elsif
82: 継続文は、引数としてブール式を取ります。
83: つまり、これらの文は、評価されるとブール値の結果を生成する式を取ります。
84: 式の評価結果が真になると、
85: .B if
86: 文の直後のブレースで括られた文が実行され、後続する
87: .B elsif
88: と
89: .B else
90: の節はスキップされます。
91: そうでない場合、評価結果が真になる elsif 節に出会うまで、後続する各
92: .B elsif
93: 節の式がチェックされます。
94: そのような節が見付かると、直後のブレース中の文が実行され、後続する
95: .B elsif
96: と
97: .B else
98: の節はスキップされます。
99: すべての
100: .B if
101: および
102: .B elsif
103: の節がチェックされたもののどの式も真にならない場合で、
104: .B else
105: 節が存在する場合、
106: .B else
107: の直後のブレース中の文が評価されます。
108: 条件においては、評価結果が空になるブール式は偽として扱われます。
109: .SH ブール式
110: 以下は、DHCP 配布物で現在サポートされているブール式の一覧です。
111: .PP
112: .I data-expression-1 \fB=\fI data-expression-2\fR
113: .RS 0.25i
114: .PP
115: \fB=\fR オペレータは、2 個のデータ式を比較し、両者が同じ場合は真を返し、
116: 同一でない場合は偽を返します。
117: 左辺もしくは右辺のいずれかが空の場合、結果は空になります。
118: .RE
119: .PP
120: .I boolean-expression-1 \fBand\fI boolean-expression-2\fR
121: .PP
122: .RS 0.25i
123: \fBand\fR オペレータは、左辺のブール式と右辺のブール式の両方の評価結果が
124: 真の場合、真と評価されます。
125: そうでない場合、偽と評価されます。
126: 左辺もしくは右辺のいずれかが空の場合、結果は空になります。
127: .RE
128: .PP
129: .I boolean-expression-1 \fBor\fI boolean-expression-2\fR
130: .PP
131: .RS 0.25i
132: \fBor\fR オペレータは、左辺のブール式と右辺のブール式のいずれかの評価結果が
133: 真の場合、真と評価されます。
134: そうでない場合、偽と評価されます。
135: 左辺もしくは右辺のいずれかが空の場合、結果は空になります。
136: .RE
137: .PP
138: .B not \fIboolean-expression
139: .PP
140: .RS 0.25i
141: \fBnot\fR オペレータは、\fIboolean-expression\fR の評価結果が偽の場合、
142: 真と評価されます。
143: また、\fIboolean-expression\fR の評価結果が真の場合、偽と評価されます。
144: \fIboolean-expression\fR の評価結果が空の場合、結果もまた空になります。
145: .RE
146: .PP
147: .B exists \fIoption-name\fR
148: .PP
149: .RS 0.25i
150: \fBexists\fR 式は、処理対象の入力 DCHP パケット中に、
151: 指定されたオプションが存在する場合、真を返します。
152: .RE
153: .B known
154: .PP
155: .RS 0.25i
156: \fBknown\fR 式は、要求対応中のクライアントが既知の場合、
157: すなわちホスト宣言がある場合、真を返します。
158: .RE
159: .B static
160: .PP
161: .RS 0.25i
162: \fBstatic\fR 式は、要求対応中のクライアントへのリース割り当てが、
163: 静的アドレス割り当てによるものであった場合、真を返します。
164: .RE
165: .SH データ式
166: 前述のブール式は、データ式の評価結果に依存します。
167: データ式をここに示します。
168: .PP
169: .B substring (\fIdata-expr\fB, \fIoffset\fB, \fIlength\fB)\fR
170: .PP
171: .RS 0.25i
172: \fBsubstring\fR オペレータは、データ式を評価し、
173: 評価結果中の \fIoffset\fR バイトから開始して \fIlength\fR バイト継続する
174: サブストリングを返します。
175: \fIoffset\fR と \fIlength\fR は共に数値式です。
176: \fIdata-expr\fR, \fIoffset\fR, \fIlength\fR のいずれかが空と評価される場合、
177: 結果もまた空になります。
178: \fIoffset\fR が、評価されたデータの長さ以上である場合、
179: 長さ 0 のデータ文字列が返されます。
180: \fIlength\fI が、評価されたデータの \fIoffset\fR より後の長さより大きい場合、
181: 評価されたデータの \fIoffset\fR から終端までの全データを含む
182: データ文字列が返されます。
183: .RE
184: .PP
185: .B suffix (\fIdata-expr\fB, \fIlength\fB)\fR
186: .PP
187: .RS 0.25i
188: \fBsuffix\fR オペレータは、\fIdata-expr\fR を評価し、
189: 評価結果の最後の \fIlength\fR バイトを返します。
190: \fIlength\fR は数値式です。
191: \fIdata-expr\fR または \fIlength\fR の評価結果が空の場合、
192: 結果もまた空になります。
193: \fIsuffix\fR
194: (訳注: \fIlength\fR が正しいと思われます)
195: の評価結果が評価されたデータの長さより大きい場合、
196: 評価されたデータが返されます。
197: .\" horikawa@jp.FreeBSD.org 2002/04/29
198: .RE
199: .PP
200: .B option \fIoption-name\fR
201: .PP
202: .RS 0.25i
203: \fBoption\fR オペレータは、サーバが応答処理中のパケットの中の、
204: 指定したオプションの内容を返します。
205: .RE
206: .PP
207: .B config-option \fIoption-name\fR
208: .PP
209: .RS 0.25i
210: \fBconfig-option\fR オペレータは、指定したオプションに対し、
211: DHCP クライアントまたはサーバが送出するよう設定された値を返します。
212: .RE
213: .PP
214: .B hardware
215: .PP
216: .RS 0.25i
217: \fBhardware\fR オペレータは、データストリングを返します。
218: データストリングの最初の要素は、
219: 対象パケットが示すネットワークインタフェースのタイプであり、
220: 後続する要素は、クライアントのリンク層アドレスです。
221: パケットが存在しない場合もしくは RFC2131 \fIhlen\fR フィールドが無効な場合、
222: 結果は空になります。
223: ハードウェアタイプには、イーサネット (1)、トークンリング (6)、
224: FDDI (8) が含まれます。
225: ハードウェアタイプは IETF によって規定され、
226: どのようにタイプの数値が定義されるかの詳細は RFC2131
227: (ISC DHCP 配布物では、doc/ サブディレクトリにあります) を参照してください。
228: .RE
229: .PP
230: .B packet (\fIoffset\fB, \fIlength\fB)\fR
231: .PP
232: .RS 0.25i
233: \fBpacket\fR オペレータは、対象パケットの指定部分を返すか、
234: 対象パケットが無い文脈では空を返します。
235: \fIoffset\fR と \fIlength\fR は、
236: \fBsubstring\fR オペレータと同様に、パケットの内容に適用されます。
237: .RE
238: .PP
239: .I string
240: .PP
241: .RS 0.25i
242: クォートで括られたストリングはデータ式として指定可能であり、
243: クォートの間を ASCII エンコードしたのテキストを返します。
244: バックスラッシュ ('\\') 文字は C プログラムのように特別扱いされます:
245: すなわち '\\t' はタブを、'\\r' は復改を、'\\n' は改行を、'\\b' はベルを
246: 意味します。
247: 8 進数値は '\\nnn' で指定可能であり、nnn は 0 以上 0377 以下の 8 進数値です。
248: 16 進数値は '\\xnn' で指定可能であり、nn は 0 以上 0xff 以下の 16 進数値です。
249: .\" 値の範囲の誤りについては、Murray 経由でレポート済
250: .\" horikawa@jp.FreeBSD.org 2002/05/01
251: .RE
252: .PP
253: .I colon-separated hexadecimal list
254: .PP
255: .RS 0.25i
256: コロンで区切られた 16 進数のオクテット値のリストを、
257: データ式として指定可能です。
258: .RE
259: .PP
260: .B concat (\fIdata-expr1\fB, ..., \fIdata-exprN\fB)\fR
261: .RS 0.25i
262: 式が評価され、各評価結果がサブ式の順番に連結されます。
263: サブ式のいずれかの評価結果が空になる場合、連結の結果は空になります。
264: .RE
265: .PP
266: .B reverse (\fInumeric-expr1\fB, \fIdata-expr2\fB)\fR
267: .RS 0.25i
268: 2 個の式が評価され、データ式の評価結果がその場で反転されます。
269: 反転は、数値式で指定される大きさの単位で行われます。
270: 例えば、数値式の評価結果が 4 の場合で、
271: データ式の評価結果が 12 バイトになる場合、
272: reverse 式の評価結果は、次のような 12 バイトのデータになります。
273: すなわち、入力の最後の 4 バイト、真中の 4バイト、最初の 4 バイトの
274: 順になります。
275: .RE
276: .PP
277: .B leased-address
278: .RS 0.25i
279: いかなる文脈においても、
280: 要求処理対象となっているクライアントに IP アドレスが割り当て済の場合、
281: その IP アドレスが返されます。
282: .RE
283: .PP
284: .B binary-to-ascii (\fInumeric-expr1\fB, \fInumeric-expr2\fB,
285: .B \fIdata-expr1\fB,\fR \fIdata-expr2\fB)\fR
286: .RS 0.25i
287: data-expr2 の評価結果をテキストストリングに変換します。
288: このテキストストリング中では、
289: data-expr2 の評価結果の各要素が、1 個の数値になります。
290: 各数値は、それぞれ、data-expr1 の評価結果によって区切られます。
291: numeric-expr1 の評価結果は、基数 (2 から 16) であり、
292: この基数に数値が変換されます。
293: numeric-expr2 の評価結果は、各数値のビット幅であり、
294: 8, 16, 32 のいずれかです。
295: .PP
296: 最初の 3 個のタイプの式の例として、
297: クライアントに割り当てられた IP アドレス用の
298: PTR レコードの名前を生成するために使用可能な式を示します
299: .RE
300: .PP
301: .nf
302: concat (binary-to-ascii (10, 8, ".",
303: reverse (1, leased-address)),
304: ".in-addr.arpa.");
305:
306: .fi
307: .PP
308: .B encode-int (\fInumeric-expr\fB, \fIwidth\fB)\fR
309: .RS 0.25i
310: 数値式が評価され、指定された幅のデータストリングに
311: ネットワークバイト順 (最上位バイトが最初) でエンコードされます。
312: 数値式の評価結果が空の値になる場合、結果もまた空です。
313: .RE
314: .\" この ".RE" が無いと、インデントが正しくないです
315: .\" horikawa@jp.FreeBSD.org 2002/04/29
316: .PP
317: .B pick-first-value (\fIdata-expr1\fR [ ... \fIexpr\fRn ] \fB)\fR
318: .RS 0.25i
319: pick-first-value 関数は、任意個のデータ式を取り得ます。
320: リストの先頭から各式が評価され、
321: 評価結果が空ではない式が見付かるまでこれが続きます。
322: この式が返され、この式に後続する式は評価されません。
323: すべての式の評価結果が空の場合、空の値が返されます。
324: .RE
325: .PP
326: .B host-decl-name
327: .RS 0.25i
328: host-decl-name 関数は、現在要求処理対象となっているクライアントにマッチする、
329: ホスト宣言の名前を返します。
330: どのホスト宣言もマッチしない場合、結果は空になります。
331: .RE
332: .SH 数値式
333: 数値式は、評価結果が整数になる式です。
334: 一般に、整数の最大サイズが 32 ビット未満であると仮定すべきではありませんが、
335: 整数の精度が 32 ビットを越えることはあり得ます。
336: .PP
337: .B extract-int (\fIdata-expr\fB, \fIwidth\fB)\fR
338: .PP
339: .RS 0.25i
340: \fBextract-int\fR オペレータは、ネットワークバイト順の整数を、
341: 指定したデータ式の評価結果から取り出します。
342: 幅は、取り出す整数のビット幅です。
343: 現在、サポートされている幅は 8, 16, 32 のいずれかです。
344: データ式の評価結果が、指定した大きさの整数と取り出すのに
345: 十分なビットを提供しない場合、空の値が返されます。
346: .RE
347: .PP
348: .B lease-time
349: .PP
350: .RS 0.25i
351: 現在のリースの期間です。
352: すなわち、現在の時刻とリースの期限が切れる時刻との差です。
353: .RE
354: .PP
355: .I number
356: .PP
357: .RS 0.25i
358: 0 から表現可能な最大サイズの範囲の任意の数値を、数値式として指定可能です。
359: .RE
360: .PP
361: .B client-state
362: .PP
363: .RS 0.25i
364: 処理対象のクライアントの現在の状態です。
365: DHCP クライアント設定ファイルにおいてのみ有用です。
366: 取り得る値は次の通りです:
367: .TP 2
368: .I \(bu
369: Booting - DHCP クライアントは INIT 状態であり、
370: IP アドレスをまだ持ちません。
371: 次に送信されるメッセージは DHCPDISCOVER であり、
372: これはブロードキャストされます。
373: .TP
374: .I \(bu
375: Reboot - DHCP クライアントは INIT-REBOOT 状態です。
376: IP アドレスを持ちますがまだ使用していません。
377: 次に送信されるメッセージは DHCPREQUEST であり、
378: これはブロードキャストされます。
379: 応答が何も聞こえないと、クライアントはこのアドレスにバインドし、
380: BOUND 状態に遷移します。
381: .TP
382: .I \(bu
383: Select - DHCP クライアントは SELECTING 状態です。
384: 少なくとも 1 個の DHCPOFFER メッセージは受信しましたが、
385: 他の DHCPOFFER メッセージを他のサーバから受け取るかどうか待っています。
386: SELECTING 状態ではメッセージは送信されません。
387: .TP
388: .I \(bu
389: Request - DHCP クライアントは REQUESTING 状態です。
390: 少なくとも 1 個の DHCPOFFER メッセージを受信し、
391: そのうちのどれを要求するか選択しました。
392: 次に送信されるメッセージは DHCPREQUEST メッセージであり、
393: これはブロードキャストされます。
394: .TP
395: .I \(bu
396: Bound - DHCP クライアントは BOUND 状態です。
397: IP アドレスを所有しています。
398: この状態ではメッセージは送信されません。
399: .TP
400: .I \(bu
401: Renew - DHCP クライアントは RENEWING 状態です。
402: IP アドレスを所有しており、これを更新するためにサーバに接続を試みています。
403: 次に送信されるメッセージは DHCPREQUEST メッセージであり、
404: これはサーバに直接ユニキャストされます。
405: .TP
406: .I \(bu
407: Rebind - DHCP クライアントは REBINDING 状態です。
408: IP アドレスを所有しており、
409: これを更新するために任意のサーバに接続を試みています。
410: 次に送信されるメッセージは DHCPREQUEST メッセージであり、
411: これはブロードキャストされます。
412: .RE
413: .SH 参照: ログ
414: ログ文を使用して、標準ログチャネルに情報を送信可能です。
415: ログ文は、省略可能な priority
416: (\fBfatal\fR, \fBerror\fR, \fBinfo\fR, \fBdebug\fR のいずれか) と、
417: データ式を取ります。
418: .PP
419: .B log (\fIpriority\fB, \fIdata-expr\fB)\fR
420: .\" "\FB" は "\fB" が正しい
421: .\" horikawa@jp.FreeBSD.org 2002/04/29
422: .PP
423: ログ文は、単一のデータ式引数のみ取ります。
424: 複数のデータ値を出力したい場合、
425: \fBconcat\fR オペレータを使用してそれらを連結する必要があります。
426: .RE
427: .SH 参照: 動的な DNS 更新
428: .PP
429: DHCP クライアントとサーバは、
430: 動的にドメインネームシステムを更新する能力があります。
431: 設定ファイル中に、どのようにドメインネームシステムを更新して欲しいか、
432: 定義可能です。
433: 更新は RFC 2136 に従っているため、
434: RFC 2136 をサポートする DNS サーバは、
435: DHCP サーバからの更新を受け付け可能と思われます。
436: .SH セキュリティ
437: TSIG および DNSSEC はまだサポートされていません。
438: DHCP サーバまたはクライアントからの更新を受け付けるように
439: DNS サーバを設定する場合、権限の無い更新に対して
440: DNS サーバを晒すことになるかもしれません。
441: これを避けるために今すぐできる最良の方法は、
442: IP アドレスベースのパケットフィルタを使用して、
443: 権限の無いホストからの更新要求発行を抑止することです。
444: 明らかに、現状ではクライアントの更新に対するセキュリティを提供する方法は
445: ありません。
446: このためには TSIG か DNSSEC が必要ですが、
447: この DHCP 配布物にはまだ含まれていません。
448: .PP
449: 動的 DNS (DDNS) 更新は、\fBdns-update\fR 式を使用することで実行されます。
450: \fBdns-update\fR 式は、ブール式であり、4 個のパラメータを取ります。
451: 更新に成功すると、結果は真になります。
452: 失敗すると、結果は偽になります。
453: 4 個のパラメータは、リソースレコードタイプ (RR)、
454: RR の左辺、RR の右辺、レコードに適用されるべき ttl です。
455: この関数の最も簡単な使用例は、dhcpd.conf ファイルの参照節にあり、
456: なにが起きるか記述されています。
457: この例では、複数の式が使用されて、
458: \fBdns-update\fR 用の引数が作成されています。
459: .PP
460: 例の中では、最初の \fBdns-update\fR 式への 1 番目の引数は、
461: A RR タイプに評価されるデータ式です。
462: 2 番目の引数は、DHCP host-name オプションと
463: ローカルドメイン、この場合 "ssd.example.net"、
464: を含むテキストストリングを連結することで、構築されます。
465: 3 番目の引数は、クライアントに割り当てられたアドレスを、
466: 32 ビットの数値から各バイトを "." で区切った ASCII 文字列に変換することで、
467: 構築されます。
468: 4 番目の引数 TTL は、リースの残り時間です
469: (これは本当は正しくありません。
470: なぜなら DNS サーバは、要求に対していつもこの TTL 値を出力してしまうからです。
471: これは、リース期限切れの数秒前であってもです)。
472: .PP
473: 最初の \fBdns-update\fR 文が成功すると、
474: 引き続いて 2 番目の更新により PTR RR がインストールされます。
475: PTR レコードのインストールは、A RR のインストールと同様ですが、
476: レコードの左辺はリースされたアドレスを逆にして ".in-addr.arpa" と
477: 結合されたものです。
478: 右辺は、アドレスのリース提供先クライアントの、完全な形でのドメイン名です。
479: .SH 関連項目
480: dhcpd.conf(5), dhcpd.leases(5), dhclient.conf(5), dhcp-eval(5), dhcpd(8),
481: dhclient(8), RFC2132, RFC2131
482: .SH 作者
483: Internet Systems Consortium DHCP Distribution
484: は、Vixie Labs との契約のもとで、Ted Lemon が記述しました。
485: 本プロジェクトの資金は、Internet Systems Consortium が提供しました。
486: Internet Systems Consortium に関する情報は、
487: .B https://www.isc.org
488: にあります。
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>