OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / release / man3 / getaddrinfo.3
index 6cf62a6..1d0b0dc 100644 (file)
@@ -137,7 +137,7 @@ struct addrinfo {
 \fIai_flags\fP
 このフィールドは、追加のオプション (下記) を指定する。 複数のフラグを指定する際には、それらのビット単位の OR をとって指定する。
 .PP
-\fIhints\fP が指し示す構造体の他のすべてのフィールドには 0 かヌルポインタを適切に入れなければならない。
+\fIhints\fP ã\81\8cæ\8c\87ã\81\97示ã\81\99æ§\8bé\80 ä½\93ã\81®ä»\96ã\81®ã\81\99ã\81¹ã\81¦ã\81®ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81«ã\81¯ 0 ã\81\8bã\83\8cã\83«ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92é\81©å\88\87ã\81«å\85¥ã\82\8cã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84ã\80\82
 .PP
 \fIhints\fP に NULL を指定するのは、 \fIai_socktype\fP と \fIai_protocol\fP に 0 を、 \fIai_family\fP
 に \fBAF_UNSPEC\fP を、 \fIai_flags\fP に \fB(AI_V4MAPPED\ |\ AI_ADDRCONFIG)\fP
@@ -150,14 +150,14 @@ IPv6 の場合は \fBinet_pton\fP(3)  でサポートされている 16 進数
 .PP
 \fIhints.ai_flags\fP に \fBAI_PASSIVE\fP フラグが指定され、かつ \fInode\fP が NULL の場合、
 返されるソケットアドレスは コネクションを \fBaccept\fP(2)  するためのソケットを \fBbind\fP(2)  するのに適したものとなる。
-è¿\94ã\81\95ã\82\8cã\82\8bã\82½ã\82±ã\83\83ã\83\88ã\82¢ã\83\89ã\83¬ã\82¹ã\81«ã\81¯ã\80\8cã\83¯ã\82¤ã\83«ã\83\89ã\82«ã\83¼ã\83\89ã\83»ã\82¢ã\83\89ã\83¬ã\82¹ã\80\8d (IPv4 ã\82¢ã\83\89ã\83¬ã\82¹ã\81®å ´å\90\88ã\81¯ \fBINADDR_ANY\fPã\80\81 IPv6 ã\82¢ã\83\89ã\83¬ã\82¹ã\81®å ´å\90\88ã\81¯
-\fBIN6ADDR_ANY_INIT\fP)  ã\81\8cå\85¥ã\82\8bã\80\82 ã\83¯ã\82¤ã\83«ã\83\89ã\82«ã\83¼ã\83\89ã\83»ã\82¢ã\83\89ã\83¬ã\82¹ã\81¯ã\80\81ä»»æ\84\8fã\81®ã\83\9bã\82¹ã\83\88ã\81®ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82¢ã\83\89ã\83¬ã\82¹ã\81§æ\8e¥ç¶\9aã\82\92
+返されるソケットアドレスには「ワイルドカードアドレス」 (IPv4 アドレスの場合は \fBINADDR_ANY\fP、 IPv6 アドレスの場合は
+\fBIN6ADDR_ANY_INIT\fP)  が入る。 ワイルドカードアドレスは、任意のホストのネットワークアドレスで接続を
 受け付けようとするアプリケーション (通常はサーバー) で用いられる。 \fInode\fP が NULL でない場合、 \fBAI_PASSIVE\fP
 フラグは無視される。
 .PP
 \fIhints.ai_flags\fP に \fBAI_PASSIVE\fP フラグがセットされていない場合、 返されるソケットアドレスは
 \fBconnect\fP(2), \fBsendto\fP(2), \fBsendmsg\fP(2)  での使用に適したものとなる。 \fInode\fP が NULL
\81®å ´å\90\88ã\80\81ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82¢ã\83\89ã\83¬ã\82¹ã\81«ã\81¯ã\83«ã\83¼ã\83\97ã\83\90ã\83\83ã\82¯ã\83»ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\82¤ã\82¹ã\81® ã\82¢ã\83\89ã\83¬ã\82¹ (IPv4 ã\82¢ã\83\89ã\83¬ã\82¹ã\81®å ´å\90\88ã\81¯ \fBINADDR_LOOPBACK\fP IPv6
+の場合、ネットワークアドレスにはループバックインターフェイスの アドレス (IPv4 アドレスの場合は \fBINADDR_LOOPBACK\fP IPv6
 アドレスの場合は \fBIN6ADDR_LOOPBACK_INIT\fP)\fBが設定される。\fP これは同じホスト上で動作している接続相手と通信するような
 アプリケーションで用いられる。
 .PP
@@ -170,9 +170,9 @@ IPv6 の場合は \fBinet_pton\fP(3)  でサポートされている 16 進数
 .PP
 \fInode\fP と \fIservice\fP のどちらかは NULL にしてよいが、両方同時に NULL にしてはならない。
 .PP
-\fBgetaddrinfo\fP()  関数は、 \fIaddrinfo\fP 構造体のメモリ確保を行い、 \fIaddrinfo\fP
-æ§\8bé\80 ä½\93ã\81®ã\83ªã\83³ã\82¯ã\83ªã\82¹ã\83\88ã\82\92å\88\9dæ\9c\9få\8c\96ã\81\97ã\80\81 \fIres\fP ã\81«ã\83ªã\82¹ã\83\88ã\81®å\85\88é ­ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\82\92å\85¥ã\82\8cã\81¦è¿\94ã\81\99ã\80\82 ã\81\93ã\81®ã\81¨ã\81\8dã\80\81å\90\84æ§\8bé\80 ä½\93ã\81®ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82¢ã\83\89ã\83¬ã\82¹ã\81¯ \fInode\fP ã\81¨
-\fIservice\fP に一致し、 \fIhints\fP で課されたすべての制限を満たすものとなる。 リンクリストの要素は \fIai_next\fP
+\fBgetaddrinfo\fP()  関数は、 \fIaddrinfo\fP 構造体のメモリ確保を行い、 \fIaddrinfo\fP
+æ§\8bé\80 ä½\93ã\81®ã\83ªã\83³ã\82¯ã\83ªã\82¹ã\83\88ã\82\92å\88\9dæ\9c\9få\8c\96ã\81\97ã\80\81 \fIres\fP ã\81«ã\83ªã\82¹ã\83\88ã\81®å\85\88é ­ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92å\85¥ã\82\8cã\81¦è¿\94ã\81\99ã\80\82 ã\81\93ã\81®ã\81¨ã\81\8dã\80\81å\90\84æ§\8bé\80 ä½\93ã\81®ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82¢ã\83\89ã\83¬ã\82¹ã\81¯ \fInode\fP
+と \fIservice\fP に一致し、 \fIhints\fP で課されたすべての制限を満たすものとなる。 リンクリストの要素は \fIai_next\fP
 フィールドにより連結される。
 
 リンクリストの \fIaddrinfo\fP 構造体は複数個になることもあり、その理由はいくつかある。 ネットワークホストがマルチホームである、
@@ -190,12 +190,12 @@ IPv6 の場合は \fBinet_pton\fP(3)  でサポートされている 16 進数
 
 返される各々の \fIaddrinfo\fP 構造体の残りのフィールドは以下のように初期化される。
 .IP * 2
-\fIai_family\fP, \fIai_socktype\fP, \fIai_protocol\fP フィールドはソケット生成パラメータを返す
+\fIai_family\fP, \fIai_socktype\fP, \fIai_protocol\fP ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81¯ã\82½ã\82±ã\83\83ã\83\88ç\94\9fæ\88\90ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\82\92è¿\94ã\81\99
 (これらのフィールドの意味は \fBsocket\fP(2)  の同じ名前の引き数と同じである)。 例えば、 \fIai_family\fP は
 \fBAF_INET\fP や \fBAF_INET6\fP を返し、 \fIai_socktype\fP は \fBSOCK_DGRAM\fP や
 \fBSOCK_STREAM\fP を返し、 \fIai_protocol\fP はそのソケットのプロトコルを返す。
 .IP *
-\fIai_addr\fP フィールドにはソケットアドレスへのポインタが書き込まれ、 \fIai_addrlen\fP
+\fIai_addr\fP ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81«ã\81¯ã\82½ã\82±ã\83\83ã\83\88ã\82¢ã\83\89ã\83¬ã\82¹ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81\8cæ\9b¸ã\81\8dè¾¼ã\81¾ã\82\8cã\80\81 \fIai_addrlen\fP
 フィールドにはソケットアドレスの長さがバイト単位で書き込まれる。
 .PP
 \fIhints.ai_flags\fP が \fBAI_ADDRCONFIG\fP を含む場合、 \fIres\fP が指すリストには、ローカルシステムに最低一つの
@@ -210,7 +210,7 @@ IPv6 アドレスが返される。 \fIhints.ai_flags\fP に \fBAI_V4MAPPED\fP 
 の両方が指定されている場合、 \fIres\fP が指すリストには IPv6 アドレスと IPv4\-mapped IPv6 アドレスの 両方が返される。
 \fBAI_V4MAPPED\fP が指定されていない場合、 \fBAI_ALL\fP は無視される。
 .PP
-\fBfreeaddrinfo\fP()  関数は、 リンクリスト \fIres\fP に対して動的に割り当てられたメモリを解放する。
+\fBfreeaddrinfo\fP()  é\96¢æ\95°ã\81¯ã\80\81 ã\83ªã\83³ã\82¯ã\83ªã\82¹ã\83\88 \fIres\fP ã\81«å¯¾ã\81\97ã\81¦å\8b\95ç\9a\84ã\81«å\89²ã\82\8aå½\93ã\81¦ã\82\89ã\82\8cã\81\9fã\83¡ã\83¢ã\83ªã\83¼ã\82\92解æ\94¾ã\81\99ã\82\8bã\80\82
 .SS "国際化ドメイン名のための getaddrinfo() の拡張"
 .PP
 glibc 2.3.4 から、 \fBgetaddrinfo\fP()  は入出力するホスト名を透過的に国際化ドメイン名 (IDN) 形式 (RFC 3490
@@ -278,7 +278,7 @@ glibc 2.3.4 から、 \fBgetaddrinfo\fP()  は入出力するホスト名を透
 要求されたアドレスファミリーがサポートされていない。
 .TP 
 \fBEAI_MEMORY\fP
-メモリが足りない。
\83¡ã\83¢ã\83ªã\83¼ã\81\8c足ã\82\8aã\81ªã\81\84ã\80\82
 .TP 
 \fBEAI_NODATA\fP
 .\" Not in SUSv3
@@ -291,7 +291,7 @@ glibc 2.3.4 から、 \fBgetaddrinfo\fP()  は入出力するホスト名を透
 .TP 
 \fBEAI_SERVICE\fP
 要求されたサービスは、要求されたソケットタイプでは利用できない。 他のソケットタイプでなら利用可能かもしれない。 このエラーが発生する例としては、
-\fIservice\fP ã\81\8c "shell" (ã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\83»ã\82½ã\82±ã\83\83ã\83\88ã\81§ã\81®ã\81¿å\88©ç\94¨ã\81§ã\81\8dã\82\8bã\82µã\83¼ã\83\93ã\82¹) ã\81§ã\80\81 \fIhints.ai_protocol\fP ã\81«
+\fIservice\fP が "shell" (ストリームソケットでのみ利用できるサービス) で、 \fIhints.ai_protocol\fP に
 \fBIPPROTO_UDP\fP が指定されたり、 \fIhints.ai_socktype\fP に \fBSOCK_DGRAM\fP が指定されたりした場合がある。
 また、 \fIservice\fP が NULL 以外で、 \fIhints.ai_socktype\fP に \fBSOCK_RAW\fP
 (サービスの考え方をサポートしていないソケット種別)  が指定された場合にも、このエラーが発生する。
@@ -525,6 +525,6 @@ main(int argc, char *argv[])
 \fBgetaddrinfo_a\fP(3), \fBgethostbyname\fP(3), \fBgetnameinfo\fP(3), \fBinet\fP(3),
 \fBgai.conf\fP(5), \fBhostname\fP(7), \fBip\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.77 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。