OSDN Git Service

(split) Convert release and draft pages to UTF-8.
[linuxjm/LDP_man-pages.git] / release / man3 / getnetent.3
index 65bb805..6762f14 100644 (file)
@@ -32,9 +32,9 @@
 .\" Updated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
 .TH GETNETENT 3  2008-08-19 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- ¥Í¥Ã¥È¥ï¡¼¥¯¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- ネットワークエントリを取得する
+.SH 書式
 .nf
 .B #include <netdb.h>
 .sp
@@ -48,35 +48,35 @@ getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- 
 .sp
 .B void endnetent(void);
 .fi
-.SH ÀâÌÀ
+.SH 説明
 .BR getnetent ()
-´Ø¿ô¤Ï¥Í¥Ã¥È¥ï¡¼¥¯¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤é¼¡¤Î¥¨¥ó¥È¥ê¤òÆɤ߹þ¤ß¡¢
-¤½¤Î¥¨¥ó¥È¥ê¤ò \fInetent\fP ¹½Â¤ÂΤÎÍ×ÁÇÊ̤Υե£¡¼¥ë¥É¤Ë³ÊǼ¤·¡¢
-¤½¤Î¹½Â¤ÂΤòÊÖ¤¹¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+関数はネットワークデータベースから次のエントリを読み込み、
+そのエントリを \fInetent\fP 構造体の要素別のフィールドに格納し、
+その構造体を返す。
+必要であれば、データベースへの接続がオープンされる。
 .PP
 .BR getnetbyname ()
-´Ø¿ô¤Ï¡¢¥Í¥Ã¥È¥ï¡¼¥¯Ì¾ \fIname\fP ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢¤½¤Î¥¨¥ó¥È¥ê¤ò¼ý¤á¤¿ \fInetent\fP ¹½Â¤ÂΤòÊÖ¤¹¡£
+関数は、ネットワーク名 \fIname\fP にマッチするエントリを
+データベースから探し、そのエントリを収めた \fInetent\fP 構造体を返す。
 .PP
 .BR getnetbyaddr ()
-´Ø¿ô¤Ï¡¢\fItype\fP ·¿¤Î¥Í¥Ã¥È¥ï¡¼¥¯ÈÖ¹æ \fInet\fP ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢¤½¤Î¥¨¥ó¥È¥ê¤ò¼ý¤á¤¿ \fInetent\fP ¹½Â¤ÂΤòÊÖ¤¹¡£
+関数は、\fItype\fP 型のネットワーク番号 \fInet\fP にマッチするエントリを
+データベースから探し、そのエントリを収めた \fInetent\fP 構造体を返す。
 .I net
-°ú¤­¿ô¤Ï¥Û¥¹¥È¡¦¥Ð¥¤¥È¥ª¡¼¥À¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+引き数はホスト・バイトオーダでなければならない。
 .PP
 .BR setnetent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥ª¡¼¥×¥ó¤·¡¢
-¼¡¤ÎÆɤ߹þ¤ß¥¨¥ó¥È¥ê¤òÀèƬ¤Î¥¨¥ó¥È¥ê¤ËÀßÄꤹ¤ë¡£
-\fIstayopen\fP ¤¬ 0 ¤Ç¤Ê¤¤¾ì¹ç¡¢
-°ì¤Ä°ì¤Ä¤Î
+関数はデータベースへの接続をオープンし、
+次の読み込みエントリを先頭のエントリに設定する。
+\fIstayopen\fP が 0 でない場合、
+一つ一つの
 .BR getnet* ()
-´Ø¿ô¤Î¸Æ¤Ó½Ð¤·´Ö¤Ç¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤·¤Ê¤¤¡£
+関数の呼び出し間でデータベースへの接続をクローズしない。
 .PP
 .BR endnetent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
+関数はデータベースへの接続をクローズする。
 .PP
-\fInetent\fP ¹½Â¤ÂΤϠ\fI<netdb.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+\fInetent\fP 構造体は \fI<netdb.h>\fP で以下のように定義されている。
 .sp
 .in +4n
 .nf
@@ -89,45 +89,45 @@ struct netent {
 .fi
 .in
 .PP
-\fInetent\fP ¹½Â¤ÂΤΥá¥ó¥Ð¤Ï°Ê²¼¤ÎÄ̤ꡣ
+\fInetent\fP 構造体のメンバは以下の通り。
 .RS
 .TP 12
 .I n_name
-¥Í¥Ã¥È¥ï¡¼¥¯¤ÎÀµ¼°Ì¾ (official name)¡£
+ネットワークの正式名 (official name)。
 .TP
 .I n_aliases
-¥Í¥Ã¥È¥ï¡¼¥¯¤ÎÊÌ̾¤«¤é¤Ê¤ë¥ê¥¹¥È¡£
-¥ê¥¹¥È¤Ï NULL ¤Ç½ªÃ¼¤µ¤ì¤ë¡£
+ネットワークの別名からなるリスト。
+リストは NULL で終端される。
 .TP
 .I n_addrtype
-¥Í¥Ã¥È¥ï¡¼¥¯ÈÖ¹æ¤Î·Á¼°¡£¸½ºß¤Ï
+ネットワーク番号の形式。現在は
 .B AF_INET
-¤Î¤ß¡£
+のみ。
 .TP
 .I n_net
-¥Û¥¹¥È¡¦¥Ð¥¤¥È¥ª¡¼¥À·Á¼°¤Î¥Í¥Ã¥È¥ï¡¼¥¯Èֹ档
+ホスト・バイトオーダ形式のネットワーク番号。
 .RE
-.SH ÊÖ¤êÃÍ
+.SH 返り値
 .BR getnetent (),
 .BR getnetbyname (),
 .BR getnetbyaddr ()
-´Ø¿ô¤Ï¡¢ÀÅŪ¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ \fInetent\fP ¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¤ê¡¢¥Õ¥¡¥¤¥ë¤ÎËöÈø¤Ë㤷¤¿¾ì¹ç¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-.SH ¥Õ¥¡¥¤¥ë
+関数は、静的に割り当てられた \fInetent\fP 構造体へのポインタを返す。
+エラーが起こったり、ファイルの末尾に達した場合は NULL ポインタを返す。
+.SH ファイル
 .TP
 .I /etc/networks
-¥Í¥Ã¥È¥ï¡¼¥¯¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.SH ½àµò
+ネットワークデータベースファイル
+.SH 準拠
 4.3BSD, POSIX.1-2001.
-.SH Ãí°Õ
-¥Ð¡¼¥¸¥ç¥ó 2.2 ¤è¤êÁ°¤Î glibc ¤Ç¤Ï¡¢
+.SH 注意
+バージョン 2.2 より前の glibc では、
 .BR getnetbyaddr ()
-¤Î°ú¤­¿ô
+の引き数
 .I net
-¤Ï
+は
 .I long
-·¿¤À¤Ã¤¿¡£
-.SH ´ØÏ¢¹àÌÜ
+型だった。
+.SH 関連項目
 .BR getnetent_r (3),
 .BR getprotoent (3),
 .BR getservent (3)