Man page - resolver(3)

Packages contains this manual

Available languages:

en fr ja de

Manual

RESOLVER

名 前
書 åŧ
čĒŦ 明
čŋ” り 値
フ ã‚Ą イ ãƒĢ
æē– 拠
é–ĸ é€Ŗ 項 į›Ž
こ ぎ 文 書 ãĢ つ い ãĻ

名 前

res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand - ãƒŦ ã‚ž ãƒĢ バ ãƒĢ ãƒŧ チ ãƒŗ

書 åŧ

#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
extern struct __res_state _res;

int res_init(void);

int res_query(const char * dname , int class , int type ,

unsigned char * answer , int anslen );

int res_search(const char * dname , int class , int type ,

unsigned char * answer , int anslen );

int res_querydomain(const char * name , const char * domain ,

int class , int type , unsigned char * answer ,
int anslen );

int res_mkquery(int op , const char * dname , int class ,

int type , const unsigned char * data , int datalen ,
const unsigned char * newrr , unsigned char * buf , int buflen );

int res_send(const unsigned char * msg , int msglen ,

unsigned char * answer , int anslen );

int dn_comp(const char * exp_dn , unsigned char * comp_dn ,

int length , unsigned char ** dnptrs , unsigned char ** lastdnptr );

int dn_expand(const unsigned char * msg , const unsigned char * eomorig ,

const unsigned char * comp_dn , char * exp_dn ,
int length );

-lresolv で ãƒĒ ãƒŗ ク す る 。

čĒŦ 明

こ れ ら ぎ é–ĸ 数 は イ ãƒŗ ã‚ŋ ãƒŧ ネ ッ ト ぎ ド ãƒĄ イ ãƒŗ ネ ãƒŧ ム ã‚ĩ ãƒŧ バ ãƒŧ ãĢ 問 い 合 わ せ 、 そ ぎ åŋœ į­” を č§Ŗ 釈 す る 。

res_init () é–ĸ 数 は 、 デ フ ã‚Š ãƒĢ ト ぎ ド ãƒĄ イ ãƒŗ 名 、 検 į´ĸ 順 、 ネ ãƒŧ ム ã‚ĩ ãƒŧ バ ãƒŧ ã‚ĸ ド ãƒŦ ã‚š を åž— る た め ãĢ 設 厚 フ ã‚Ą イ ãƒĢ ( resolv.conf (5) 参 į…§ ) を čĒ­ む 。 も し ã‚ĩ ãƒŧ バ ãƒŧ が į¤ē さ れ ãĻ い ãĒ け れ ば ロ ãƒŧ ã‚Ģ ãƒĢ ホ ã‚š ト を čŠĻ す 。 ド ãƒĄ イ ãƒŗ が į¤ē さ れ ãĻ い ãĒ け れ ば ロ ãƒŧ ã‚Ģ ãƒĢ ホ ã‚š ト ãĢ äģ˜ け ら れ た ド ãƒĄ イ ãƒŗ を į”¨ い る 。 į’° åĸƒ 変 数 LOCALDOMAIN で ã‚Ē ãƒŧ バ ãƒŧ ナ イ ド で き る 。 res_init () は 、 垌 čŋ° す る é–ĸ 数 ぎ お れ か が 最 初 ãĢ å‘ŧ ãŗ å‡ē さ れ た 時 、 そ ぎ é–ĸ 数 か ら 原 行 さ れ る 。

res_query () é–ĸ 数 は 、 指 厚 さ れ た type と class ぎ 厌 全 äŋŽ éŖž ド ãƒĄ イ ãƒŗ 名 (FQDN) name を 、 ネ ãƒŧ ム ã‚ĩ ãƒŧ バ ãƒŧ へ 問 い 合 わ せ る 。 åŋœ į­” は 、 å‘ŧ ãŗ å‡ē し た 側 ãĢ よ ãŖ ãĻ į”¨ 意 さ れ る 長 さ anslen ぎ answer バ ッ フ ã‚Ą ãƒŧ ãĢ 掋 さ れ る 。

res_search () é–ĸ 数 は 、 問 い 合 わ せ を 行 い res_query () 同 様 そ ぎ åŋœ į­” を åž… つ が 、 さ ら ãĢ デ フ ã‚Š ãƒĢ ト を 原 čŖ… し ãĻ お り RES_DEFNAMES と RES_DNSRCH ãĢ よ ãŖ ãĻ čĻ 厚 さ れ る 検 į´ĸ ãƒĢ ãƒŧ ãƒĢ を 遊 į”¨ す る 。 (下 記 _res ã‚Ē プ ã‚ˇ ョ ãƒŗ ぎ čĒŦ 明 を 参 į…§ )

res_querydomain () é–ĸ 数 は name と domain ぎ įĩ 合 ãĢ res_query () を į”¨ い ãĻ 問 い 合 わ せ を 行 う 。

æŦĄ ぎ é–ĸ 数 は 、 res_query () で äŊŋ わ れ る 下 äŊ ãƒĢ ãƒŧ チ ãƒŗ で あ る 。

res_mkquery () é–ĸ 数 は 、 ド ãƒĄ イ ãƒŗ 名 dname ぎ į‚ē ãĢ 、 長 さ buflen ぎ buf ãĢ 問 い 合 わ せ る ãƒĄ ッ ã‚ģ ãƒŧ ジ を äŊœ 成 す る 。 問 い 合 わ せ ぎ 型 op は 通 常 QUERY だ が 、 <arpa/nameser.h> で 厚 įžŠ さ れ た 型 ぎ お れ で も č‰¯ い 。 newrr は įž 在 äŊŋ į”¨ さ れ ãĻ い ãĒ い 。

res_send () é–ĸ 数 は 、 長 さ msglen ぎ msg ãĢ æąē め ら れ た 書 åŧ で 問 い 合 わ せ 、 answer ãĢ 長 さ anslen ぎ 回 į­” を čŋ” す 。 ぞ だ å‘ŧ ãŗ å‡ē さ れ ãĻ い ãĒ け れ ば res_init () を å‘ŧ ãŗ å‡ē す 。

dn_comp () é–ĸ 数 は ド ãƒĄ イ ãƒŗ 名 exp_dn を 圧 į¸Ž し ãĻ 、 長 さ length ぎ バ ッ フ ã‚Ą ãƒŧ comp_dn ãĢ äŋ 存 す る 。 圧 į¸Ž ãĢ は ポ イ ãƒŗ ã‚ŋ ãƒŧ 配 列 dnptrs を į”¨ い る 。 こ れ ら ぎ ポ イ ãƒŗ ã‚ŋ ãƒŧ は 、 įž 在 ぎ ãƒĄ ッ ã‚ģ ãƒŧ ジ ぎ 中 ãĢ あ る äģĨ 前 ãĢ 圧 į¸Ž さ れ た 名 前 を 指 す 。 最 初 ぎ ポ イ ãƒŗ ã‚ŋ ãƒŧ は ãƒĄ ッ ã‚ģ ãƒŧ ジ ぎ 冒 é ­ を 指 し 、 そ ぎ ãƒĒ ã‚š ト は NULL で įĩ‚ わ る 。 配 列 ぎ į¯„ å›˛ は lastdnptr で æąē め ら れ る 。 dnptr が NULL ãĒ ら ば ド ãƒĄ イ ãƒŗ 名 は 圧 į¸Ž さ れ ãĒ い 。 lastdnptr が NULL ãĒ ら ば 、 そ ぎ ナ ベ ãƒĢ ぎ ãƒĒ ã‚š ト は ã‚ĸ ッ プ デ ãƒŧ ト さ れ ãĒ い 。

dn_expand () é–ĸ 数 は 、 圧 į¸Ž さ れ た ド ãƒĄ イ ãƒŗ 名 comp_dn か ら ã‚ĩ イ ã‚ē が length ぎ exp_dn バ ッ フ ã‚Ą ãƒŧ ãĢ æ­Ŗ åŧ ãĒ ド ãƒĄ イ ãƒŗ 名 を åą• 開 す る 。 そ ぎ 圧 į¸Ž さ れ た 名 前 は 、 問 い 合 わ せ 、 ぞ た は åŋœ į­” ãƒĄ ッ ã‚ģ ãƒŧ ジ ãĢ åĢ ぞ れ ãĻ い ãĻ 、 msg が ãƒĄ ッ ã‚ģ ãƒŧ ジ ぎ 冒 é ­ を 指 す 。

ãƒŦ ã‚ž ãƒĢ バ ãƒĢ ãƒŧ チ ãƒŗ は 、 <resolv.h> ãĢ 厚 įžŠ さ れ た _res 構 造 äŊ“ ãĢ åĢ ぞ れ ãĻ い る 全 äŊ“ įš„ ãĒ 設 厚 と įŠļ 態 ぎ 情 å ą を äŊŋ į”¨ す る 。 通 常 ãƒĻ ãƒŧ ã‚ļ ãƒŧ ãĢ 操 äŊœ で き る 項 į›Ž は _res.options だ け で あ る 。 こ ぎ 項 į›Ž は äģĨ 下 ぎ ã‚Ē プ ã‚ˇ ョ ãƒŗ ぎ ビ ッ ト 単 äŊ ぎ čĢ– į† 和 ãĢ で き る 。
RES_INIT

res_init () が å‘ŧ ãŗ å‡ē さ れ ãĻ い れ ば įœŸ 。

RES_DEBUG

デ バ ッ グ 情 å ą を 襨 į¤ē す る 。 こ ぎ ã‚Ē プ ã‚ˇ ョ ãƒŗ は 、 glibc が デ バ ッ グ を 有 劚 ãĢ し ãĻ ã‚ŗ ãƒŗ パ イ ãƒĢ さ れ ãĻ い る å ´ 合 ãĢ ぎ ãŋ 刊 į”¨ で き る 。 デ フ ã‚Š ãƒĢ ト で は glibc ぎ デ バ ッ グ は 有 劚 ãĢ ãĒ ãŖ ãĻ い ãĒ い 。

RES_AAONLY

樊 威 äģ˜ け さ れ た (authoritative) 回 į­” ぎ ãŋ 受 け å…Ĩ れ る 。 res_send () は 、 最 įĩ‚ įš„ ãĢ 樊 威 äģ˜ け さ れ た 回 į­” を åž— ら れ る か 、 エ ナ ãƒŧ が čŋ” さ れ る ぞ で įļš 行 す る 。 [įž 在 原 čŖ… さ れ ãĻ い ãĒ い ]

RES_USEVC

問 い 合 わ せ ãĢ UDP デ ãƒŧ ã‚ŋ グ ナ ム で は ãĒ く TCP æŽĨ įļš を į”¨ い る 。

RES_PRIMARY

プ ナ イ マ ãƒĒ ド ãƒĄ イ ãƒŗ ネ ãƒŧ ム ã‚ĩ ãƒŧ バ ãƒŧ ぎ ãŋ 問 い 合 わ せ る 。

RES_IGNTC

切 り 芰 め エ ナ ãƒŧ (truncation error) を į„Ą čĻ– す る 。 TCP で ãƒĒ ト ナ イ し ãĒ い 。 [įž 在 原 čŖ… さ れ ãĻ い ãĒ い ]

RES_RECURSE

再 帰 čĻ æą‚ (recursion desired) ビ ッ ト を 問 い 合 わ せ ãĢ 設 厚 す る 。 再 帰 は res_send () で は ãĒ く ド ãƒĄ イ ãƒŗ ネ ãƒŧ ム ã‚ĩ ãƒŧ バ ãƒŧ ãĢ よ ãŖ ãĻ 行 わ れ る 。 [デ フ ã‚Š ãƒĢ ト で 有 劚 ]

RES_DEFNAMES

設 厚 さ れ ãĻ い れ ば 、 res_search () は デ フ ã‚Š ãƒĢ ト ぎ ド ãƒĄ イ ãƒŗ 名 を 一 部 分 ぎ ãŋ か ら ãĒ る 名 前 、 す ãĒ わ ãĄ ド ッ ト を åĢ ぞ ãĒ い 名 前 ãĢ äģ˜ け 加 え る 。 [デ フ ã‚Š ãƒĢ ト で 有 劚 ]

RES_STAYOPEN

問 い 合 わ せ 中 ãĢ TCP æŽĨ įļš を äŋ つ た め RES_USEVC と å…ą ãĢ į”¨ い ら れ る 。

RES_DNSRCH

設 厚 さ れ ãĻ い れ ば 、 res_search () は įž 在 ぎ ド ãƒĄ イ ãƒŗ お よ ãŗ čĻĒ ド ãƒĄ イ ãƒŗ ぎ ホ ã‚š ト 名 を æŽĸ す 。 こ ぎ ã‚Ē プ ã‚ˇ ョ ãƒŗ は gethostbyname (3) で į”¨ い ら れ る 。 [デ フ ã‚Š ãƒĢ ト で 有 劚 ]

こ ぎ ãƒĒ ã‚š ト は 厌 全 ãĒ も ぎ で は ãĒ い 。 resolv.conf (5) ãĢ は äģ– ãĢ い く つ か ぎ フ ナ グ が 記 čŧ‰ さ れ ãĻ い る 。

čŋ” り 値

res_init () é–ĸ 数 は 成 功 す れ ば 0 を 、 エ ナ ãƒŧ が į™ē į”Ÿ す れ ば -1 を čŋ” す 。

res_query (), res_search (), res_querydomain (), res_mkquery (), res_send () é–ĸ 数 は åŋœ į­” ぎ 長 さ を čŋ” す 。 ぞ た 、 エ ナ ãƒŧ が į™ē į”Ÿ す れ ば -1 を čŋ” す 。

dn_comp () と dn_expand () é–ĸ 数 は 圧 į¸Ž さ れ た ド ãƒĄ イ ãƒŗ 名 ぎ 長 さ を čŋ” す 。 ぞ た 、 エ ナ ãƒŧ が į™ē į”Ÿ す れ ば -1 を čŋ” す 。

フ ã‚Ą イ ãƒĢ

/etc/resolv.conf ãƒŦ ã‚ž ãƒĢ バ 設 厚 フ ã‚Ą イ ãƒĢ
/etc/host.conf ãƒŦ ã‚ž ãƒĢ バ 設 厚 フ ã‚Ą イ ãƒĢ

æē– 拠

4.3BSD.

é–ĸ é€Ŗ 項 į›Ž

gethostbyname (3), resolv.conf (5), resolver (5), hostname (7), named (8)

こ ぎ 文 書 ãĢ つ い ãĻ

こ ぎ man ペ ãƒŧ ジ は Linux man-pages プ ロ ジ ェ ク ト ぎ ãƒĒ ãƒĒ ãƒŧ ã‚š 3.79 ぎ 一 部 で あ る 。 プ ロ ジ ェ ク ト ぎ čĒŦ 明 と バ グ å ą 告 ãĢ é–ĸ す る 情 å ą は http://www.kernel.org/doc/man-pages/ ãĢ 書 か れ ãĻ い る 。