.\" 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
.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
.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)