(split) LDP: Update releases based on LDP 3.52 release

[linuxjm/LDP_man-pages.git] / release / man3 / resolver.3

diff --git a/release/man3/resolver.3 b/release/man3/resolver.3
index 84b5c01..e8e9686 100644 (file)
--- a/release/man3/resolver.3
+++ b/release/man3/resolver.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"

+.\" %%%LICENSE_START(VERBATIM)

 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.


@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.

+.\" %%%LICENSE_END

 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\"
 .\" References consulted:
 .\"     Linux libc source code


@@ -27,237 +29,161 @@
 .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu)
 .\" Modified 2004-10-31 by aeb
 .\"
 .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu)
 .\" Modified 2004-10-31 by aeb
 .\"

-.\" Japanese Version Copyright (c) 1998 Shinji Orito all rights reserved.
-.\"    Translated Mon May 25 21:27:03 JST 1998
-.\"            by Shinji Orito <shinji@os.gulf.or.jp>
-.\" Updated & Modified Thu Feb 17 03:58:45 JST 2005
-.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
+.\"*******************************************************************

 .\"
 .\"

-.\"WORD:       resolver        ¥ì¥¾¥ë¥Ð (¥ê¥¾¥ë¥Ð)
-.\"WORD:       override        ¥ª¡¼¥Ð¡¼¥é¥¤¥É
-.\"WORD:       call    ¸Æ¤Ó½Ð¤·¡¢¸Æ¤Ó½Ð¤¹
-.\"WORD:       fully qualified domain name     ´°Á´½¤¾þ¥É¥á¥¤¥ó̾(FQDN)
-.\"WORD:       type    ·¿
-.\"WORD:       class   ¥¯¥é¥¹
-.\"WORD:       query   Ì䤤¹ç¤ï¤»¡¢Ì䤤¹ç¤ï¤»¤ë
-.\"WORD:       buffer  ¥Ð¥Ã¥Õ¥¡¡¼
-.\"WORD:       lower-level routines    ²¼°Ì¥ë¡¼¥Á¥ó
-.\"WORD:       limit of the array      ÇÛÎó¤ÎÈÏ°Ï
-.\"WORD:       state information       ¾õÂ֤ξðÊó
-.\"WORD:       bitwise ``or''  ¥Ó¥Ã¥Èñ°Ì¤ÎÏÀÍýÏÂ
-.\"WORD:       True    ¿¿ÃÍ
-.\"WORD:       authoritative   ¸¢°ÒÉÕ¤±¤µ¤ì¤¿
-.\"WORD:       recursion desired bit   ºÆµ¢Í×µá¥Ó¥Ã¥È
-.\"WORD:       single component names  °ìÉôʬ¤«¤é¤Ê¤ë̾Á°
+.\" This file was generated with po4a. Translate the source file.

 .\"
 .\"

-.TH RESOLVER 3 2010-06-17 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand \- ¥ì¥¾¥ë¥Ð¡¦¥ë¡¼¥Á¥ó
-.SH ½ñ¼°
+.\"*******************************************************************
+.TH RESOLVER 3 2013\-03\-05 GNU "Linux Programmer's Manual"
+.SH 名前
+res_init, res_query, res_search, res_querydomain, res_mkquery, res_send,
+dn_comp, dn_expand \- レゾルバ・ルーチン
+.SH 書式

 .nf
 .nf

-.B #include <netinet/in.h>
-.B #include <arpa/nameser.h>
-.B #include <resolv.h>
-.B extern struct state _res;
+\fB#include <netinet/in.h>\fP
+\fB#include <arpa/nameser.h>\fP
+\fB#include <resolv.h>\fP
+\fBextern struct state _res;\fP

 .sp
 .sp

-.B int res_init(void);
+\fBint res_init(void);\fP

 .sp
 .sp

-.BI "int res_query(const char *" dname ", int " class ", int " type ,
+\fBint res_query(const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB, int \fP\fItype\fP\fB,\fP

 .RS
 .RS

-.BI "unsigned char *" answer ", int " anslen );
+\fBunsigned char *\fP\fIanswer\fP\fB, int \fP\fIanslen\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int res_search(const char *" dname ", int " class ", int " type ,
+\fBint res_search(const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB, int \fP\fItype\fP\fB,\fP

 .RS
 .RS

-.BI "unsigned char *" answer ", int " anslen );
+\fBunsigned char *\fP\fIanswer\fP\fB, int \fP\fIanslen\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int res_querydomain(const char *" name ", const char *" domain ,
+\fBint res_querydomain(const char *\fP\fIname\fP\fB, const char *\fP\fIdomain\fP\fB,\fP

 .RS
 .RS

-.BI "int " class ", int " type ", unsigned char *" answer ,
-.BI "int " anslen );
+\fBint \fP\fIclass\fP\fB, int \fP\fItype\fP\fB, unsigned char *\fP\fIanswer\fP\fB,\fP
+\fBint \fP\fIanslen\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int res_mkquery(int " op ", const char *" dname ", int " class ,
+\fBint res_mkquery(int \fP\fIop\fP\fB, const char *\fP\fIdname\fP\fB, int \fP\fIclass\fP\fB,\fP

 .RS
 .RS

-.BI "int " type ", char *" data ", int " datalen ", struct rrec *" newrr ,
-.BI "char *" buf ", int " buflen );
+\fBint \fP\fItype\fP\fB, char *\fP\fIdata\fP\fB, int \fP\fIdatalen\fP\fB, struct rrec *\fP\fInewrr\fP\fB,\fP
+\fBchar *\fP\fIbuf\fP\fB, int \fP\fIbuflen\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int res_send(const char *" msg ", int " msglen ", char *" answer ,
+\fBint res_send(const char *\fP\fImsg\fP\fB, int \fP\fImsglen\fP\fB, char *\fP\fIanswer\fP\fB,\fP

 .RS
 .RS

-.BI "int " anslen );
+\fBint \fP\fIanslen\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int dn_comp(unsigned char *" exp_dn ", unsigned char *" comp_dn ,
+\fBint dn_comp(unsigned char *\fP\fIexp_dn\fP\fB, unsigned char *\fP\fIcomp_dn\fP\fB,\fP

 .RS
 .RS

-.BI "int " length ", unsigned char **" dnptrs ", unsigned char **" lastdnptr );
+\fBint \fP\fIlength\fP\fB, unsigned char **\fP\fIdnptrs\fP\fB, unsigned char **\fP\fIlastdnptr\fP\fB);\fP

 .RE
 .sp
 .RE
 .sp

-.BI "int dn_expand(unsigned char *" msg ", unsigned char *" eomorig ,
+\fBint dn_expand(unsigned char *\fP\fImsg\fP\fB, unsigned char *\fP\fIeomorig\fP\fB,\fP

 .RS
 .RS

-.BI "unsigned char *" comp_dn ", char *" exp_dn ,
-.BI "int " length );
+\fBunsigned char *\fP\fIcomp_dn\fP\fB, char *\fP\fIexp_dn\fP\fB,\fP
+\fBint \fP\fIlength\fP\fB);\fP

 .RE
 .fi
 .sp
 .RE
 .fi
 .sp

-\fI\-lresolv\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
-.SH ÀâÌÀ
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¥¤¥ó¥¿¡¼¥Í¥Ã¥È¤Î¥É¥á¥¤¥ó¥Í¡¼¥à¥µ¡¼¥Ð¡¼¤ËÌ䤤¹ç¤ï¤»¡¢
-¤½¤Î±þÅú¤ò²ò¼á¤¹¤ë¡£
+\fI\-lresolv\fP でリンクする。
+.SH 説明
+これらの関数はインターネットのドメインネームサーバーに問い合わせ、 その応答を解釈する。

 .PP
 .PP

-.BR res_init ()
-´Ø¿ô¤Ï¡¢¥Ç¥Õ¥©¥ë¥È¤Î¥É¥á¥¤¥ó̾¡¢¸¡º÷½ç¡¢¥Í¡¼¥à¥µ¡¼¥Ð¡¼
-¥¢¥É¥ì¥¹¤òÆÀ¤ë¤¿¤á¤ËÀßÄê¥Õ¥¡¥¤¥ë (resolv.conf(5) »²¾È) ¤òÆɤࡣ
-¤â¤·¥µ¡¼¥Ð¡¼¤¬¼¨¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¥í¡¼¥«¥ë¥Û¥¹¥È¤ò»î¤¹¡£
-¥É¥á¥¤¥ó¤¬¼¨¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¥í¡¼¥«¥ë¥Û¥¹¥È¤ËÉÕ¤±¤é¤ì¤¿¥É¥á¥¤¥ó¤òÍѤ¤¤ë¡£
-´Ä¶­ÊÑ¿ô
-.B LOCALDOMAIN
-¤Ç¥ª¡¼¥Ð¡¼¥é¥¤¥É¤Ç¤­¤ë¡£
-.BR res_init ()
-¤Ï¡¢¸å½Ò¤¹¤ë´Ø¿ô¤Î¤É¤ì¤«¤¬ºÇ½é¤Ë¸Æ¤Ó½Ð¤µ¤ì¤¿»þ¡¢¤½¤Î´Ø¿ô
-¤«¤é¼Â¹Ô¤µ¤ì¤ë¡£
+\fBres_init\fP()  関数は、デフォルトのドメイン名、検索順、ネームサーバー アドレスを得るために設定ファイル
+(\fBresolv.conf\fP(5) 参照) を読む。 もしサーバーが示されていなければローカルホストを試す。
+ドメインが示されていなければローカルホストに付けられたドメインを用いる。 環境変数 \fBLOCALDOMAIN\fP でオーバーライドできる。
+\fBres_init\fP()  は、後述する関数のどれかが最初に呼び出された時、その関数 から実行される。

 .PP
 .PP

-.BR res_query ()
-´Ø¿ô¤Ï¡¢»ØÄꤵ¤ì¤¿ \fItype\fP ¤È \fIclass\fP ¤Î
-´°Á´½¤¾þ¥É¥á¥¤¥ó̾ (FQDN) \fIname\fP ¤ò¡¢¥Í¡¼¥à¥µ¡¼¥Ð¡¼¤ØÌ䤤¹ç¤ï¤»¤ë¡£
-±þÅú¤Ï¡¢¸Æ¤Ó½Ð¤·¤¿Â¦¤Ë¤è¤Ã¤ÆÍÑ°Õ¤µ¤ì¤ëŤµ \fIanslen\fP ¤Î \fIanswer\fP
-¥Ð¥Ã¥Õ¥¡¡¼¤Ë»Ä¤µ¤ì¤ë¡£
+\fBres_query\fP()  関数は、指定された \fItype\fP と \fIclass\fP の 完全修飾ドメイン名 (FQDN) \fIname\fP
+を、ネームサーバーへ問い合わせる。 応答は、呼び出した側によって用意される長さ \fIanslen\fP の \fIanswer\fP バッファーに残される。

 .PP
 .PP

-.BR res_search ()
-´Ø¿ô¤Ï¡¢Ì䤤¹ç¤ï¤»¤ò¹Ô¤¤
-.BR res_query ()
-ƱÍͤ½¤Î±þÅú¤ò
-ÂԤĤ¬¡¢¤µ¤é¤Ë¥Ç¥Õ¥©¥ë¥È¤ò¼ÂÁõ¤·¤Æ¤ª¤ê
-.B RES_DEFNAMES
-¤È
-.B RES_DNSRCH
-¤Ë¤è¤Ã¤Æµ¬Äꤵ¤ì¤ë¸¡º÷¥ë¡¼¥ë¤òŬÍѤ¹¤ë¡£
-(²¼µ­ \fI_res\fP ¥ª¥×¥·¥ç¥ó¤ÎÀâÌÀ¤ò»²¾È)
+\fBres_search\fP()  関数は、問い合わせを行い \fBres_query\fP()  同様その応答を 待つが、さらにデフォルトを実装しており
+\fBRES_DEFNAMES\fP と \fBRES_DNSRCH\fP によって規定される検索ルールを適用する。 (下記 \fI_res\fP
+オプションの説明を参照)

 .PP
 .PP

-.BR res_querydomain ()
-´Ø¿ô¤Ï \fIname\fP ¤È \fIdomain\fP ¤Î·ë¹ç¤Ë
-.BR res_query ()
-¤òÍѤ¤¤ÆÌ䤤¹ç¤ï¤»¤ò¹Ô¤¦¡£
+\fBres_querydomain\fP()  関数は \fIname\fP と \fIdomain\fP の結合に \fBres_query\fP()
+を用いて問い合わせを行う。

 .PP
 .PP

-¼¡¤Î´Ø¿ô¤Ï¡¢
-.BR res_query ()
-¤Ç»È¤ï¤ì¤ë²¼°Ì¥ë¡¼¥Á¥ó¤Ç¤¢¤ë¡£
+次の関数は、 \fBres_query\fP()  で使われる下位ルーチンである。

 .PP
 .PP

-.BR res_mkquery ()
-´Ø¿ô¤Ï¡¢¥É¥á¥¤¥ó̾ \fIdname\fP ¤Î°Ù¤Ë¡¢Ä¹¤µ \fIbuflen\fP
-¤Î \fIbuf\fP ¤ËÌ䤤¹ç¤ï¤»¤ë¥á¥Ã¥»¡¼¥¸¤òºîÀ®¤¹¤ë¡£
-Ì䤤¹ç¤ï¤»¤Î·¿ \fIop\fP ¤ÏÄ̾ï
-.B QUERY
-¤À¤¬¡¢ \fI<arpa/nameser.h>\fP ¤ÇÄêµÁ¤µ¤ì¤¿·¿¤Î¤É¤ì¤Ç¤âÎɤ¤¡£
-\fInewrr\fP ¤Ï¸½ºß»ÈÍѤµ¤ì¤Æ¤¤¤Ê¤¤¡£
+\fBres_mkquery\fP()  関数は、ドメイン名 \fIdname\fP の為に、長さ \fIbuflen\fP の \fIbuf\fP
+に問い合わせるメッセージを作成する。 問い合わせの型 \fIop\fP は通常 \fBQUERY\fP だが、
+\fI<arpa/nameser.h>\fP で定義された型のどれでも良い。 \fInewrr\fP は現在使用されていない。

 .PP
 .PP

-.BR res_send ()
-´Ø¿ô¤Ï¡¢Ä¹¤µ \fImsglen\fP ¤Î \fImsg\fP ¤Ë·è¤á¤é¤ì¤¿½ñ¼°
-¤ÇÌ䤤¹ç¤ï¤»¡¢\fIanswer\fP ¤ËŤµ \fIanslen\fP ¤Î²óÅú¤òÊÖ¤¹¡£
-¤Þ¤À¸Æ¤Ó½Ð¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð
-.BR res_init ()
-¤ò¸Æ¤Ó½Ð¤¹¡£
+\fBres_send\fP()  関数は、長さ \fImsglen\fP の \fImsg\fP に決められた書式 で問い合わせ、\fIanswer\fP に長さ
+\fIanslen\fP の回答を返す。 まだ呼び出されていなければ \fBres_init\fP()  を呼び出す。

 .PP
 .PP

-.BR dn_comp ()
-´Ø¿ô¤Ï¥É¥á¥¤¥ó̾ \fIexp_dn\fP ¤ò°µ½Ì¤·¤Æ¡¢Ä¹¤µ \fIlength\fP
-¤Î¥Ð¥Ã¥Õ¥¡¡¼ \fIcomp_dn\fP ¤ËÊݸ¤¹¤ë¡£
-°µ½Ì¤Ë¤Ï¥Ý¥¤¥ó¥¿¡¼ÇÛÎó \fIdnptrs\fP ¤òÍѤ¤¤ë¡£
-¤³¤ì¤é¤Î¥Ý¥¤¥ó¥¿¡¼¤Ï¡¢¸½ºß¤Î¥á¥Ã¥»¡¼¥¸¤ÎÃæ¤Ë¤¢¤ë°ÊÁ°¤Ë°µ½Ì¤µ¤ì¤¿Ì¾Á°¤ò»Ø¤¹¡£
-ºÇ½é¤Î¥Ý¥¤¥ó¥¿¡¼¤Ï¥á¥Ã¥»¡¼¥¸¤ÎËÁƬ¤ò»Ø¤·¡¢¤½¤Î¥ê¥¹¥È¤Ï NULL ¤Ç½ª¤ï¤ë¡£
-ÇÛÎó¤ÎÈÏ°Ï¤Ï \fIlastdnptr\fP ¤Ç·è¤á¤é¤ì¤ë¡£
-\fIdnptr\fP ¤¬ NULL ¤Ê¤é¤Ð¥É¥á¥¤¥ó̾¤Ï°µ½Ì¤µ¤ì¤Ê¤¤¡£
-\fIlastdnptr\fP ¤¬ NULL ¤Ê¤é¤Ð¡¢¤½¤Î¥é¥Ù¥ë¤Î¥ê¥¹¥È¤Ï¥¢¥Ã¥×¥Ç¡¼¥È¤µ¤ì¤Ê¤¤¡£
+\fBdn_comp\fP()  関数はドメイン名 \fIexp_dn\fP を圧縮して、長さ \fIlength\fP のバッファー \fIcomp_dn\fP に保存する。
+圧縮にはポインター配列 \fIdnptrs\fP を用いる。 これらのポインターは、現在のメッセージの中にある以前に圧縮された名前を指す。
+最初のポインターはメッセージの冒頭を指し、そのリストは NULL で終わる。 配列の範囲は \fIlastdnptr\fP で決められる。 \fIdnptr\fP
+が NULL ならばドメイン名は圧縮されない。 \fIlastdnptr\fP が NULL ならば、そのラベルのリストはアップデートされない。

 .PP
 .PP

-.BR dn_expand ()
-´Ø¿ô¤Ï¡¢°µ½Ì¤µ¤ì¤¿¥É¥á¥¤¥ó̾ \fIcomp_dn\fP ¤«¤é¥µ¥¤¥º
-¤¬ \fIlength\fP ¤Î \fIexp_dn\fP ¥Ð¥Ã¥Õ¥¡¡¼¤ËÀµ¼°¤Ê¥É¥á¥¤¥ó̾¤òŸ³«¤¹¤ë¡£
-¤½¤Î°µ½Ì¤µ¤ì¤¿Ì¾Á°¤Ï¡¢Ì䤤¹ç¤ï¤»¡¢¤Þ¤¿¤Ï±þÅú¥á¥Ã¥»¡¼¥¸¤Ë´Þ¤Þ¤ì¤Æ¤¤¤Æ¡¢
-\fImsg\fP ¤¬¥á¥Ã¥»¡¼¥¸¤ÎËÁƬ¤ò»Ø¤¹¡£
+\fBdn_expand\fP()  関数は、圧縮されたドメイン名 \fIcomp_dn\fP からサイズ が \fIlength\fP の \fIexp_dn\fP
+バッファーに正式なドメイン名を展開する。 その圧縮された名前は、問い合わせ、または応答メッセージに含まれていて、 \fImsg\fP
+がメッセージの冒頭を指す。

 .PP
 .PP

-¥ì¥¾¥ë¥Ð¡¦¥ë¡¼¥Á¥ó¤Ï¡¢\fI<resolv.h>\fP ¤ËÄêµÁ¤µ¤ì¤¿ \fI_res\fP ¹½Â¤ÂΤË
-´Þ¤Þ¤ì¤Æ¤¤¤ëÁ´ÂÎŪ¤ÊÀßÄê¤È¾õÂ֤ξðÊó¤ò»ÈÍѤ¹¤ë¡£
-Ä̾ï¥æ¡¼¥¶¡¼¤ËÁàºî¤Ç¤­¤ë¹àÌÜ¤Ï \fI_res.options\fP ¤À¤±¤Ç¤¢¤ë¡£
-¤³¤Î¹àÌܤϰʲ¼¤Î¥ª¥×¥·¥ç¥ó¤Î¥Ó¥Ã¥Èñ°Ì¤ÎÏÀÍýϤˤǤ­¤ë¡£
-.TP
-.B RES_INIT
-.BR res_init ()
-¤¬¸Æ¤Ó½Ð¤µ¤ì¤Æ¤¤¤ì¤Ð¿¿¡£
-.TP
-.B RES_DEBUG
-¥Ç¥Ð¥Ã¥°¡¦¥á¥Ã¥»¡¼¥¸¤ò½ÐÎϤ¹¤ë¡£
-.TP
-.B RES_AAONLY
-¸¢°ÒÉÕ¤±¤µ¤ì¤¿ (authoritative) ²óÅú¤Î¤ß¼õ¤±Æþ¤ì¤ë¡£
-.BR res_send ()
-¤Ï¡¢ºÇ½ªÅª¤Ë¸¢°ÒÉÕ¤±¤µ¤ì¤¿²óÅú¤òÆÀ¤é¤ì¤ë¤«¡¢¥¨¥é¡¼¤¬ÊÖ¤µ¤ì¤ë
-¤Þ¤Ç³¹Ô¤¹¤ë¡£
-[¸½ºß¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤]
-.TP
-.B RES_USEVC
-Ì䤤¹ç¤ï¤»¤Ë UDP ¥Ç¡¼¥¿¥°¥é¥à¤Ç¤Ï¤Ê¤¯ TCP Àܳ¤òÍѤ¤¤ë¡£
-.TP
-.B RES_PRIMARY
-¥×¥é¥¤¥Þ¥ê¡¦¥É¥á¥¤¥ó¥Í¡¼¥à¥µ¡¼¥Ð¡¼¤Î¤ßÌ䤤¹ç¤ï¤»¤ë¡£
-.TP
-.B RES_IGNTC
-ÀÚ¤êµÍ¤á¥¨¥é¡¼ (truncation error) ¤ò̵»ë¤¹¤ë¡£TCP ¤Ç¥ê¥È¥é¥¤¤·¤Ê¤¤¡£
-[¸½ºß¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤]
-.TP
-.B RES_RECURSE
-ºÆµ¢Í×µá (recursion desired) ¥Ó¥Ã¥È¤òÌ䤤¹ç¤ï¤»¤ËÀßÄꤹ¤ë¡£
-ºÆµ¢¤Ï
-.BR res_send ()
-¤Ç¤Ï¤Ê¤¯¥É¥á¥¤¥ó¥Í¡¼¥à¥µ¡¼¥Ð¡¼¤Ë¤è¤Ã¤Æ¹Ô¤ï¤ì¤ë¡£
-[¥Ç¥Õ¥©¥ë¥È¤ÇÍ­¸ú]
-.TP
-.B RES_DEFNAMES
-ÀßÄꤵ¤ì¤Æ¤¤¤ì¤Ð¡¢
-.BR res_search ()
-¤Ï¥Ç¥Õ¥©¥ë¥È¤Î¥É¥á¥¤¥ó̾¤ò°ìÉôʬ
-¤Î¤ß¤«¤é¤Ê¤ë̾Á°¡¢¤¹¤Ê¤ï¤Á¥É¥Ã¥È¤ò´Þ¤Þ¤Ê¤¤Ì¾Á°¤ËÉÕ¤±²Ã¤¨¤ë¡£
-[¥Ç¥Õ¥©¥ë¥È¤ÇÍ­¸ú]
-.TP
-.B RES_STAYOPEN
-Ì䤤¹ç¤ï¤»Ãæ¤Ë TCP Àܳ¤òÊݤĤ¿¤á
-.B RES_USEVC
-¤È¶¦¤ËÍѤ¤¤é¤ì¤ë¡£
-.TP
-.B RES_DNSRCH
-ÀßÄꤵ¤ì¤Æ¤¤¤ì¤Ð¡¢
-.BR res_search ()
-¤Ï¸½ºß¤Î¥É¥á¥¤¥ó¤ª¤è¤Ó¿Æ¥É¥á¥¤¥ó¤Î
-¥Û¥¹¥È̾¤òõ¤¹¡£¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï
-.BR gethostbyname (3)
-¤ÇÍѤ¤¤é¤ì¤ë¡£
-[¥Ç¥Õ¥©¥ë¥È¤ÇÍ­¸ú]
-.SH ÊÖ¤êÃÍ
-.BR res_init ()
-´Ø¿ô¤ÏÀ®¸ù¤¹¤ì¤Ð 0 ¤ò¡¢¥¨¥é¡¼¤¬È¯À¸¤¹¤ì¤Ð \-1 ¤òÊÖ¤¹¡£
+レゾルバ・ルーチンは、\fI<resolv.h>\fP に定義された \fI_res\fP 構造体に
+含まれている全体的な設定と状態の情報を使用する。 通常ユーザーに操作できる項目は \fI_res.options\fP だけである。
+この項目は以下のオプションのビット単位の論理和にできる。
+.TP 
+\fBRES_INIT\fP
+\fBres_init\fP()  が呼び出されていれば真。
+.TP 
+\fBRES_DEBUG\fP
+.\" See resolv/README.
+.\" Support for RES_DEBUG was made conditional in glibc 2.2.
+デバッグ情報を表示する。このオプションは、 glibc がデバッグを有効にしてコンパイルされている場合にのみ利用できる。 デフォルトでは glibc
+のデバッグは有効になっていない。
+.TP 
+\fBRES_AAONLY\fP
+権威付けされた (authoritative) 回答のみ受け入れる。 \fBres_send\fP()
+は、最終的に権威付けされた回答を得られるか、エラーが返される まで続行する。 [現在実装されていない]
+.TP 
+\fBRES_USEVC\fP
+問い合わせに UDP データグラムではなく TCP 接続を用いる。
+.TP 
+\fBRES_PRIMARY\fP
+プライマリ・ドメインネームサーバーのみ問い合わせる。
+.TP 
+\fBRES_IGNTC\fP
+切り詰めエラー (truncation error) を無視する。TCP でリトライしない。 [現在実装されていない]
+.TP 
+\fBRES_RECURSE\fP
+再帰要求 (recursion desired) ビットを問い合わせに設定する。 再帰は \fBres_send\fP()
+ではなくドメインネームサーバーによって行われる。 [デフォルトで有効]
+.TP 
+\fBRES_DEFNAMES\fP
+設定されていれば、 \fBres_search\fP()  はデフォルトのドメイン名を一部分 のみからなる名前、すなわちドットを含まない名前に付け加える。
+[デフォルトで有効]
+.TP 
+\fBRES_STAYOPEN\fP
+問い合わせ中に TCP 接続を保つため \fBRES_USEVC\fP と共に用いられる。
+.TP 
+\fBRES_DNSRCH\fP
+設定されていれば、 \fBres_search\fP()  は現在のドメインおよび親ドメインの ホスト名を探す。このオプションは
+\fBgethostbyname\fP(3)  で用いられる。 [デフォルトで有効]

 .PP
 .PP

-.BR res_query (),
-.BR res_search (),
-.BR res_querydomain (),
-.BR res_mkquery (),
-.BR res_send ()
-´Ø¿ô¤Ï±þÅú¤ÎŤµ¤òÊÖ¤¹¡£
-¤Þ¤¿¡¢¥¨¥é¡¼¤¬È¯À¸¤¹¤ì¤Ð \-1 ¤òÊÖ¤¹¡£
+このリストは完全なものではない。
+\fBresolv.conf\fP(5) には他にいくつかのフラグが記載されている。
+.SH 返り値
+\fBres_init\fP()  関数は成功すれば 0 を、エラーが発生すれば \-1 を返す。

 .PP
 .PP

-.BR dn_comp ()
-¤È
-.BR dn_expand ()
-´Ø¿ô¤Ï°µ½Ì¤µ¤ì¤¿¥É¥á¥¤¥ó̾¤ÎŤµ¤òÊÖ¤¹¡£
-¤Þ¤¿¡¢¥¨¥é¡¼¤¬È¯À¸¤¹¤ì¤Ð \-1 ¤òÊÖ¤¹¡£
-.SH ¥Õ¥¡¥¤¥ë
+\fBres_query\fP(), \fBres_search\fP(), \fBres_querydomain\fP(), \fBres_mkquery\fP(),
+\fBres_send\fP()  関数は応答の長さを返す。 また、エラーが発生すれば \-1 を返す。
+.PP
+\fBdn_comp\fP()  と \fBdn_expand\fP()  関数は圧縮されたドメイン名の長さを返す。 また、エラーが発生すれば \-1 を返す。
+.SH ファイル

 .nf
 .nf

-/etc/resolv.conf          ¥ì¥¾¥ë¥ÐÀßÄê¥Õ¥¡¥¤¥ë
-/etc/host.conf            ¥ì¥¾¥ë¥ÐÀßÄê¥Õ¥¡¥¤¥ë
+/etc/resolv.conf          レゾルバ設定ファイル
+/etc/host.conf            レゾルバ設定ファイル

 .fi
 .fi

-.SH ½àµò
+.SH 準拠

 4.3BSD.
 4.3BSD.

-.SH ´ØÏ¢¹àÌÜ
-.BR gethostbyname (3),
-.BR resolv.conf (5),
-.BR resolver (5),
-.BR hostname (7),
-.BR named (8)
+.SH 関連項目
+\fBgethostbyname\fP(3), \fBresolv.conf\fP(5), \fBresolver\fP(5), \fBhostname\fP(7),
+\fBnamed\fP(8)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。