OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / draft / man3 / getnameinfo.3
index 8e2878f..87c3a03 100644 (file)
@@ -46,9 +46,9 @@ _POSIX_SOURCE
 はリエントラントであり、IPv4 と IPv6 の差分に依存しないかたちで プログラムを書くことができる。
 
 \fIsa\fP 引き数は、 IP アドレスとポート番号の情報を保持している 汎用的なソケットアドレス構造体 (\fIsockaddr_in\fP 型または
-\fIsockaddr_in6\fP 型) へのポインタである。 \fIsalen\fP は \fIsa\fP のサイズである。 \fIhost\fP と \fIserv\fP
-å¼\95ã\81\8dæ\95°ã\81¯ã\80\81\81\9dã\82\8cã\81\9eã\82\8cã\82µã\82¤ã\82ºã\81\8c \fIhostlen\fP ã\81¨ \fIservlen\fP ã\81®) å\91¼ã\81³å\87ºã\81\97å\81´ã\81§ç¢ºä¿\9dã\81\95ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿であり、
-ホスト名とサービス名を含むヌル終端された文字列が それぞれのバッファに格納される。
+\fIsockaddr_in6\fP å\9e\8b) ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\80\82 \fIsalen\fP ã\81¯ \fIsa\fP ã\81®ã\82µã\82¤ã\82ºã\81§ã\81\82ã\82\8bã\80\82 \fIhost\fP ã\81¨ \fIserv\fP
+å¼\95ã\81\8dæ\95°ã\81¯ã\80\81\81\9dã\82\8cã\81\9eã\82\8cã\82µã\82¤ã\82ºã\81\8c \fIhostlen\fP ã\81¨ \fIservlen\fP ã\81®) å\91¼ã\81³å\87ºã\81\97å\81´ã\81§ç¢ºä¿\9dã\81\95ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼であり、
\83\9bã\82¹ã\83\88å\90\8dã\81¨ã\82µã\83¼ã\83\93ã\82¹å\90\8dã\82\92å\90«ã\82\80ã\83\8cã\83«çµ\82端ã\81\95ã\82\8cã\81\9fæ\96\87å­\97å\88\97ã\81\8c ã\81\9dã\82\8cã\81\9eã\82\8cã\81®ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\82\8bã\80\82
 
 ホスト名が不要であることをこの関数に伝えるには、 \fIhost\fP に NULL を指定するか、 \fIhostlen\fP に 0
 を指定する。同様に、サービス名が不要な場合は、 \fIserv\fP に NULL を指定するか、 \fIservlen\fP に 0 を指定する。
@@ -103,8 +103,8 @@ Domain Name; IDN) 形式との間で 透過的な変換ができるようにな
 .\" #define EAI_INTR        -104  /* Interrupted by a signal.  */
 .\" #define EAI_IDN_ENCODE  -105  /* IDN encoding failed.  */
 .\" #endif
-成功すると 0 が返り、(要求されていれば) ノードとサービスの名前がヌル終端された文字列の形式でそれぞれの指定バッファに返される
-(ã\83\90ã\83\83ã\83\95ã\82¡ã\81®é\95·ã\81\95ã\81«ã\81\82ã\81\86ã\82\88ã\81\86ã\81«ç¸®ã\82\81ã\82\89ã\82\8cã\82\8bã\81\8bã\82\82ã\81\97ã\82\8cã\81ªã\81\84\80\82 ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88ã\81¯ã\80\81以ä¸\8bã\81® 0 ä»¥å¤\96ã\81®ã\82¨ã\83©ã\83¼ã\83»コードが返される:
\88\90å\8a\9fã\81\99ã\82\8bã\81¨ 0 ã\81\8cè¿\94ã\82\8aã\80\81(è¦\81æ±\82ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8cã\81°) ã\83\8eã\83¼ã\83\89ã\81¨ã\82µã\83¼ã\83\93ã\82¹ã\81®å\90\8då\89\8dã\81\8cã\83\8cã\83«çµ\82端ã\81\95ã\82\8cã\81\9fæ\96\87å­\97å\88\97ã\81®å½¢å¼\8fã\81§ã\81\9dã\82\8cã\81\9eã\82\8cã\81®æ\8c\87å®\9aã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«è¿\94ã\81\95ã\82\8cã\82\8b
+(ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®é\95·ã\81\95ã\81«ã\81\82ã\81\86ã\82\88ã\81\86ã\81«ç¸®ã\82\81ã\82\89ã\82\8cã\82\8bã\81\8bã\82\82ã\81\97ã\82\8cã\81ªã\81\84\80\82 ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88ã\81¯ã\80\81以ä¸\8bã\81® 0 ä»¥å¤\96ã\81®ã\82¨ã\83©ã\83¼コードが返される:
 .TP 
 \fBEAI_AGAIN\fP
 指定された名前が現時点では解決できなかった。 後で再試行してみること。
@@ -119,19 +119,19 @@ Domain Name; IDN) 形式との間で 透過的な変換ができるようにな
 指定したアドレスファミリーが認識できなかった。 あるいはアドレスの長さが指定されたファミリーに合うものでなかった。
 .TP 
 \fBEAI_MEMORY\fP
-メモリが足りない。
\83¡ã\83¢ã\83ªã\83¼ã\81\8c足ã\82\8aã\81ªã\81\84ã\80\82
 .TP 
 \fBEAI_NONAME\fP
-与えられたパラメータでは名前が解決できない。 \fBNI_NAMEREQD\fP が設定されていたがホスト名が決定できなかったか、
+ä¸\8eã\81\88ã\82\89ã\82\8cã\81\9fã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81§ã\81¯å\90\8då\89\8dã\81\8c解決ã\81§ã\81\8dã\81ªã\81\84ã\80\82 \fBNI_NAMEREQD\fP ã\81\8c設å®\9aã\81\95ã\82\8cã\81¦ã\81\84ã\81\9fã\81\8cã\83\9bã\82¹ã\83\88å\90\8dã\81\8c決å®\9aã\81§ã\81\8dã\81ªã\81\8bã\81£ã\81\9fã\81\8bã\80\81
 ホスト名もサービス名も要求されなかった。
 .TP 
 \fBEAI_OVERFLOW\fP
-\fIhost\fP または \fIserv\fP が指しているバッファが小さすぎた。
+\fIhost\fP ã\81¾ã\81\9fã\81¯ \fIserv\fP ã\81\8cæ\8c\87ã\81\97ã\81¦ã\81\84ã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\8cå°\8fã\81\95ã\81\99ã\81\8eã\81\9fã\80\82
 .TP 
 \fBEAI_SYSTEM\fP
 システムエラーが起った。 エラーコードは \fIerrno\fP に設定される。
 .PP
-\fBgai_strerror\fP(3) 関数を使うと、これらのエラー・コードを、エラー・レポートに適した 人間が読みやすい文字列に翻訳してくれる。
+\fBgai_strerror\fP(3) 関数を使うと、 これらのエラーコードを、 エラーレポートに適した人間が読みやすい文字列に翻訳してくれる。
 .SH ファイル
 /etc/hosts
 .br
@@ -143,7 +143,7 @@ Domain Name; IDN) 形式との間で 透過的な変換ができるようにな
 .SH 準拠
 RFC\ 2553, POSIX.1\-2001.
 .SH 注意
-適切なバッファサイズを選択できるように、 \fI<netdb.h>\fP に以下の定数が定義されている。
\81©å\88\87ã\81ªã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82µã\82¤ã\82ºã\82\92é\81¸æ\8a\9eã\81§ã\81\8dã\82\8bã\82\88ã\81\86ã\81«ã\80\81 \fI<netdb.h>\fP ã\81«ä»¥ä¸\8bã\81®å®\9aæ\95°ã\81\8cå®\9a義ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\80\82
 .in +4n
 .nf
 
@@ -155,11 +155,10 @@ RFC\ 2553, POSIX.1\-2001.
 glibc 2.8 以降では、機能検査マクロ \fB_BSD_SOURCE\fP, \fB_SVID_SOURCE\fP, \fB_GNU_SOURCE\fP
 のいずれかが定義された場合にのみ、これらの定義が公開される。
 .PP
-前者は、最近のバージョンの BIND のヘッダファイル \fI<arpa/nameser.h>\fP 中の定数 \fBMAXDNAME\fP
\89\8dè\80\85ã\81¯ã\80\81æ\9c\80è¿\91ã\81®ã\83\90ã\83¼ã\82¸ã\83§ã\83³ã\81® BIND ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\83\95ã\82¡ã\82¤ã\83« \fI<arpa/nameser.h>\fP ä¸­ã\81®å®\9aæ\95° \fBMAXDNAME\fP
 と同じ値である。 後者は、割り当て済の数値について記した現在の RFC に 列挙されてサービスから推量した値である。
 
-Before glibc version 2.2, the \fIhostlen\fP and \fIservlen\fP arguments were typed
-as \fIsize_t\fP.
+glibc バージョン 2.2 より前では、 引き数 \fIhostlen\fP, \fIservlen\fP の型は \fIsize_t\fP であった。
 .SH 例
 以下のコードは、指定されたソケットアドレスに対する ホストとサービスの数値表式を取得しようと試みる。 特定のアドレスファミリーに対する参照情報は
 一切ハードコードされていないことに着目してほしい。
@@ -213,6 +212,6 @@ the freenix track: 2000 USENIX annual technical conference, June 2000
 .UR http://www.usenix.org\:/publications\:/library\:/proceedings\:/usenix2000\:/freenix\:/metzprotocol.html
 .UE .
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.76 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。