dhcpd-options(5) | FreeBSD File Formats Manual | dhcpd-options(5) |
名称
dhcp-options - 動的ホスト構成プロトコルのオプション解説
動的ホスト設定プロトコル (DHCP: Dynamic Host Configuration Protocol) を使用することにより、クライアントは DHCP サーバから、ネットワーク設定やネットワーク上で利用可能な様々なサービスについて記述している オプション を受け取ることができます。 dhcpd(8) や dhclient(8) を設定するときに、オプションを宣言することが多いでしょう。オプションを宣言する文法、そして宣言可能なオプションの名前と書式を、ここに文書化しています。リファレンス: オプション文
常に DHCP option 文は、キーワード option で開始し、単一のオプション名が続き、オプションデータが続きます。オプションの名前とデータの書式は後述します。全 DHCP オプションを網羅的に指定する必要はありません。クライアントに必要なオプションのみを指定する必要があります。オプションデータには、次のように様々な書式があります:
ip-address データタイプは、明示的な IP アドレス (例えば 239.254.197.10) またはドメイン名 (例えば haagen.isc.org) のいずれかで指定可能です。ドメイン名で指定する場合、そのドメイン名を解決すると単一の IP アドレスになるようにしてください。
int32 データタイプは符号付き 32 ビット整数を指定します。 uint32 データタイプは符号無し 32 ビット整数を指定します。 int16 および uint16 のデータタイプは、符号付きおよび符号無しの 16 ビット整数を指定します。 int8 および uint8 のデータタイプは、符号付きおよび符号無しの 8 ビット整数を指定します。符号無し 8 ビット整数は、オクテットと呼ばれることもあります。
string データタイプは NVT ASCII 文字列を指定します。文字列はダブルクォートで括る必要があります。例えば domain-name オプションを指定する文法は
option domain-name "isc.org";
となります。
flag データタイプはブール値を指定します。ブール値は真または偽のいずれかです (オンまたはオフの方が分かりやすければ、こちらでもかまいません)。
data-string データタイプは、ダブルクォートで括られる NVT ASCII 文字列か、コロン区切りで 16 進数で指定されるオクテットの連続のいずれかを指定します。例えば次のようになります:
option dhcp-client-identifier "CLIENT-FOO";
または
option dhcp-client-identifier 43:4c:49:45:54:2d:46:4f:4f;
次に示す様々なオプションに関する記述は、 DHCP オプションに関する最新の IETF ドラフト文書のものです。名前が掲載されていないオプションは、 option- nnn という名前で定義されているかもしれません。 nnn はオプションコードの 10 進数表記です。これらのオプションには、クォートで括った文字列か、 2 桁の 16 進数をコロンで区切ったオクテットの連続を、続けられます。例えば次のようになります:
option option-133 "my-option-133-text";
option option-129 1:54:c9:2b:47;
dhcpd は、これらの未定義オプションコードの書式を知りませんので、指定されたデータの正当性を保証するための確認は行いません。
標準オプションを示します:
option subnet-mask ip-address;
サブネットマスクオプションは、 RFC 950 に従って、クライアントのサブネットマスクを指定します。スコープ中のどこにもサブネットマスクを指定しないと、最終手段として、アドレスを割り当てようとしているネットワークに対するサブネット宣言から、 dhcpd はサブネットマスクを使用します。これに対し、アドレスを割り当てようとしているネットワークのスコープ中のサブネットマスク宣言であれば どのようなものであっても 、サブネット宣言におけるサブネットマスク指定に優先します。
option time-offset int32;
time-offset オプションは、協定世界時 (UTC) を基点として、クライアントのサブネットのオフセットを秒で指定します。
option routers ip-address [ , ip-address... ] ;
routers オプションは、クライアントのサブネット上にあるルータの IP アドレスのリストを指定します。ルータは、優先されるものから順にリストしてください。
option time-servers ip-address [, ip-address... ] ;
time-server オプションは、クライアントが利用可能な RFC 868 時刻サーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option ien116-name-servers ip-address [ , ip-address... ];
ien116-name-servers オプションは、クライアントが利用可能な IEN 116 ネームサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option domain-name-servers ip-address [ , ip-address... ] ;
domain-name-servers は、クライアントが利用可能なドメインネームシステム (STD 13, RFC 1035) ネームサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option log-servers ip-address [ , ip-address... ] ;
log-server オプションは、クライアントが利用可能な MIT-LCS UDP ログサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option cookie-servers ip-address [ , ip-address... ] ;
クッキーサーバオプションは、クライアントが利用可能な RFC 865 クッキーサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option lpr-servers ip-address [ , ip-address... ] ;
LPR サーバオプションは、クライアントが利用可能な RFC 1179 ラインプリンタサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option impress-servers ip-address [ , ip-address... ] ;
impress-server オプションは、クライアントが利用可能な Imagen Impress サーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option resource-location-servers ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な RFC 887 リソースロケーションサーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option host-name string;
本オプションは、クライアントの名前を指定します。この名前は、ローカルのドメイン名に適合してもしなくてもかまいせん (domain-name オプションを使用してドメイン名を指定する方が良いです)。文字集合の制約については RFC 1035 を参照してください。クライアントマシンのホスト名が設定されていない場合 (すなわち rc.conf(5) で空文字列に設定されている場合)、 dhclient-script(8) のみが本オプションを尊重します。
option boot-size uint16;
本オプションは、クライアント用のデフォルトのブートイメージの長さを、 512 オクテットブロック数で指定します。
option merit-dump string;
本オプションは、クライアントがクラッシュするときにクライアントのコアイメージがダンプされるファイルのパス名を指定します。パスの書式は、NVT ASCII 文字集合の文字からなる文字列です。
option domain-name string;
本オプションは、ドメインネームシステムを使用してホスト名を解決するときにクライアントが使用すべきドメイン名を指定します。
option swap-server ip-address;
本オプションは、クライアントのスワップサーバの IP アドレスを指定します。
option root-path string;
本オプションは、クライアントのルートディスクが含まれるパス名を指定します。パスの書式は、NVT ASCII 文字集合の文字からなる文字列です。
option ip-forwarding flag;
本オプションは、パケットをフォワードするように、クライアントが自己の IP 層を設定すべきかを指定します。値 0 は IP フォワードを無効にし、値 1 は IP フォワードを有効にすることを意味します。
option non-local-source-routing flag;
本オプションは、非ローカルな送信元経路指定 (non-local source route) を持つデータグラムをフォワードするように、クライアントが自己の IP 層を設定すべきかを指定します (本項目については [4] の 3.3.5 節を参照してください)。値 0 はそのようなデータグラムのフォワードを許可しないことを意味し、値 1 はフォワード許可を意味します。
option policy-filter ip-address ip-address [ , ip-address ip-address... ] ;
本オプションは、非ローカルな送信元経路指定データグラムに対するポリシフィルタを指定します。フィルタは、IP アドレスとマスクの組のリストからなり、到着する送信元経路指定データグラム用のフィルタとなる、宛先/マスクの組を指定します。
次ホップアドレスがフィルタのいずれにも適合しない送信元経路指定データグラムは、クライアントが破棄すべきです。
更なる情報は STD 3 (RFC1122) を参照してください。
option max-dgram-reassembly uint16;
本オプションは、クライアントが再組み立て準備をすべき、最大データグラムサイズを指定します。最小の正当値は 576 です。
option default-ip-ttl uint8;
本オプションは、クライアントが出力するデータグラムに使用すべき、デフォルトの生存時間を指定します。
option path-mtu-aging-timeout uint32;
本オプションは、 RFC 1191 で定義される機構で発見されたパス MTU 値のエージングに使用するタイムアウト (秒単位) を指定します。
option path-mtu-plateau-table uint16 [ , uint16... ] ;
本オプションは、MTU サイズの表を指定します。この表は、 RFC 1191 で定義される、パス MTU 発見 (Path MTU Discovery) 実施時に使用します。表の書式は、最小から最大への順の、 16 ビット符号無し整数のリストです。最小 MTU は 68 以上であることが必要です。
option interface-mtu uint16;
本オプションは、このインタフェースに対して使用する MTU を指定します。 MTU に対する最小の正当値は 68 です。
option all-subnets-local flag;
本オプションは、クライアントが接続されている IP ネットワークの全サブネットが使用する MTU が、クライアントが直接接続されているサブネットの MTU と同じであると、クライアントが仮定して良いかを指定します。値 1 は、全サブネットは同一の MTU であることを意味します。値 0 は、直接接続されているネットワークのサブネットにはより小さな MTU を持つものがあると、クライアントが仮定すべきことを意味します。
option broadcast-address ip-address;
本オプションは、クライアントのサブネットで使用されているブロードキャストアドレスを指定します。正当なブロードキャストアドレスの値は、 STD 3 (RFC1122) の 3.2.1.3 節に記述されています。
option perform-mask-discovery flag;
本オプションは、クライアントが ICMP を使用してサブネットマスク発見を実施すべきかを指定します。値 0 は、クライアントはマスク発見を実施すべきでないことを意味します。値 1 は、クライアントはマスク発見を実施すべきであることを意味します。
option mask-supplier flag;
本オプションは、 ICMP を使用したサブネットマスク要求に対して、クライアントが応答すべきかを指定します。値 0 は、クライアントが応答すべきでないことを意味します。値 1 は、クライアントが応答すべきであることを意味します。
option router-discovery flag;
本オプションは、 RFC 1256 で定義されるルータ発見 (Router Discovery) 機構を使用してルータを請求すべきかを指定します。値 0 は、クライアントはルータ発見を実施すべきでないことを意味します。値 1 は、クライアントはルータ発見を実施すべきであることを意味します。
option router-solicitation-address ip-address;
本オプションは、クライアントのルータ請求リクエスト送出先アドレスを指定します。
option static-routes ip-address ip-address [ , ip-address ip-address... ] ;
本オプションは、クライアントが経路キャッシュに組み込むべき静的ルータのリストを指定します。同じ宛先に対して複数のルータを指定すると、優先度が低くなる順序でリストされます。
経路は IP アドレスの組のリストからなります。最初のアドレスは宛先アドレスであり、 2 番目のアドレスは宛先に対するルータのアドレスです。
デフォルト経路 (0.0.0.0) は、静的経路に対しては不正な宛先です。デフォルト経路を指定するには、 routers オプションを使用してください。
option trailer-encapsulation flag;
本オプションは、 ARP プロトコル使用時に、クライアントがトレイラ使用ネゴシエート (RFC 893 [14]) すべきかを指定します。値 0 は、クライアントがトレイラ使用を試みるべきでないと意味します。値 1 は、クライアントがトレイラ使用を試みるべきであると意味します。
option arp-cache-timeout uint32;
本オプションは、ARP キャッシュエントリのタイムアウトを秒単位で指定します。
option ieee802-3-encapsulation flag;
本オプションは、インタフェースがイーサネットである場合に、クライアントがイーサネットバージョン 2 (RFC 894) か、 IEEE 802.3 (RFC 1042) のカプセル化を使用すべきかを指定します。値 0 は、クライアントは RFC 894 のカプセル化を使用すべきであると意味します。値 1 は、クライアントは RFC 1042 のカプセル化を使用すべきであると意味します。
option default-tcp-ttl uint8;
本オプションは、クライアントが TCP セグメントを送出するときに使用すべき、デフォルトの TTL を指定します。最小値は 1 です。
option tcp-keepalive-interval uint32;
本オプションは、クライアントの TCP がキープアライブ (keepalive) メッセージを TCP 接続上に送信する前に待つべき間隔 (秒単位) を指定します。時間は 32 ビット符号無し整数で指定します。値 0 は、アプリケーションが明示的に要求しなければ、クライアントが接続上にキープアライブメッセージを生成すべきでないことを意味します。
option tcp-keepalive-garbage flag;
本オプションは、古い実装との互換性のために、ゴミのオクテットと一緒に、 TCP キープアライブメッセージをクライアントが送るべきかを指定します。値 0 は、ゴミのオクテットを送るべきでないことを意味します。値 1 は、ゴミのオクテットを送るべきであることを意味します。
option nis-domain string;
本オプションは、クライアントの NIS (Sun Network Information Services) ドメインを指定します。ドメインの書式は、NVT ASCII 文字集合の文字からなる文字列です。
option nis-servers ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な NIS サーバの IP アドレスを指定します。サーバは、優先されるものから順にリストしてください。
option ntp-servers ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な NTP (RFC 1035) サーバの IP アドレスを指定します。サーバは、優先されるものから順にリストしてください。
option netbios-name-servers ip-address [ , ip-address... ] ;
NetBIOS ネームサーバ (NBNS) オプションは、 RFC 1001/1002 の NBNS ネームサーバのリストを、優先されるものから順に指定します。現在では、NetBIOS Name Service は WINS と呼ばれることの方が多いです。 netbios-name-servers オプションを使用して、WINS サーバを指定可能です。
option netbios-dd-server ip-address [ , ip-address... ] ;
NetBIOS データグラム配布サーバ (NBDD) オプションは、 RFC 1001/1002 の NBDD サーバのリストを、優先されるものから順に指定します。
option netbios-node-type uint8;
NetBIOS ノードタイプオプションは、設定可能な NetBIOS オーバ TCP/IP クライアントを、 RFC 1001/1002 に記述されているように設定します。値は単一のオクテットとして指定され、クライアントタイプを意味します。
使用可能なノードタイプは次の通りです:
- 1
- B ノード: ブロードキャスト - WINS 無し
- 2
- P ノード: ピア - WINS のみ
- 4
- M ノード: ミックス - ブロードキャスト後に WINS
- 8
- H ノード: ハイブリッド - WINS 後にブロードキャスト
option netbios-scope string ;
NetBIOS スコープオプションは、 RFC 1001/1002 に指定されるように、クライアントの NetBIOS オーバ TCP/IP スコープパラメータを指定します。文字集合の制約については RFC1001, RFC1002, RFC1035 を参照してください。
option font-servers ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な X Window System フォントサーバを指定します。サーバは、優先されるものから順にリストしてください。
option x-display-manager ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な X Window System Display Manager を実行しているシステムのリストを指定します。アドレスは、優先されるものから順にリストしてください。
option dhcp-client-identifier data-string;
本オプションを使って、ホスト宣言中で DHCP クライアント識別子を指定することができます。これは、クライアント識別子に対する照合を用いて、dhcpd がそのホストのレコードを発見できるようにするためのものです。
option nisplus-domain string;
本オプションは、クライアントの NIS+ ドメインの名前を指定します。ドメインの書式は、NVT ASCII 文字集合の文字からなる文字列です。
option nisplus-servers ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能な NIS+ サーバを示す IP アドレスのリストを指定します。サーバは、優先されるものから順にリストしてください。
option tftp-server-name string;
本オプションは TFTP サーバを指定し、クライアントがサポートする場合には server-name 宣言と同じ効果を持ちます。 BOOTP クライアントは、本オプションをサポートしないでしょう。 DHCP クライアントによってはサポートしているものがあり、実際必須としているものがあります。
option bootfile-name string;
本オプションは、ブートストラップファイルを指定するために使用します。クライアントにサポートされている場合、 filename 宣言と同じ効果を持ちます。 DHCP クライアントによってはサポートするものがあり、実際必須としているものがあります。
option mobile-ip-home-agent ip-address [ , ip-address... ] ;
本オプションは、クライアントが利用可能なモバイル IP ホームエージェントの IP アドレスのリストを指定します。エージェントは、優先されるものから順にリストしてください。ただし、通常はエージェントは 1 つでしょう。
option smtp-server ip-address [ , ip-address... ] ;
SMTP サーバオプションは、クライアントが利用可能な SMTP サーバのリストを指定します。サーバは、優先されるものから順にリストしてください。
option pop-server ip-address [ , ip-address... ] ;
POP3 サーバオプションは、クライアントが利用可能な POP3 のリストを指定します。サーバは、優先されるものから順にリストしてください。
option nntp-server ip-address [ , ip-address... ] ;
NNTP サーバオプションは、クライアントが利用可能な NNTP のリストを指定します。サーバは、優先されるものから順にリストしてください。
option www-server ip-address [ , ip-address... ] ;
WWW サーバオプションは、クライアントが利用可能な WWW のリストを指定します。サーバは、優先されるものから順にリストしてください。
option finger-server ip-address [ , ip-address... ] ;
Finger サーバオプションは、クライアントが利用可能な Finger のリストを指定します。サーバは、優先されるものから順にリストしてください。
option irc-server ip-address [ , ip-address... ] ;
IRC サーバオプションは、クライアントが利用可能な IRC のリストを指定します。サーバは、優先されるものから順にリストしてください。
option streettalk-server ip-address [ , ip-address... ] ;
StreetTalk サーバオプションは、クライアントが利用可能な StreetTalk のリストを指定します。サーバは、優先されるものから順にリストしてください。
option streetalk-directory-assistance-server ip-address [ , ip-address... ] ;
StreetTalk Directory Assistance (STDA) サーバオプションは、クライアントが利用可能な STDA のリストを指定します。サーバは、優先されるものから順にリストしてください。