Manpages

名 前

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

書 式

/etc/resolv.conf

説 明

resolver は 、 イ ン タ ー ネ ッ ト の ド メ イ ン ネ ー ム シ ス テ ム (DNS) へ の ア ク セ ス を 提 供 す る C ラ イ ブ ラ リ の ル ー チ ン 群 で あ る 。 レ ゾ ル バ 設 定 フ ァ イ ル に は 、 レ ゾ ル バ ル ー チ ン が プ ロ セ ス に よ っ て 最 初 に 起 動 さ れ た と き に 読 み 込 ま れ る 情 報 が 格 納 さ れ て い る 。 こ の フ ァ イ ル は 人 間 に 可 読 な よ う に 設 計 さ れ て い る 。 キ ー ワ ー ド と 値 の リ ス ト が 含 ま れ 、 い ろ い ろ な タ イ プ の レ ゾ ル バ 情 報 を 提 供 す る 。 設 定 フ ァ イ ル は DNS 情 報 の 信 頼 で き る 情 報 源 と み な さ れ る (例 え ば 、 こ の フ ァ イ ル か ら の DNSSEC AD ビ ッ ト 情 報 は 変 更 さ れ ず に そ の ま ま 返 さ れ る )。 こ の フ ァ イ ル が 存 在 し な い 場 合 、 問 い 合 わ せ は ロ ー カ ル マ シ ン 上 の ネ ー ム サ ー バ に 対 し て の み 行 わ れ る 。 ド メ イ ン 名 は ホ ス ト 名 か ら 決 定 さ れ 、 ド メ イ ン の 検 索 パ ス は ド メ イ ン 名 か ら 作 成 さ れ る 。 こ の 状 態 を 変 更 す る た め の 設 定 オ プ シ ョ ン に は 、 以 下 の よ う な も の が あ る 。
nameserver
ネ ー ム サ ー バ の IP ア ド レ ス レ ゾ ル バ が 問 い 合 わ せ を す る ネ ー ム サ ー バ の イ ン タ ー ネ ッ ト ア ド レ ス 。 ア ド レ ス に は IPv4 ア ド レ ス か IPv6 ア ド レ ス を 指 定 す る 。 IPv4 ア ド レ ス は ド ッ ト 表 記 で 、 IPv6 ア ド レ ス は RFC 2373 で 定 め ら れ た コ ロ ン 表 記 (お そ ら く ド ッ ト 表 記 も 可 ) で 指 定 す る 。 こ の キ ー ワ ー ド 1 つ ご と に 1 台 づ つ 、 MAXNS 台 (現 状 で は 3 台 、 <resolv.h> を 参 照 ) ま で の ネ ー ム サ ー バ を リ ス ト で き る 。 複 数 の サ ー バ が 指 定 さ れ た 場 合 、 レ ゾ ル バ ラ イ ブ ラ リ は リ ス ト さ れ た 順 に 問 い 合 わ せ を 行 う 。 nameserver エ ン ト リ ー が な い 場 合 、 デ フ ォ ル ト で は ロ ー カ ル マ シ ン 上 の ネ ー ム サ ー バ が 使 わ れ る 。 (こ こ で 使 わ れ る ア ル ゴ リ ズ ム は 以 下 の よ う な も の で あ る 。 は じ め に ネ ー ム サ ー バ に 問 い 合 わ せ を 試 み る 。 こ の 問 い 合 わ せ が タ イ ム ア ウ ト に な っ た 場 合 、 次 の ネ ー ム サ ー バ に 問 い 合 わ せ を 試 み る 。 こ れ を ネ ー ム サ ー バ が な く な る ま で 続 け る 。 そ れ で も 応 答 が な い 場 合 は 、 リ ト ラ イ 最 大 回 数 に 達 す る ま で 全 て の ネ ー ム サ ー バ に 問 い 合 わ せ を 繰 り 返 す 。 )
domain
ロ ー カ ル ド メ イ ン 名 こ の ド メ イ ン に あ る 名 前 の 問 い 合 わ せ の ほ と ん ど に 、 こ の ロ ー カ ル ド メ イ ン に 対 す る 短 い 名 前 を 使 用 す る こ と が で き る 。 '.' が 設 定 さ れ た 場 合 、 ル ー ト ド メ イ ン が 指 定 さ れ た と み な さ れ る 。 domain エ ン ト リ ー が な い 場 合 、 ド メ イ ン 名 は gethostname(2) で 返 さ れ る ロ ー カ ル ホ ス ト 名 か ら 決 定 さ れ 、 最 初 の '.' 以 降 の 全 て の 部 分 が ド メ イ ン 名 と さ れ る 。 こ の ホ ス ト 名 に も ド メ イ ン 部 を 含 ん で い な い 場 合 、 ル ー ト ド メ イ ン が 仮 定 さ れ る 。
search
ホ ス ト 名 ル ッ ク ア ッ プ の た め の 検 索 リ ス ト 検 索 リ ス ト は 通 常 ロ ー カ ル ド メ イ ン 名 か ら 決 定 さ れ る 。 デ フ ォ ル ト で は 、 検 索 リ ス ト は ロ ー カ ル ド メ イ ン 名 の み で あ る 。 こ れ を 変 更 す る に は 、 search キ ー ワ ー ド の 後 に 希 望 す る ド メ イ ン 検 索 パ ス を ス ペ ー ス ま た は タ ブ で 区 切 っ て リ ス ト す れ ば よ い 。 ド ッ ト の 数 が ndots (デ フ ォ ル ト で は 1) よ り 少 な い レ ゾ ル バ の 問 い 合 わ せ は 、 一 致 す る も の が 見 つ か る ま で 検 索 パ ス の 各 要 素 を 順 に 使 っ て 試 す 。 複 数 の サ ブ ド メ イ ン を 持 つ 環 境 で は 、 第 三 者 に よ る 攻 撃 (man−in−the−middle attack) と ル ー ト DNS サ ー バ へ の 不 必 要 な ト ラ フ ィ ッ ク を 避 け る た め に 、 以 下 の options ndots:n を 読 ん で ほ し い 。 こ の プ ロ セ ス は 遅 く 、 リ ス ト さ れ た ド メ イ ン が ロ ー カ ル の も の で な い 場 合 、 多 大 な ネ ッ ト ワ ー ク ト ラ フ ィ ッ ク を 発 生 さ せ る こ と に 注 意 す る こ と 。 さ ら に 、 こ れ ら の ド メ イ ン の い ず れ か ひ と つ に で も 適 切 な サ ー バ が な い 場 合 、 問 い 合 わ せ が タ イ ム ア ウ ト に な る 点 に も 注 意 す る こ と 。 現 状 で は 、 検 索 リ ス ト は 6 ド メ イ ン ・ 計 256 文 字 に 制 限 さ れ て い る 。
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 「 レ ゾ ル バ が 他 の ネ ー ム サ ー バ で 問 い 合 わ せ を リ ト ラ イ す る 前 に 、 リ モ ー ト ネ ー ム サ ー バ か ら の 応 答 を 待 つ 時 間 」 を 設 定 す る 。 単 位 は 秒 で 、 デ フ ォ ル ト は RES_TIMEOUT で あ る (現 状 で は 5 秒 、 <resolv.h> を 参 照 )。 こ の オ プ シ ョ ン の 値 の 上 限 は 30 で あ り 、 黙 っ て こ の 値 ま で 切 り 詰 め ら れ る 。
attempts:
n 「 レ ゾ ル バ が 諦 め て 呼 び 出 し 元 の ア プ リ ケ ー シ ョ ン に エ ラ ー を 返 す ま で に 、 ネ ー ム サ ー バ に 問 い 合 わ せ を 行 う 回 数 」 を 設 定 す る 。 デ フ ォ ル ト は RES_DFLRETRY 回 で あ る (現 状 で は 2 回 、 <resolv.h> を 参 照 )。 こ の オ プ シ ョ ン の 値 の 上 限 は 5 で あ り 、 黙 っ て こ の 値 ま で 切 り 詰 め ら れ る 。

rotate

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

no−check−names

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

inet6

_res.optionsRES_USE_INET6 を 設 定 す る 。 こ の オ プ シ ョ ン が 設 定 さ れ る と 、 gethostbyname(3) 関 数 の 内 部 で A レ コ ー ド の 問 い 合 わ せ を 行 う 前 に AAAA レ コ ー ド の 問 い 合 わ せ を 行 う よ う に な る 。 ま た 、 AAAA レ コ ー ド は 見 つ か ら な い が A レ コ ー ド セ ッ ト が 存 在 す る 場 合 に 、 IPv4 の 応 答 を IPv6「 ト ン ネ ル 形 式 」 に マ ッ プ す る よ う に な る 。

ip6−bytestring (glibc 2.3.4 以 降 )

_res.optionsRES_USE_BSTRING を 設 定 す る 。 こ の オ プ シ ョ ン が 設 定 さ れ る と 、 IPv6 ア ド レ ス の 逆 引 き で RFC 2673 で 規 定 さ れ た bit−label 形 式 が 使 用 さ れ る よ う に な る 。 こ の オ プ シ ョ ン が 設 定 さ れ な い 場 合 、 nibble 形 式 が 使 用 さ れ る 。

ip6−dotint/no−ip6−dotint (glibc 2.3.4 以 降 )

_res.options へ の RES_NOIP6DOTINT の セ ッ ト /ク リ ア を 行 う 。 こ の オ プ シ ョ ン が ク リ ア さ れ る と (ip6−dotint)、 IPv6 ア ド レ ス の 逆 引 き が (非 推 奨 の ) ip6.int ゾ ー ン で 行 わ れ る よ う に な り 、 こ の オ プ シ ョ ン が セ ッ ト さ れ る と (no−ip6−dotint)、 IPv6 ア ド レ ス の 逆 引 き が デ フ ォ ル ト の ip6.arpa ゾ ー ン で 行 わ れ る よ う に な る 。 こ の オ プ シ ョ ン は デ フ ォ ル ト で セ ッ ト さ れ る 。

edns0 (glibc 2.6 以 降 )

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

single−request (glibc 2.10 以 降 )

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

single−request−reopen (glibc 2.9 以 降 ) リ ゾ ル バ は 同 じ ソ ケ ッ ト を 使 っ て 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 も セ ッ ト さ れ て い な い 場 合 に は 、 こ の オ プ シ ョ ン は 効 果 は な い 。

domainsearch キ ー ワ ー ド は 、 互 い に 排 他 的 で あ る 。 こ れ ら の キ ー ワ ー ド が 2 つ 以 上 記 述 さ れ て い る 場 合 、 最 後 に 記 述 さ れ て い る も の が 有 効 に な る 。 シ ス テ ム の resolv.conf フ ァ イ ル に あ る search キ ー ワ ー ド は 、 ス ペ ー ス で 区 切 っ た 検 索 ド メ イ ン の リ ス ト を 環 境 変 数 LOCALDOMAIN に 設 定 す る こ と に よ り 、 各 プ ロ セ ス 毎 に 上 書 き す る こ と が で き る 。 シ ス テ ム の resolv.conf フ ァ イ ル に あ る options キ ー ワ ー ド は 、 上 の options セ ク シ ョ ン で 説 明 し た よ う に 、 ス ペ ー ス で 区 切 っ た レ ゾ ル バ オ プ シ ョ ン の リ ス ト を 環 境 変 数 RES_OPTIONS に 設 定 す る こ と に よ り 、 各 プ ロ セ ス 毎 に 修 正 す る こ と が で き る 。 キ ー ワ ー ド と 値 は 同 じ 行 に 書 か な け れ ば な ら な い 。 ま た 、 (nameserver の よ う な ) キ ー ワ ー ド が 行 の 先 頭 に な け れ ば な ら な い 。 値 は キ ー ワ ー ド の 後 に ス ペ ー ス で 区 切 っ て 続 け る 。 セ ミ コ ロ ン (;) か ハ ッ シ ュ 文 字 (#) で 始 ま る 行 は コ メ ン ト と し て 扱 わ れ る 。

フ ァ イ ル

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

関 連 項 目

gethostbyname(3), resolver(3), hostname(7), named(8)
BIND の ネ ー ム サ ー バ オ ペ レ ー シ ョ ン ガ イ ド

こ の 文 書 に つ い て

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