.\"
.TH GETNAMEINFO 3 2009-12-03 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O getnameinfo \- address-to-name translation in protocol-independent manner
-getnameinfo \- ¥¢¥É¥ì¥¹¤«¤é̾Á°¤Ø¤ÎÊÑ´¹¤ò¥×¥í¥È¥³¥ë¤Ë°Í¸¤·¤Ê¤¤¤«¤¿¤Á¤Ç¹Ô¤¦
+getnameinfo \- アドレスから名前への変換をプロトコルに依存しないかたちで行う
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <sys/socket.h>
.B #include <netdb.h>
.in -4n
.\"O Feature Test Macro Requirements for glibc (see
.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.ad l
.in
.sp
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
.ad b
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O The
.\"O .BR getnameinfo ()
.\"O function is the inverse of
.\"O is reentrant and allows programs to eliminate
.\"O IPv4-versus-IPv6 dependencies.
.BR getnameinfo ()
-´Ø¿ô¤Ï¡¢
+関数は、
.BR getaddrinfo (3)
-¤ÎµÕ¤ÎÆ°ºî¤ò¹Ô¤¦¡£¤Ä¤Þ¤ê¡¢¥×¥í¥È¥³¥ë¤Ë°Í¸¤·¤Ê¤¤¤«¤¿¤Á¤Ç
-¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¤«¤éÂбþ¤¹¤ë¥Û¥¹¥È̾¤È¥µ¡¼¥Ó¥¹¤Ø¤ÎÊÑ´¹¤ò¹Ô¤¦¡£
-¤³¤Î´Ø¿ô¤Ï
+の逆の動作を行う。つまり、プロトコルに依存しないかたちで
+ソケットアドレスから対応するホスト名とサービスへの変換を行う。
+この関数は
.BR gethostbyaddr (3)
-¤È
+と
.BR getservbyport (3)
-¤Îµ¡Ç½¤ò°ì¤Ä¤Ë¤·¤¿¤â¤Î¤À¤¬¡¢
-¤³¤ì¤é¤Î´Ø¿ô¤È°ã¤¤¡¢
+の機能を一つにしたものだが、
+これらの関数と違い、
.BR getnameinfo (3)
-¤Ï¥ê¥¨¥ó¥È¥é¥ó¥È¤Ç¤¢¤ê¡¢IPv4 ¤È IPv6 ¤Îº¹Ê¬¤Ë°Í¸¤·¤Ê¤¤¤«¤¿¤Á¤Ç
-¥×¥í¥°¥é¥à¤ò½ñ¤¯¤³¤È¤¬¤Ç¤¤ë¡£
+はリエントラントであり、IPv4 と IPv6 の差分に依存しないかたちで
+プログラムを書くことができる。
.\"O The
.\"O .I sa
.\"O .I salen
.\"O that holds the input IP address and port number.
.I sa
-°ú¤¿ô¤Ï¡¢
-IP ¥¢¥É¥ì¥¹¤È¥Ý¡¼¥ÈÈÖ¹æ¤Î¾ðÊó¤òÊÝ»ý¤·¤Æ¤¤¤ë
-ÈÆÍÑŪ¤Ê¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¹½Â¤ÂÎ
+引き数は、
+IP アドレスとポート番号の情報を保持している
+汎用的なソケットアドレス構造体
.RI ( sockaddr_in
-·¿¤Þ¤¿¤Ï
+型または
.I sockaddr_in6
-·¿) ¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
+型) へのポインタである。
.I salen
-¤Ï
+は
.I sa
-¤Î¥µ¥¤¥º¤Ç¤¢¤ë¡£
+のサイズである。
.\"O The arguments
.\"O .I host
.\"O and
.\"O places null-terminated strings containing the host and
.\"O service names respectively.
.I host
-¤È
+と
.I serv
-°ú¤¿ô¤Ï¡¢(¤½¤ì¤¾¤ì¥µ¥¤¥º¤¬
+引き数は、(それぞれサイズが
.I hostlen
-¤È
+と
.I servlen
-¤Î) ¸Æ¤Ó½Ð¤·Â¦¤Ç³ÎÊݤµ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ê¡¢
-¥Û¥¹¥È̾¤È¥µ¡¼¥Ó¥¹Ì¾¤ò´Þ¤à NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤¬
-¤½¤ì¤¾¤ì¤Î¥Ð¥Ã¥Õ¥¡¤Ë³ÊǼ¤µ¤ì¤ë¡£
+の) 呼び出し側で確保されたバッファへのポインタであり、
+ホスト名とサービス名を含む NULL 終端された文字列が
+それぞれのバッファに格納される。
.\"O The caller can specify that no hostname (or no service name)
.\"O is required by providing a NULL
.\"O argument.
.\"O However, at least one of hostname or service name
.\"O must be requested.
-¥Û¥¹¥È̾¤¬ÉÔÍפǤ¢¤ë¤³¤È¤ò¤³¤Î´Ø¿ô¤ËÅÁ¤¨¤ë¤Ë¤Ï¡¢
+ホスト名が不要であることをこの関数に伝えるには、
.I host
-¤Ë NULL ¤ò»ØÄꤹ¤ë¤«¡¢
+に NULL を指定するか、
.I hostlen
-¤Ë 0 ¤ò»ØÄꤹ¤ë¡£Æ±Íͤˡ¢¥µ¡¼¥Ó¥¹Ì¾¤¬ÉÔÍפʾì¹ç¤Ï¡¢
+に 0 を指定する。同様に、サービス名が不要な場合は、
.I serv
-¤Ë NULL ¤ò»ØÄꤹ¤ë¤«¡¢
+に NULL を指定するか、
.I servlen
-¤Ë 0 ¤ò»ØÄꤹ¤ë¡£
-¤·¤«¤·¡¢¥Û¥¹¥È̾¤È¥µ¡¼¥Ó¥¹Ì¾¤ÎξÊý¤òÉÔÍפÀ¤È»ØÄꤹ¤ë¤³¤È¤Ï¤Ç¤¤Ê¤¤
-(¤¤¤º¤ì¤«°ìÊý¤ÏÍ׵᤹¤ë¤³¤È)¡£
+に 0 を指定する。
+しかし、ホスト名とサービス名の両方を不要だと指定することはできない
+(いずれか一方は要求すること)。
.\"O The
.\"O .I flags
.\"O .BR getnameinfo ()
.\"O as follows:
.I flags
-°ú¤¿ô¤Ç
+引き数で
.BR getnameinfo ()
-¤ÎÆ°ºî¤òÊѤ¨¤ë¤³¤È¤¬¤Ç¤¤ë¡£»ØÄê¤Ç¤¤ëÃͤϰʲ¼¤ÎÄ̤ê:
+の動作を変えることができる。指定できる値は以下の通り:
.TP
.B NI_NAMEREQD
.\"O If set, then an error is returned if the hostname cannot be determined.
-»ØÄꤹ¤ë¤È¡¢¥Û¥¹¥È̾¤¬·èÄê¤Ç¤¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¥¨¥é¡¼¤òÊÖ¤¹¡£
+指定すると、ホスト名が決定できなかった場合にエラーを返す。
.TP
.B NI_DGRAM
.\"O If set, then the service is datagram (UDP) based rather than
.\"O stream (TCP) based.
.\"O This is required for the few ports (512-514)
.\"O that have different services for UDP and TCP.
-»ØÄꤹ¤ë¤È¡¢¥¹¥È¥ê¡¼¥à¥Ù¡¼¥¹ (TCP) ¤Ç¤Ê¤¯¥Ç¡¼¥¿¥°¥é¥à¥Ù¡¼¥¹ (UDP)
-¤Î¥µ¡¼¥Ó¥¹¤òÂоݤˤ¹¤ë¡£¿ô¤Ï¾¯¤Ê¤¤¤¬¡¢
-UDP ¤È TCP ¤Ç°ã¤¦¥µ¡¼¥Ó¥¹¤òÄ󶡤·¤Æ¤¤¤ë¥Ý¡¼¥È
-(512-514) ¤ËÂФ·¤ÆɬÍפȤʤ롣
+æ\8c\87å®\9aã\81\99ã\82\8bã\81¨ã\80\81ã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\83\99ã\83¼ã\82¹ (TCP) ã\81§ã\81ªã\81\8fã\83\87ã\83¼ã\82¿ã\82°ã\83©ã\83 ã\83\99ã\83¼ã\82¹ (UDP)
+のサービスを対象にする。数は少ないが、
+UDP と TCP で違うサービスを提供しているポート
+(512-514) に対して必要となる。
.TP
.B NI_NOFQDN
.\"O If set, return only the hostname part of the fully qualified domain name
.\"O for local hosts.
-»ØÄꤹ¤ë¤È¡¢¥í¡¼¥«¥ë¤Ê¥Û¥¹¥È¤Ë¤Ï fully qualified domain name (FQDN) ¤Î
-¥Û¥¹¥È̾¤ÎÉôʬ¤Î¤ß¤òÊÖ¤¹¡£
+指定すると、ローカルなホストには fully qualified domain name (FQDN) の
+ホスト名の部分のみを返す。
.TP
.B NI_NUMERICHOST
.\"O If set, then the numeric form of the hostname is returned.
.\"O .\" .BR gethostbyaddr ().
.\"O (When not set, this will still happen in case the node's name
.\"O cannot be determined.)
-»ØÄꤹ¤ë¤È¡¢¿ôÃÍ·Á¼°¤Î¥Û¥¹¥È̾¤¬ÊÖ¤µ¤ì¤ë¡£
-.\" Î㤨¤Ð
+指定すると、数値形式のホスト名が返される。
+.\" 例えば
.\" .BR gethostbyaddr ()
-.\" ¤ÎÂå¤ï¤ê¤Ë
+.\" の代わりに
.\" .BR inet_ntop ()
-.\" ¤ò¸Æ¤Ö
-(»ØÄꤷ¤Ê¤¯¤Æ¤â¡¢¥Î¡¼¥É¤Î̾Á°¤¬·èÄê¤Ç¤¤Ê¤¤¾ì¹ç¤Ï¿ôÃÍ·Á¼°¤¬Ê֤뤳¤È¤¬¤¢¤ë)¡£
+.\" を呼ぶ
+(指定しなくても、ノードの名前が決定できない場合は数値形式が返ることがある)。
.\" POSIX.1-2003 has NI_NUMERICSCOPE, but glibc doesn't have it.
.TP
.B NI_NUMERICSERV
.\"O If set, then the numeric form of the service address is returned.
.\"O (When not set, this will still happen in case the service's name
.\"O cannot be determined.)
-»ØÄꤹ¤ë¤È¡¢¿ôÃÍ·Á¼°¤Î¥µ¡¼¥Ó¥¹Ì¾ (Î㤨¤Ð¥Ý¡¼¥ÈÈÖ¹æ) ¤¬ÊÖ¤µ¤ì¤ë
-(»ØÄꤷ¤Ê¤¯¤Æ¤â¡¢¥µ¡¼¥Ó¥¹Ì¾¤¬·èÄê¤Ç¤¤Ê¤¤¾ì¹ç¤Ï¿ôÃÍ·Á¼°¤¬Ê֤뤳¤È¤¬¤¢¤ë)¡£
+指定すると、数値形式のサービス名 (例えばポート番号) が返される
+(指定しなくても、サービス名が決定できない場合は数値形式が返ることがある)。
.\"O .SS "Extensions to getaddrinfo() for Internationalized Domain Names"
-.SS "¹ñºÝ²½¥É¥á¥¤¥ó̾¤Î¤¿¤á¤Î getnameinfo() ¤Î³ÈÄ¥"
-.\"O motoki: ¸¶Ê¸¤Î getaddrinfo() ¤Ï getnameinfo() ¤Î´Ö°ã¤¤¤È»×¤ï¤ì¤ë¡£
+.SS "国際化ドメイン名のための getnameinfo() の拡張"
+.\"O motoki: 原文の getaddrinfo() は getnameinfo() の間違いと思われる。
.PP
.\"O Starting with glibc 2.3.4,
.\"O .BR getnameinfo ()
.\"O Internationalized Domain Name (IDN) format (see RFC 3490,
.\"O .IR "Internationalizing Domain Names in Applications (IDNA)" ).
.\"O Three new flags are defined:
-glibc 2.3.4 ¤«¤é¡¢
+glibc 2.3.4 から、
.BR getnameinfo ()
-¤Ë³ÈÄ¥¤¬¹Ô¤ï¤ì¡¢¥Û¥¹¥È̾¤È
-¹ñºÝ²½¥É¥á¥¤¥ó̾ (Internationalized Domain Name; IDN) ·Á¼°¤È¤Î´Ö¤Ç
-Æ©²áŪ¤ÊÊÑ´¹¤¬¤Ç¤¤ë¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë
-(IDN ·Á¼°¤Ë¤Ä¤¤¤Æ¤Ï RFC 3490 ¤Î
+に拡張が行われ、ホスト名と
+国際化ドメイン名 (Internationalized Domain Name; IDN) 形式との間で
+透過的な変換ができるようになっている
+(IDN 形式については RFC 3490 の
.I "Internationalizing Domain Names in Applications (IDNA)"
-¤ò»²¾È)¡£3¤Ä¤Î¥Õ¥é¥°¤¬¿·¤¿¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+を参照)。3つのフラグが新たに定義されている:
.TP
.B NI_IDN
.\"O If this flag is used, then the name found in the lookup process is
.\"O converted from IDN format to the locale's encoding if necessary.
.\"O ASCII-only names are not affected by the conversion, which
.\"O makes this flag usable in existing programs and environments.
-¤³¤Î¥Õ¥é¥°¤ò»ØÄꤹ¤ë¤È¡¢É¬ÍפǤ¢¤ì¤Ð¡¢¸¡º÷½èÍý¤Ç¸«¤Ä¤«¤Ã¤¿Ì¾Á°¤Ï
-IDN ·Á¼°¤«¤é¥í¥±¡¼¥ë¤Ë±þ¤¸¤¿Éä¹æ²½·Á¼°¤ËÊÑ´¹¤µ¤ì¤ë¡£
-ASCII ʸ»ú¤À¤±¤Î̾Á°¤Ï¤³¤ÎÊÑ´¹¤Ç¤Ï±Æ¶Á¤ò¼õ¤±¤Ê¤¤¡£¤³¤Î¤¿¤á¡¢
-´û¸¤Î¥×¥í¥°¥é¥à¤ä´Ä¶¤Ç¤³¤Î¥Õ¥é¥°¤ò»È¤¦¤³¤È¤¬¤Ç¤¤ë¡£
+このフラグを指定すると、必要であれば、検索処理で見つかった名前は
+IDN 形式からロケールに応じた符号化形式に変換される。
+ASCII 文字だけの名前はこの変換では影響を受けない。このため、
+既存のプログラムや環境でこのフラグを使うことができる。
.TP
.BR NI_IDN_ALLOW_UNASSIGNED ", " NI_IDN_USE_STD3_ASCII_RULES
.\"O Setting these flags will enable the
.\"O IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3
.\"O conforming host name)
.\"O flags respectively to be used in the IDNA handling.
-¤³¤ì¤é¤Î¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë¤È¡¢IDNA ½èÍý¤Ç»ÈÍѤµ¤ì¤ë¥Õ¥é¥°
-IDNA_ALLOW_UNASSIGNED (̤³ä¤êÅö¤Æ¤Î Unicode ¤Î¥³¡¼¥É¥Ý¥¤¥ó¥È¤òµöÍÆ) ¤È
-IDNA_USE_STD3_ASCII_RULES (½ÐÎϤ¬ STD3 ½àµò¤Î¥Û¥¹¥È̾¤«¤ò¥Á¥§¥Ã¥¯¤¹¤ë)
-¤¬¤½¤ì¤¾¤ì͸ú¤Ë¤Ê¤ë¡£
+ã\81\93ã\82\8cã\82\89ã\81®ã\83\95ã\83©ã\82°ã\82\92ã\82»ã\83\83ã\83\88ã\81\99ã\82\8bã\81¨ã\80\81IDNA å\87¦ç\90\86ã\81§ä½¿ç\94¨ã\81\95ã\82\8cã\82\8bã\83\95ã\83©ã\82°
+IDNA_ALLOW_UNASSIGNED (未割り当ての Unicode のコードポイントを許容) と
+IDNA_USE_STD3_ASCII_RULES (出力が STD3 準拠のホスト名かをチェックする)
+がそれぞれ有効になる。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\" FIXME glibc defines the following additional errors, some which
.\" can probably be returned by getnameinfo(); they need to
.\" be documented.
.\"O are filled with null-terminated strings, possibly truncated to fit
.\"O the specified buffer lengths.
.\"O On error one of the following nonzero error codes is returned:
-À®¸ù¤¹¤ë¤È 0 ¤¬Ê֤ꡢ(Í׵ᤵ¤ì¤Æ¤¤¤ì¤Ð) ¥Î¡¼¥É¤È¥µ¡¼¥Ó¥¹¤Î̾Á°¤¬
-NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Î·Á¼°¤Ç¤½¤ì¤¾¤ì¤Î»ØÄê¥Ð¥Ã¥Õ¥¡¤ËÊÖ¤µ¤ì¤ë
-(¥Ð¥Ã¥Õ¥¡¤ÎŤµ¤Ë¤¢¤¦¤è¤¦¤Ë½Ì¤á¤é¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤)¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï¡¢°Ê²¼¤Î 0 °Ê³°¤Î¥¨¥é¡¼¡¦¥³¡¼¥É¤¬ÊÖ¤µ¤ì¤ë:
+成功すると 0 が返り、(要求されていれば) ノードとサービスの名前が
+NULL 終端された文字列の形式でそれぞれの指定バッファに返される
+(バッファの長さにあうように縮められるかもしれない)。
+エラーの場合は、以下の 0 以外のエラー・コードが返される:
.TP
.B EAI_AGAIN
.\"O The name could not be resolved at this time.
.\"O Try again later.
-»ØÄꤵ¤ì¤¿Ì¾Á°¤¬¸½»þÅÀ¤Ç¤Ï²ò·è¤Ç¤¤Ê¤«¤Ã¤¿¡£
-¸å¤ÇºÆ»î¹Ô¤·¤Æ¤ß¤ë¤³¤È¡£
+指定された名前が現時点では解決できなかった。
+後で再試行してみること。
.TP
.B EAI_BADFLAGS
.\"O The
.\"O .I flags
.\"O argument has an invalid value.
.I flags
-°ú¤¿ô¤ËÉÔÀµ¤ÊÃͤ¬Í¿¤¨¤é¤ì¤¿¡£
+引き数に不正な値が与えられた。
.TP
.B EAI_FAIL
.\"O A nonrecoverable error occurred.
-²óÉü¤Ç¤¤Ê¤¤¥¨¥é¡¼¤¬È¯À¸¤·¤¿¡£
+回復できないエラーが発生した。
.TP
.B EAI_FAMILY
.\"O The address family was not recognized,
.\"O or the address length was invalid for the specified family.
-»ØÄꤷ¤¿¥¢¥É¥ì¥¹¥Õ¥¡¥ß¥ê¡¼¤¬Ç§¼±¤Ç¤¤Ê¤«¤Ã¤¿¡£
-¤¢¤ë¤¤¤Ï¥¢¥É¥ì¥¹¤ÎŤµ¤¬»ØÄꤵ¤ì¤¿¥Õ¥¡¥ß¥ê¡¼¤Ë¹ç¤¦¤â¤Î¤Ç¤Ê¤«¤Ã¤¿¡£
+指定したアドレスファミリーが認識できなかった。
+あるいはアドレスの長さが指定されたファミリーに合うものでなかった。
.TP
.B EAI_MEMORY
.\"O Out of memory.
-¥á¥â¥ê¤¬Â¤ê¤Ê¤¤¡£
+メモリが足りない。
.TP
.B EAI_NONAME
.\"O The name does not resolve for the supplied arguments.
.\"O .B NI_NAMEREQD
.\"O is set and the host's name cannot be located,
.\"O or neither hostname nor service name were requested.
-Í¿¤¨¤é¤ì¤¿¥Ñ¥é¥á¡¼¥¿¤Ç¤Ï̾Á°¤¬²ò·è¤Ç¤¤Ê¤¤¡£
+与えられたパラメータでは名前が解決できない。
.B NI_NAMEREQD
-¤¬ÀßÄꤵ¤ì¤Æ¤¤¤¿¤¬¥Û¥¹¥È̾¤¬·èÄê¤Ç¤¤Ê¤«¤Ã¤¿¤«¡¢
-¥Û¥¹¥È̾¤â¥µ¡¼¥Ó¥¹Ì¾¤âÍ׵ᤵ¤ì¤Ê¤«¤Ã¤¿¡£
+が設定されていたがホスト名が決定できなかったか、
+ホスト名もサービス名も要求されなかった。
.TP
.B EAI_OVERFLOW
.\"O The buffer pointed to by
.\"O .I serv
.\"O was too small.
.I host
-¤Þ¤¿¤Ï
+または
.I serv
-¤¬»Ø¤·¤Æ¤¤¤ë¥Ð¥Ã¥Õ¥¡¤¬¾®¤µ¤¹¤®¤¿¡£
+が指しているバッファが小さすぎた。
.TP
.B EAI_SYSTEM
.\"O A system error occurred.
.\"O The error code can be found in
.\"O .IR errno .
-¥·¥¹¥Æ¥à¥¨¥é¡¼¤¬µ¯¤Ã¤¿¡£
-¥¨¥é¡¼¥³¡¼¥É¤Ï
+システムエラーが起った。
+エラーコードは
.I errno
-¤ËÀßÄꤵ¤ì¤ë¡£
+に設定される。
.PP
.\"O The
.\"O .BR gai_strerror (3)
.\"O function translates these error codes to a human readable string,
.\"O suitable for error reporting.
.BR gai_strerror (3)
-´Ø¿ô¤ò»È¤¦¤È¡¢¤³¤ì¤é¤Î¥¨¥é¡¼¡¦¥³¡¼¥É¤ò¡¢¥¨¥é¡¼¡¦¥ì¥Ý¡¼¥È¤ËŬ¤·¤¿
-¿Í´Ö¤¬Æɤߤ䤹¤¤Ê¸»úÎó¤ËËÝÌõ¤·¤Æ¤¯¤ì¤ë¡£
+関数を使うと、これらのエラー・コードを、エラー・レポートに適した
+人間が読みやすい文字列に翻訳してくれる。
.\"O .SH FILES
-.SH ¥Õ¥¡¥¤¥ë
+.SH ファイル
/etc/hosts
.br
/etc/nsswitch.conf
.br
/etc/resolv.conf
.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
.\"O .BR getnameinfo ()
.\"O is provided in glibc since version 2.1.
.BR getnameinfo ()
-¤Ï¡¢glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤ÇÄ󶡤µ¤ì¤Æ¤¤¤ë¡£
+は、glibc バージョン 2.1 以降で提供されている。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
RFC\ 2553, POSIX.1-2001.
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O In order to assist the programmer in choosing reasonable sizes
.\"O for the supplied buffers,
.\"O .I <netdb.h>
.\"O defines the constants
-ŬÀڤʥХåե¡¥µ¥¤¥º¤òÁªÂò¤Ç¤¤ë¤è¤¦¤Ë¡¢
+適切なバッファサイズを選択できるように、
.I <netdb.h>
-¤Ë°Ê²¼¤ÎÄê¿ô¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+に以下の定数が定義されている。
.in +4n
.nf
.\"O or
.\"O .BR _GNU_SOURCE
.\"O is defined.
-glibc 2.8 °Ê¹ß¤Ç¤Ï¡¢µ¡Ç½¸¡ºº¥Þ¥¯¥í
+glibc 2.8 以降では、機能検査マクロ
.BR _BSD_SOURCE ,
.BR _SVID_SOURCE ,
.BR _GNU_SOURCE
-¤Î¤¤¤º¤ì¤«¤¬ÄêµÁ¤µ¤ì¤¿¾ì¹ç¤Ë¤Î¤ß¡¢¤³¤ì¤é¤ÎÄêµÁ¤¬¸ø³«¤µ¤ì¤ë¡£
+のいずれかが定義された場合にのみ、これらの定義が公開される。
.PP
.\"O The former is the constant
.\"O .B MAXDNAME
.\"O header file.
.\"O The latter is a guess based on the services listed
.\"O in the current Assigned Numbers RFC.
-Á°¼Ô¤Ï¡¢ºÇ¶á¤Î¥Ð¡¼¥¸¥ç¥ó¤Î BIND ¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë
+前者は、最近のバージョンの BIND のヘッダファイル
.I <arpa/nameser.h>
-Ãæ¤ÎÄê¿ô
+中の定数
.B MAXDNAME
-¤ÈƱ¤¸ÃͤǤ¢¤ë¡£
-¸å¼Ô¤Ï¡¢³ä¤êÅö¤ÆºÑ¤Î¿ôÃͤˤĤ¤¤Æµ¤·¤¿¸½ºß¤Î RFC ¤Ë
-Îóµó¤µ¤ì¤Æ¥µ¡¼¥Ó¥¹¤«¤é¿äÎ̤·¤¿ÃͤǤ¢¤ë¡£
+と同じ値である。
+後者は、割り当て済の数値について記した現在の RFC に
+列挙されてサービスから推量した値である。
.\"O .SH EXAMPLE
-.SH Îã
+.SH 例
.\"O The following code tries to get the numeric hostname and service name,
.\"O for a given socket address.
.\"O Note that there is no hardcoded reference to
.\"O a particular address family.
-°Ê²¼¤Î¥³¡¼¥É¤Ï¡¢»ØÄꤵ¤ì¤¿¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¤ËÂФ¹¤ë
-¥Û¥¹¥È¤È¥µ¡¼¥Ó¥¹¤Î¿ôÃÍɽ¼°¤ò¼èÆÀ¤·¤è¤¦¤È»î¤ß¤ë¡£
-ÆÃÄê¤Î¥¢¥É¥ì¥¹¥Õ¥¡¥ß¥ê¡¼¤ËÂФ¹¤ë»²¾È¾ðÊó¤Ï
-°ìÀڥϡ¼¥É¥³¡¼¥É¤µ¤ì¤Æ¤¤¤Ê¤¤¤³¤È¤ËÃåÌܤ·¤Æ¤Û¤·¤¤¡£
+以下のコードは、指定されたソケットアドレスに対する
+ホストとサービスの数値表式を取得しようと試みる。
+特定のアドレスファミリーに対する参照情報は
+一切ハードコードされていないことに着目してほしい。
.in +4n
.nf
.\"O The following version checks if the socket address has a
.\"O reverse address mapping.
-°Ê²¼¤Ç¤Ï¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¤Ë
-µÕ¸þ¤¤Î¥¢¥É¥ì¥¹¥Þ¥Ã¥Ô¥ó¥°¤¬Â¸ºß¤¹¤ë¤«¤ò¥Á¥§¥Ã¥¯¤·¤Æ¤¤¤ë¡£
+以下ではソケットアドレスに
+逆向きのアドレスマッピングが存在するかをチェックしている。
.in +4n
.nf
.\"O can be found in
.\"O .BR getaddrinfo (3).
.BR getnameinfo ()
-¤ò»È¤Ã¤¿¥×¥í¥°¥é¥àÎ㤬
+を使ったプログラム例が
.BR getaddrinfo (3)
-¤ËµºÜ¤µ¤ì¤Æ¤¤¤ë¡£
+に記載されている。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR accept (2),
.BR getpeername (2),
.BR getsockname (2),
OSDN Git Service
