Man page - resolver(5)

Packages contains this manual

Available languages:

en fr pl ja ro zh_TW zh_CN de

Manual

RESOLV.CONF

名 前
書 式
説 明
フ ァ イ ル
関 連 項 目
こ の 文 書 に つ い て

名 前

resolv.conf - レ ゾ ル バ 設 定 フ ァ イ ル

書 式

/etc/resolv.conf

説 明

The resolver is a set of routines in the C library that provide access to the Internet Domain Name System (DNS). The resolver configuration file contains information that is read by the resolver routines the first time they are invoked by a process. The file is designed to be human readable and contains a list of keywords with values that provide various types of resolver information. The configuration file is considered a trusted source of DNS information; see the trust-ad option below for details.

If this file does not exist, only the name server on the local machine will be queried, and the search list contains the local domain name determined from the hostname.

こ の 状 態 を 変 更 す る た め の 設 定 オ プ シ ョ ン に は 、 以 下 の よ う な も の が あ る 。
nameserver ネ ー ム サ ー バ の IP ア ド レ ス

レ ゾ ル バ が 問 い 合 わ せ を す る ネ ー ム サ ー バ の イ ン タ ー ネ ッ ト ア ド レ ス 。 ア ド レ ス に は IPv4 ア ド レ ス か IPv6 ア ド レ ス を 指 定 す る 。 IPv4 ア ド レ ス は ド ッ ト 表 記 で 、 IPv6 ア ド レ ス は RFC 2373 で 定 め ら れ た コ ロ ン 表 記 (お そ ら く ド ッ ト 表 記 も 可 ) で 指 定 す る 。 こ の キ ー ワ ー ド 1 つ ご と に 1 台 づ つ 、 MAXNS 台 (現 状 で は 3 台 、 <resolv.h> を 参 照 ) ま で の ネ ー ム サ ー バ を リ ス ト で き る 。 複 数 の サ ー バ が 指 定 さ れ た 場 合 、 レ ゾ ル バ ラ イ ブ ラ リ は リ ス ト さ れ た 順 に 問 い 合 わ せ を 行 う 。 nameserver エ ン ト リ ー が な い 場 合 、 デ フ ォ ル ト で は ロ ー カ ル マ シ ン 上 の ネ ー ム サ ー バ が 使 わ れ る 。 (こ こ で 使 わ れ る ア ル ゴ リ ズ ム は 以 下 の よ う な も の で あ る 。 は じ め に ネ ー ム サ ー バ に 問 い 合 わ せ を 試 み る 。 こ の 問 い 合 わ せ が タ イ ム ア ウ ト に な っ た 場 合 、 次 の ネ ー ム サ ー バ に 問 い 合 わ せ を 試 み る 。 こ れ を ネ ー ム サ ー バ が な く な る ま で 続 け る 。 そ れ で も 応 答 が な い 場 合 は 、 リ ト ラ イ 最 大 回 数 に 達 す る ま で 全 て の ネ ー ム サ ー バ に 問 い 合 わ せ を 繰 り 返 す 。 )

search ホ ス ト 名 ル ッ ク ア ッ プ の た め の 検 索 リ ス ト

By default, the search list contains one entry, the local domain name. It is determined from the local hostname returned by gethostname (2); the local domain name is taken to be everything after the first '.'. Finally, if the hostname does not contain a '.', the root domain is assumed as the local domain name.

こ れ を 変 更 す る に は 、 search キ ー ワ ー ド の 後 に 希 望 す る ド メ イ ン 検 索 パ ス を ス ペ ー ス ま た は タ ブ で 区 切 っ て リ ス ト す れ ば よ い 。 ド ッ ト の 数 が ndots (デ フ ォ ル ト で は 1) よ り 少 な い レ ゾ ル バ の 問 い 合 わ せ は 、 一 致 す る も の が 見 つ か る ま で 検 索 パ ス の 各 要 素 を 順 に 使 っ て 試 す 。 複 数 の サ ブ ド メ イ ン を 持 つ 環 境 で は 、 第 三 者 に よ る 攻 撃 (man-in-the-middle attack) と ル ー ト DNS サ ー バ へ の 不 必 要 な ト ラ フ ィ ッ ク を 避 け る た め に 、 以 下 の options ndots: n を 読 ん で ほ し い 。 こ の プ ロ セ ス は 遅 く 、 リ ス ト さ れ た ド メ イ ン が ロ ー カ ル の も の で な い 場 合 、 多 大 な ネ ッ ト ワ ー ク ト ラ フ ィ ッ ク を 発 生 さ せ る こ と に 注 意 す る こ と 。 さ ら に 、 こ れ ら の ド メ イ ン の い ず れ か ひ と つ に で も 適 切 な サ ー バ が な い 場 合 、 問 い 合 わ せ が タ イ ム ア ウ ト に な る 点 に も 注 意 す る こ と 。

If there are multiple search directives, only the search list from the last instance is used.

In glibc 2.25 and earlier, the search list is limited to six domains with a total of 256 characters. Since glibc 2.26, the search list is unlimited.

The domain directive is an obsolete name for the search directive that handles one search list entry only.

sortlist

こ の オ プ シ ョ ン を 使 う と 、 gethostbyname (3) で 返 さ れ る ア ド レ ス を ソ ー ト さ せ る こ と が で き る 。 sortlist は IP ア ド レ ス と ネ ッ ト マ ス ク の ペ ア で 指 定 さ れ る 。 ネ ッ ト マ ス ク は 省 略 可 能 で あ り 、 デ フ ォ ル ト で は ネ ッ ト に 対 す る デ フ ォ ル ト の ネ ッ ト マ ス ク で あ る 。 IP ア ド レ ス と オ プ シ ョ ン の ネ ッ ト マ ス ク の ペ ア は ス ラ ッ シ ュ で 区 切 る 。 最 大 10 組 の ペ ア を 指 定 で き る 。 以 下 に 例 を 示 す 。

sortlist 130.155.160.0/255.255.240.0 130.155.0.0

options

options に よ り 、 レ ゾ ル バ の 内 部 変 数 を 変 更 す る こ と が で き る 。 書 式 は 以 下 の 通 り で あ る 。

options option ...

こ こ で option は 次 の う ち の い ず れ か で あ る 。

debug

RES_DEBUG を _res.options に セ ッ ト す る (glibc が デ バ ッ グ を 有 効 に し て コ ン パ イ ル さ れ て い る 場 合 に の み 有 効 で あ る ; resolver (3) を 参 照 )。

ndots: n

「 最 初 の 完 全 な 名 前 で の 問 い 合 わ せ が 実 行 さ れ る 前 に 、 res_query (3) ( resolver (3) を 参 照 ) に 与 え ら れ る 名 前 に 含 ま れ て い る べ き ド ッ ト の 数 の 閾 値 」 を 設 定 す る 。 n の デ フ ォ ル ト は 1 で あ る 。 こ れ は 、 名 前 に ド ッ ト が あ る 場 合 、 search list の 要 素 が 付 加 さ れ る 前 に 、 そ の 名 前 が 完 全 な 名 前 と し て 最 初 に 試 さ れ る と い う こ と を 意 味 し て い る 。 こ の オ プ シ ョ ン の 値 の 上 限 は 15 で あ り 、 黙 っ て こ の 値 ま で 切 り 詰 め ら れ る 。

timeout: n

Sets the amount of time the resolver will wait for a response from a remote name server before retrying the query via a different name server. This may not be the total time taken by any resolver API call and there is no guarantee that a single resolver API call maps to a single timeout. Measured in seconds, the default is RES_TIMEOUT (currently 5, see <resolv.h> ). The value for this option is silently capped to 30.

attempts: n

「 レ ゾ ル バ が 諦 め て 呼 び 出 し 元 の ア プ リ ケ ー シ ョ ン に エ ラ ー を 返 す ま で に 、 ネ ー ム サ ー バ に 問 い 合 わ せ を 行 う 回 数 」 を 設 定 す る 。 デ フ ォ ル ト は RES_DFLRETRY 回 で あ る (現 状 で は 2 回 、 <resolv.h> を 参 照 )。 こ の オ プ シ ョ ン の 値 の 上 限 は 5 で あ り 、 黙 っ て こ の 値 ま で 切 り 詰 め ら れ る 。

rotate

_res.options に RES_ROTATE を 設 定 す る 。 リ ス ト さ れ て い る ネ ー ム サ ー バ か ら 選 ぶ と き に 、 ラ ウ ン ド ロ ビ ン (round-robin) 選 択 を 行 わ せ る 。 リ ス ト さ れ て い る 全 て の サ ー バ で 問 い 合 わ せ の 負 荷 を 分 散 す る 効 果 が あ り 、 最 初 に リ ス ト さ れ た サ ー バ に 全 て の ク ラ イ ア ン ト が 毎 回 最 初 に 問 い 合 わ せ を 行 う わ け で は な く な る 。

no-check-names

_res.options に RES_NOCHECKNAME を 設 定 す る 。 入 っ て く る ホ ス ト 名 と メ ー ル ア ド レ ス に 、 ア ン ダ ー ス コ ア (_)・ ASCII 以 外 の 文 字 ・ 制 御 文 字 と い っ た 不 正 な 文 字 が 含 ま れ て い な い か を 調 べ る 最 近 の BIND の チ ェ ッ ク を 無 効 に す る 。

inet6

Sets RES_USE_INET6 in _res.options . This has the effect of trying an AAAA query before an A query inside the gethostbyname (3) function, and of mapping IPv4 responses in IPv6 "tunneled form" if no AAAA records are found but an A record set exists. Since glibc 2.25, this option is deprecated; applications should use getaddrinfo (3), rather than gethostbyname (3).

ip6-bytestring (glibc 2.3.4 か ら 2.24 ま で )

Sets RES_USEBSTRING in _res.options . This causes reverse IPv6 lookups to be made using the bit-label format described in RFC 2673; if this option is not set (which is the default), then nibble format is used. This option was removed in glibc 2.25, since it relied on a backward-incompatible DNS extension that was never deployed on the Internet.

ip6-dotint / no-ip6-dotint (glibc 2.3.4 か ら 2.24 ま で )

Clear/set RES_NOIP6DOTINT in _res.options . When this option is clear ( ip6-dotint ), reverse IPv6 lookups are made in the (deprecated) ip6.int zone; when this option is set ( no-ip6-dotint ), reverse IPv6 lookups are made in the ip6.arpa zone by default. These options are available in glibc versions up to 2.24, where no-ip6-dotint is the default. Since ip6-dotint support long ago ceased to be available on the Internet, these options were removed in glibc 2.25.

edns0 (glibc 2.6 以 降 )

_res.options に RES_USE_EDNSO を セ ッ ト す る 。 こ れ に よ り 、 RFC 2671 で 規 定 さ れ て い る DNS 拡 張 の サ ポ ー ト が 有 効 に な る 。

single-request (glibc 2.10 以 降 )

_res.options に RES_SNGLKUP を セ ッ ト す る 。 glibc バ ー ジ ョ ン 2.9 以 降 で は 、 glibc は デ フ ォ ル ト で は IPv4 と IPv6 の 検 索 を 並 行 し て 実 行 す る 。 ア プ ラ イ ア ン ス DNS サ ー バ の 中 に は 、 こ の よ う な 問 い 合 わ せ を 適 切 に 処 理 で き ず 、 検 索 要 求 が タ イ ム ア ウ ト に な っ て し ま う 。 こ の オ プ シ ョ ン を セ ッ ト す る と 、 こ の デ フ ォ ル ト の 動 作 が 無 効 に な り 、 glibc は IPv6 と IPv4 の 検 索 を 順 番 に 実 行 す る よ う に な る (名 前 解 決 処 理 が 若 干 遅 く な る と い う デ メ リ ッ ト が あ る )。

single-request-reopen (glibc 2.9 以 降 )

_res.options に RES_SNGLKUPREOP を セ ッ ト す る 。 リ ゾ ル バ は 同 じ ソ ケ ッ ト を 使 っ て A レ コ ー ド と AAAA レ コ ー ド の 検 索 要 求 を 行 う 。 い く つ か の ハ ー ド ウ ェ ア は 実 装 が 間 違 っ て お り 、 応 答 を 一 つ し か 返 さ な い 。 こ の 状 況 に な る と 、 ク ラ イ ア ン ト シ ス テ ム は 2 番 目 の 応 答 を 待 ち 続 け て し ま う 。 こ の オ プ シ ョ ン を 有 効 に す る と 、 こ の 動 作 が 変 更 さ れ 、 同 じ ポ ー ト か ら の 2 つ の 検 索 要 求 が 正 し く 処 理 さ れ な か っ た 場 合 、 2 番 目 の 検 索 要 求 を 送 信 す る 前 に ソ ケ ッ ト を ク ロ ー ズ し 新 し い ソ ケ ッ ト を オ ー プ ン す る よ う に な る 。

no-tld-query (glibc 2.14 以 降 )

RES_NOTLDQUERY を _res.options に セ ッ ト す る 。 こ の オ プ シ ョ ン を 設 定 す る と 、 res_nsearch () が 完 全 な ド メ イ ン 名 で は な い 名 前 の ト ッ プ レ ベ ル ド メ イ ン (TLD) と し て の 検 索 を 行 わ な く な る 。 こ れ に よ り 、 localhost に 検 索 リ ス ト の 要 素 を つ け る の で は な く 、 “localhost” を TLD と し て 設 定 し て い る よ う な サ イ ト で は 問 題 が 起 こ る 可 能 性 が あ る 。 RES_DEFNAMES も RES_DNSRCH も セ ッ ト さ れ て い な い 場 合 に は 、 こ の オ プ シ ョ ン は 効 果 は な い 。

use-vc (glibc 2.14 以 降 )

Sets RES_USEVC in _res.options . This option forces the use of TCP for DNS resolutions.

no-reload (glibc 2.26 以 降 )

Sets RES_NORELOAD in _res.options . This option disables automatic reloading of a changed configuration file.

trust-ad (glibc 2.31 以 降 )

Sets RES_TRUSTAD in _res.options . This option controls the AD bit behavior of the stub resolver. If a validating resolver sets the AD bit in a response, it indicates that the data in the response was verified according to the DNSSEC protocol. In order to rely on the AD bit, the local system has to trust both the DNSSEC-validating resolver and the network path to it, which is why an explicit opt-in is required. If the trust-ad option is active, the stub resolver sets the AD bit in outgoing DNS queries (to enable AD bit support), and preserves the AD bit in responses. Without this option, the AD bit is not set in queries, and it is always removed from responses before they are returned to the application. This means that applications can trust the AD bit in responses if the trust-ad option has been set correctly.

In glibc version 2.30 and earlier, the AD is not set automatically in queries, and is passed through unchanged to applications in responses.

シ ス テ ム の resolv.conf フ ァ イ ル に あ る search キ ー ワ ー ド は 、 ス ペ ー ス で 区 切 っ た 検 索 ド メ イ ン の リ ス ト を 環 境 変 数 LOCALDOMAIN に 設 定 す る こ と に よ り 、 各 プ ロ セ ス 毎 に 上 書 き す る こ と が で き る 。

シ ス テ ム の resolv.conf フ ァ イ ル に あ る options キ ー ワ ー ド は 、 上 の options セ ク シ ョ ン で 説 明 し た よ う に 、 ス ペ ー ス で 区 切 っ た レ ゾ ル バ オ プ シ ョ ン の リ ス ト を 環 境 変 数 RES_OPTIONS に 設 定 す る こ と に よ り 、 各 プ ロ セ ス 毎 に 修 正 す る こ と が で き る 。

キ ー ワ ー ド と 値 は 同 じ 行 に 書 か な け れ ば な ら な い 。 ま た 、 ( nameserver の よ う な ) キ ー ワ ー ド が 行 の 先 頭 に な け れ ば な ら な い 。 値 は キ ー ワ ー ド の 後 に ス ペ ー ス で 区 切 っ て 続 け る 。

セ ミ コ ロ ン (;) か ハ ッ シ ュ 文 字 (#) で 始 ま る 行 は コ メ ン ト と し て 扱 わ れ る 。

フ ァ イ ル

/etc/resolv.conf , <resolv.h>

関 連 項 目

gethostbyname (3), resolver (3), host.conf (5), hosts (5), nsswitch.conf (5), hostname (7), named (8)

BIND の ネ ー ム サ ー バ オ ペ レ ー シ ョ ン ガ イ ド

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。