OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man5 / resolv.conf.5
index 490558f..a302b39 100644 (file)
 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 .\"
 .\"    @(#)resolver.5  5.9 (Berkeley) 12/14/89
-.\"    $Id$
+.\"    $Id: resolver.5,v 8.6 1999/05/21 00:01:02 vixie Exp $
 .\"
 .\" Added ndots remark by Bernhard R. Link - debian bug #182886
 .\"
-.\" Japanese Version Copyright (c) 2000, 2005 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated 2000-09-15, Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
-.\" Updated & Modified 2005-01-22, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2010-04-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.24
+.\"*******************************************************************
 .\"
-.\"WORD:       resolver        レゾルバ
-.\"WORD:       query           問い合わせ
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH RESOLV.CONF 5 2009-03-01 "" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH RESOLV.CONF 5 2012\-02\-08 "" "Linux Programmer's Manual"
 .UC 4
 .SH 名前
 resolv.conf \- レゾルバ設定ファイル
 .SH 書式
-.B /etc/resolv.conf
+\fB/etc/resolv.conf\fP
 .SH 説明
-.I resolver
-は、インターネットのドメインネームシステム (DNS) へのアクセスを提供する
-C ライブラリのルーチン群である。
-レゾルバ設定ファイルには、レゾルバルーチンがプロセスによって最初に
-起動されたときに読み込まれる情報が格納されている。
-このファイルは人間に可読なように設計されている。
-キーワードと値のリストが含まれ、いろいろなタイプのレゾルバ情報を提供する。
+\fIresolver\fP は、インターネットのドメインネームシステム (DNS) へのアクセスを提供する C ライブラリのルーチン群である。
+レゾルバ設定ファイルには、レゾルバルーチンがプロセスによって最初に 起動されたときに読み込まれる情報が格納されている。
+このファイルは人間に可読なように設計されている。 キーワードと値のリストが含まれ、いろいろなタイプのレゾルバ情報を提供する。
 .LP
-普通に設定されたシステムでは、このファイルは必要ない。
-問い合わせをされる唯一のネームサーバはローカルマシン上にある。
-ドメイン名はホスト名から決定され、
-ドメインの検索パスはドメイン名から作成される。
+普通に設定されたシステムでは、このファイルは必要ない。 問い合わせをされる唯一のネームサーバはローカルマシン上にある。
+ドメイン名はホスト名から決定され、 ドメインの検索パスはドメイン名から作成される。
 .LP
 この状態を変更するための設定オプションには、以下のようなものがある。
-.TP
+.TP 
 \fBnameserver\fP ネームサーバの IP アドレス
-レゾルバが問い合わせをするネームサーバの
-(ドット表記の) インターネットアドレス。
-このキーワード 1 つごとに 1 台づつ、
-.B MAXNS
-台 (現状では 3 台、\fI<resolv.h>\fP を参照) までのネームサーバをリストできる。
-複数のサーバが指定された場合、レゾルバライブラリは
-リストされた順に問い合わせを行う。
-\fBnameserver\fP エントリがない場合、
-デフォルトではローカルマシン上のネームサーバが使われる。
-(ここで使われるアルゴリズムは以下のようなものである。
-はじめにネームサーバに問い合わせを試みる。
-この問い合わせがタイムアウトになった場合、
-次のネームサーバに問い合わせを試みる。
-これをネームサーバがなくなるまで続ける。
-それでも応答がない場合は、リトライ最大回数に達するまで
-全てのネームサーバに問い合わせを繰り返す。)
-.TP
+レゾルバが問い合わせをするネームサーバの (ドット表記の) インターネットアドレス。 このキーワード 1 つごとに 1 台づつ、 \fBMAXNS\fP 台
+(現状では 3 台、\fI<resolv.h>\fP を参照) までのネームサーバをリストできる。
+複数のサーバが指定された場合、レゾルバライブラリは リストされた順に問い合わせを行う。 \fBnameserver\fP エントリがない場合、
+デフォルトではローカルマシン上のネームサーバが使われる。 (ここで使われるアルゴリズムは以下のようなものである。
+はじめにネームサーバに問い合わせを試みる。 この問い合わせがタイムアウトになった場合、 次のネームサーバに問い合わせを試みる。
+これをネームサーバがなくなるまで続ける。 それでも応答がない場合は、リトライ最大回数に達するまで 全てのネームサーバに問い合わせを繰り返す。)
+.TP 
 \fBdomain\fP ローカルドメイン名
-このドメインにある名前の問い合わせのほとんどに、
-このローカルドメインにおける短い名前を使用することができる。
-\fBdomain\fP エントリがない場合、ドメイン名は
-.BR gethostname (2)
-で返されるローカルホスト名から決定され、
-最初の \(aq.\(aq 以降の全ての部分がドメイン名とされる。
-このホスト名にもドメイン部を含んでいない場合、ルートドメインが仮定される。
-.TP
+このドメインにある名前の問い合わせのほとんどに、 このローカルドメインにおける短い名前を使用することができる。 \fBdomain\fP
+エントリがない場合、ドメイン名は \fBgethostname\fP(2)  で返されるローカルホスト名から決定され、 最初の \(aq.\(aq
+以降の全ての部分がドメイン名とされる。 このホスト名にもドメイン部を含んでいない場合、ルートドメインが仮定される。
+.TP 
 \fBsearch\fP ホスト名ルックアップのための検索リスト
-検索リストは通常ローカルドメイン名から決定される。
-デフォルトでは、検索リストはローカルドメイン名のみである。
-これを変更するには、\fIsearch\fP キーワードの後に
-希望するドメイン検索パスをスペースまたはタブで区切ってリストすればよい。
-ドットの数が
-.I ndots
-(デフォルトでは 1) より少ないレゾルバの問い合わせは、
-一致するものが見つかるまで検索パスの各要素を順に使って試す。
-複数のサブドメインを持つ環境では、
-第三者による攻撃 (man-in-the-middle attack) と
-ルート DNS サーバへの不必要なトラフィックを避けるために、
-以下の
-.BI "options ndots:" n
-を読んでほしい。
-.\" resolv.conv に
+.\" When having a resolv.conv with a line
 .\"  search subdomain.domain.tld domain.tld
-.\" 以下のような行がある場合に、たとえば
+.\" and doing a hostlookup, for example by
 .\"  ping host.anothersubdomain
-.\" によるホストの検索が行われると、
+.\" it sends dns-requests for
 .\"  host.anothersubdomain.
 .\"  host.anothersubdomain.subdomain.domain.tld.
 .\"  host.anothersubdomain.domain.tld.
-.\" に対して DNS リクエストが送らる。
-.\" これによって、ルート DNS サーバに対して
-.\" 不必要なトラフィックを引き起こすだけでなく、
-.\" 外部に情報をばらまいてしまうために、第三者による攻撃が可能になる。
-このプロセスは遅く、リストされたドメインがローカルのものでない場合、
-多大なネットワークトラフィックを発生させることに注意すること。
-さらに、これらのドメインのいずれかひとつにでも適切なサーバがない場合、
+.\" thus not only causing unnecessary traffic for the root-dns-servers
+.\" but broadcasting information to the outside and making man-in-the-middle
+.\" attacks possible.
+検索リストは通常ローカルドメイン名から決定される。 デフォルトでは、検索リストはローカルドメイン名のみである。 これを変更するには、\fIsearch\fP
+キーワードの後に 希望するドメイン検索パスをスペースまたはタブで区切ってリストすればよい。 ドットの数が \fIndots\fP (デフォルトでは 1)
+より少ないレゾルバの問い合わせは、 一致するものが見つかるまで検索パスの各要素を順に使って試す。 複数のサブドメインを持つ環境では、 第三者による攻撃
+(man\-in\-the\-middle attack) と ルート DNS サーバへの不必要なトラフィックを避けるために、 以下の \fBoptions
+ndots:\fP\fIn\fP を読んでほしい。 このプロセスは遅く、リストされたドメインがローカルのものでない場合、
+多大なネットワークトラフィックを発生させることに注意すること。 さらに、これらのドメインのいずれかひとつにでも適切なサーバがない場合、
 問い合わせがタイムアウトになる点にも注意すること。
 .IP
 現状では、検索リストは 6 ドメイン・計 256 文字に制限されている。
-.TP
+.TP 
 \fBsortlist\fP
-このオプションを使うと、
-.BR gethostbyname (3)
-で返されるアドレスをソートさせることができる。
-sortlist は IP アドレスとネットマスクのペアで指定される。
-ネットマスクは省略可能であり、
-デフォルトではネットに対するデフォルトのネットマスクである。
-IP アドレスとオプションのネットマスクのペアはスラッシュで区切る。
-最大 10 組のペアを指定できる。
-以下に例を示す。
+このオプションを使うと、 \fBgethostbyname\fP(3)  で返されるアドレスをソートさせることができる。 sortlist は IP
+アドレスとネットマスクのペアで指定される。 ネットマスクは省略可能であり、 デフォルトではネットに対するデフォルトのネットマスクである。 IP
+アドレスとオプションのネットマスクのペアはスラッシュで区切る。 最大 10 組のペアを指定できる。 以下に例を示す。
 
 .in +4n
 sortlist 130.155.160.0/255.255.240.0 130.155.0.0
 .in
 .br
-.TP
+.TP 
 \fBoptions\fP
-options により、レゾルバの内部変数を変更することができる。
-書式は以下の通りである。
+options により、レゾルバの内部変数を変更することができる。 書式は以下の通りである。
 .RS
 .IP
 \fBoptions\fP \fIoption\fP \fI...\fP
 .LP
 ここで \fIoption\fP は次のうちのいずれかである。
-.TP
+.TP 
 \fBdebug\fP
 .\" Since glibc 2.2?
-.I _res.options
-に
-.B RES_DEBUG
-を設定する。
-.TP
-.BI ndots: n
+\fI_res.options\fP に \fBRES_DEBUG\fP を設定する。
+.TP 
+\fBndots:\fP\fIn\fP
 .\" Since glibc 2.2
-「\fI最初の完全な名前での問い合わせ\fPが実行される前に、
-.BR res_query (3)
-.RB ( resolver (3)
-を参照) に与えられる名前に含まれているべきドットの数の閾値」を設定する。
-\fIn\fP のデフォルトは 1 である。
+「\fI最初の完全な名前での問い合わせ\fPが実行される前に、 \fBres_query\fP(3)  (\fBresolver\fP(3)  を参照)
+に与えられる名前に含まれているべきドットの数の閾値」を設定する。 \fIn\fP のデフォルトは 1 である。
 これは、名前にドットがある場合、\fIsearch list\fP の要素が付加される前に、
-その名前が完全な名前として最初に試されるということを意味している。
-このオプションの値の上限は 15 であり、黙ってこの値まで切り詰められる。
-.TP
-.BI timeout: n
+その名前が完全な名前として最初に試されるということを意味している。 このオプションの値の上限は 15 であり、黙ってこの値まで切り詰められる。
+.TP 
+\fBtimeout:\fP\fIn\fP
 .\" Since glibc 2.2
-「レゾルバが他のネームサーバで問い合わせをリトライする前に、
-リモートネームサーバからの応答を待つ時間」を設定する。
-単位は秒で、デフォルトは
-.B RES_TIMEOUT
-である
-(現状では 5 秒、\fI<resolv.h>\fP を参照)。
-このオプションの値の上限は 30 であり、黙ってこの値まで切り詰められる。
-.TP
-.BI attempts: n
-「レゾルバが諦めて呼び出し元のアプリケーションにエラーを返すまでに、
-ネームサーバに問い合わせを行う回数」を設定する。
-デフォルトは
-.B RES_DFLRETRY
-回である
-(現状では 2 回、\fI<resolv.h>\fP を参照)。
-このオプションの値の上限は 5 であり、黙ってこの値まで切り詰められる。
-.TP
-.B rotate
+「レゾルバが他のネームサーバで問い合わせをリトライする前に、 リモートネームサーバからの応答を待つ時間」を設定する。 単位は秒で、デフォルトは
+\fBRES_TIMEOUT\fP である (現状では 5 秒、\fI<resolv.h>\fP を参照)。 このオプションの値の上限は 30
+であり、黙ってこの値まで切り詰められる。
+.TP 
+\fBattempts:\fP\fIn\fP
+「レゾルバが諦めて呼び出し元のアプリケーションにエラーを返すまでに、 ネームサーバに問い合わせを行う回数」を設定する。 デフォルトは
+\fBRES_DFLRETRY\fP 回である (現状では 2 回、\fI<resolv.h>\fP を参照)。 このオプションの値の上限は 5
+であり、黙ってこの値まで切り詰められる。
+.TP 
+\fBrotate\fP
 .\" Since glibc 2.2
-.I _res.options
-に RES_ROTATE を設定する。
-リストされているネームサーバから選ぶときに、
-ラウンドロビン (round robin) 選択を行わせる。
-リストされている全てのサーバで問い合わせの負荷を分散する効果があり、
-最初にリストされたサーバに全てのクライアントが
+\fI_res.options\fP に RES_ROTATE を設定する。 リストされているネームサーバから選ぶときに、 ラウンドロビン (round
+robin) 選択を行わせる。 リストされている全てのサーバで問い合わせの負荷を分散する効果があり、 最初にリストされたサーバに全てのクライアントが
 毎回最初に問い合わせを行うわけではなくなる。
-.TP
-.B no-check-names
+.TP 
+\fBno\-check\-names\fP
+.\" since glibc 2.2
+\fI_res.options\fP に \fBRES_NOCHECKNAME\fP を設定する。 入ってくるホスト名とメールアドレスに、 アンダースコア
+(_)・ASCII 以外の文字・制御文字といった 不正な文字が含まれていないかを調べる 最近の BIND のチェックを無効にする。
+.TP 
+\fBinet6\fP
 .\" Since glibc 2.2
-.I _res.options
-に
-.B RES_NOCHECKNAME
-を設定する。
-入ってくるホスト名とメールアドレスに、
-アンダースコア (_)・ASCII 以外の文字・制御文字といった
-不正な文字が含まれていないかを調べる
-最近の BIND のチェックを無効にする。
-.TP
-.B inet6
-.\" Since glibc 2.2
-.I _res.options
-に
-.B RES_USE_INET6
-を設定する。このオプションが設定されると、
-.BR gethostbyname (3)
-関数の内部で A レコードの問い合わせを行う前に
-AAAA レコードの問い合わせを行うようになる。
-また、AAAA レコードは見つからないが A レコードセットが存在する場合に、
-IPv4 の応答を IPv6「トンネル形式」にマップするようになる。
-.TP
-.BR ip6-bytestring " (glibc 2.3.4 以降)"
-.I _res.options
-に
-.B RES_USE_BSTRING
-を設定する。このオプションが設定されると、IPv6 アドレスの逆引きで
-RFC\ 2673 で規定された bit-label 形式が使用されるようになる。
-このオプションが設定されない場合、nibble 形式が使用される。
-.TP
-.BR ip6-dotint / no-ip6-dotint " (glibc 2.3.4 以降)"
-.I _res.options
-への
-.B RES_NOIP6DOTINT
-のセット/クリアを行う。
-このオプションがクリアされると
-.RB ( ip6-dotint )、
-IPv6 アドレスの逆引きが (非推奨の)
-.I ip6.int
-ゾーンで行われるようになり、
-このオプションがセットされると
-.RB ( no-ip6-dotint )、
-IPv6 アドレスの逆引きがデフォルトの
-.I ip6.arpa
-ゾーンで行われるようになる。
-このオプションはデフォルトでセットされる。
-.TP
-.BR edns0 " (glibc 2.6 以降)"
-.I _res.options
-に
-.B RES_USE_EDNSO
-をセットする。これにより、RFC\ 2671 で規定されている
-DNS 拡張のサポートが有効になる。
+\fI_res.options\fP に \fBRES_USE_INET6\fP を設定する。このオプションが設定されると、 \fBgethostbyname\fP(3)
+関数の内部で A レコードの問い合わせを行う前に AAAA レコードの問い合わせを行うようになる。 また、AAAA レコードは見つからないが A
+レコードセットが存在する場合に、 IPv4 の応答を IPv6「トンネル形式」にマップするようになる。
+.TP 
+\fBip6\-bytestring\fP (glibc 2.3.4 以降)
+\fI_res.options\fP に \fBRES_USE_BSTRING\fP を設定する。このオプションが設定されると、IPv6 アドレスの逆引きで
+RFC\ 2673 で規定された bit\-label 形式が使用されるようになる。 このオプションが設定されない場合、nibble 形式が使用される。
+.TP 
+\fBip6\-dotint\fP/\fBno\-ip6\-dotint\fP (glibc 2.3.4 以降)
+\fI_res.options\fP への \fBRES_NOIP6DOTINT\fP のセット/クリアを行う。 このオプションがクリアされると
+(\fBip6\-dotint\fP)、 IPv6 アドレスの逆引きが (非推奨の)  \fIip6.int\fP ゾーンで行われるようになり、
+このオプションがセットされると (\fBno\-ip6\-dotint\fP)、 IPv6 アドレスの逆引きがデフォルトの \fIip6.arpa\fP
+ゾーンで行われるようになる。 このオプションはデフォルトでセットされる。
+.TP 
+\fBedns0\fP (glibc 2.6 以降)
+\fI_res.options\fP に \fBRES_USE_EDNSO\fP をセットする。これにより、RFC\ 2671 で規定されている DNS
+拡張のサポートが有効になる。
 .RE
 .LP
-\fIdomain\fP と \fIsearch\fP キーワードは、互いに排他的である。
-これらのキーワードが 2 つ以上記述されている場合、
+\fIdomain\fP と \fIsearch\fP キーワードは、互いに排他的である。 これらのキーワードが 2 つ以上記述されている場合、
 最後に記述されているものが有効になる。
 .LP
-システムの \fIresolv.conf\fP ファイルにある \fIsearch\fP キーワードは、
-スペースで区切った検索ドメインのリストを
-環境変数
-.B LOCALDOMAIN
-に設定することにより、各プロセス毎に上書きすることができる。
+システムの \fIresolv.conf\fP ファイルにある \fIsearch\fP キーワードは、 スペースで区切った検索ドメインのリストを 環境変数
+\fBLOCALDOMAIN\fP に設定することにより、各プロセス毎に上書きすることができる。
 .LP
-システムの \fIresolv.conf\fP ファイルにある \fIoptions\fP キーワードは、
-上の \fBoptions\fP セクションで説明したように、
-スペースで区切ったレゾルバオプションのリストを
-環境変数
-.B RES_OPTIONS
-に設定することにより、各プロセス毎に修正することができる。
+システムの \fIresolv.conf\fP ファイルにある \fIoptions\fP キーワードは、 上の \fBoptions\fP セクションで説明したように、
+スペースで区切ったレゾルバオプションのリストを 環境変数 \fBRES_OPTIONS\fP に設定することにより、各プロセス毎に修正することができる。
 .LP
-キーワードと値は同じ行に書かなければならない。
-また、(\fBnameserver\fP のような) キーワードが行の先頭になければならない。
+キーワードと値は同じ行に書かなければならない。 また、(\fBnameserver\fP のような) キーワードが行の先頭になければならない。
 値はキーワードの後にスペースで区切って続ける。
+
+セミコロン (;) かハッシュ文字 (#) で始まる行はコメントとして扱われる。
 .SH ファイル
-.IR /etc/resolv.conf ,
-.I <resolv.h>
+\fI/etc/resolv.conf\fP, \fI<resolv.h>\fP
 .SH 関連項目
-.BR gethostbyname (3),
-.BR resolver (3),
-.BR hostname (7),
-.BR named (8)
+\fBgethostbyname\fP(3), \fBresolver\fP(3), \fBhostname\fP(7), \fBnamed\fP(8)
 .br
 BIND のネームサーバオペレーションガイド