Convert release and draft pages to UTF-8.

[linuxjm/jm.git] / manual / LDP_man-pages / release / man3 / getservent.3

diff --git a/manual/LDP_man-pages/release/man3/getservent.3 b/manual/LDP_man-pages/release/man3/getservent.3
index 20d15de..2d00be7 100644 (file)
--- a/manual/LDP_man-pages/release/man3/getservent.3
+++ b/manual/LDP_man-pages/release/man3/getservent.3
@@ -35,9 +35,9 @@
 .\" Updated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
 .TH GETSERVENT 3  2008-08-19 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-getservent, getservbyname, getservbyport, setservent, endservent \- ¥µ¡¼¥Ó¥¹¤Î¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+getservent, getservbyname, getservbyport, setservent, endservent \- サービスのエントリを取得する
+.SH 書式
 .nf
 .B #include <netdb.h>
 .sp
@@ -51,44 +51,44 @@ getservent, getservbyname, getservbyport, setservent, endservent \- 
 .sp
 .B void endservent(void);
 .fi
-.SH ÀâÌÀ
+.SH 説明
 .BR getservent ()
-´Ø¿ô¤Ï¥µ¡¼¥Ó¥¹¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹
+é\96¢æ\95°ã\81¯ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹
 .RB ( services (5)
-»²¾È) ¤«¤é¼¡¤Î¥¨¥ó¥È¥ê¤òÆɤ߹þ¤ß¡¢
-¤½¤Î¥¨¥ó¥È¥ê¤ò \fIservent\fP ¹½Â¤ÂΤÎÍ×ÁÇÊ̤Υե£¡¼¥ë¥É¤Ë³ÊǼ¤·¡¢
-¤½¤Î¹½Â¤ÂΤòÊÖ¤¹¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+参照) から次のエントリを読み込み、
+そのエントリを \fIservent\fP 構造体の要素別のフィールドに格納し、
+その構造体を返す。
+必要であれば、データベースへの接続がオープンされる。
 .PP
 .BR getservbyname ()
-´Ø¿ô¤Ï¡¢
-¥×¥í¥È¥³¥ë \fIproto\fP ¤òÍѤ¤¤ë¥µ¡¼¥Ó¥¹¤Î̾Á° \fIname\fP
-¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢
-¤½¤Î¥¨¥ó¥È¥ê¤ò¼ý¤á¤¿ \fIservent\fP ¹½Â¤ÂΤòÊÖ¤¹¡£
-\fIproto\fP ¤¬ NULL ¤Î¾ì¹ç¤Ï¡¢Ç¤°Õ¤Î¥×¥í¥È¥³¥ë¤Ë¥Þ¥Ã¥Á¤¹¤ë¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+関数は、
+プロトコル \fIproto\fP を用いるサービスの名前 \fIname\fP
+にマッチするエントリをデータベースから探し、
+そのエントリを収めた \fIservent\fP 構造体を返す。
+\fIproto\fP が NULL の場合は、任意のプロトコルにマッチする。
+必要であれば、データベースへの接続がオープンされる。
 .PP
 .BR getservbyport ()
-´Ø¿ô¤Ï¡¢
-¥×¥í¥È¥³¥ë \fIproto\fP ¤òÍѤ¤¤ë¥µ¡¼¥Ó¥¹¤Î¥Ý¡¼¥ÈÈÖ¹æ \fIport\fP
-¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢
-¤½¤Î¥¨¥ó¥È¥ê¤ÎÆâÍƤò¼ý¤á¤¿ \fIservent\fP ¹½Â¤ÂΤòÊÖ¤¹
-(¥Ý¡¼¥ÈÈÖ¹æ \fIport\fP ¤Ï¥Í¥Ã¥È¥ï¡¼¥¯¡¦¥Ð¥¤¥È¥ª¡¼¥À¤Ç»ØÄꤹ¤ë)¡£
-\fIproto\fP ¤¬ NULL ¤Î¾ì¹ç¤ÏǤ°Õ¤Î¥×¥í¥È¥³¥ë¤Ë¥Þ¥Ã¥Á¤¹¤ë¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+関数は、
+プロトコル \fIproto\fP を用いるサービスのポート番号 \fIport\fP
+にマッチするエントリをデータベースから探し、
+そのエントリの内容を収めた \fIservent\fP 構造体を返す
+(ポート番号 \fIport\fP はネットワーク・バイトオーダで指定する)。
+\fIproto\fP が NULL の場合は任意のプロトコルにマッチする。
+必要であれば、データベースへの接続がオープンされる。
 .PP
 .BR setservent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥ª¡¼¥×¥ó¤·¡¢
-¼¡¤ÎÆɤ߹þ¤ß¥¨¥ó¥È¥ê¤òÀèƬ¤Î¥¨¥ó¥È¥ê¤ËÀßÄꤹ¤ë¡£
-\fIstayopen\fP ¤¬ 0 ¤Ç¤Ê¤¤¾ì¹ç¡¢
-°ì¤Ä°ì¤Ä¤Î
+関数はデータベースへの接続をオープンし、
+次の読み込みエントリを先頭のエントリに設定する。
+\fIstayopen\fP が 0 でない場合、
+一つ一つの
 .BR getserv* ()
-´Ø¿ô¤Î¸Æ¤Ó½Ð¤·´Ö¤Ç¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤·¤Ê¤¤¡£
+関数の呼び出し間でデータベースへの接続をクローズしない。
 .PP
 .BR endservent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
+関数はデータベースへの接続をクローズする。
 .PP
-\fIservent\fP ¹½Â¤ÂÎ¤Ï \fI<netdb.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+\fIservent\fP 構造体は \fI<netdb.h>\fP で以下のように定義されている。
 .sp
 .in +4n
 .nf
@@ -101,36 +101,36 @@ struct servent {
 .fi
 .in
 .PP
-\fIservent\fP ¹½Â¤ÂΤΥá¥ó¥Ð¡¼¤Ï°Ê²¼¤ÎÄ̤ꡣ
+\fIservent\fP 構造体のメンバーは以下の通り。
 .RS
 .TP 12
 .I s_name
-¥µ¡¼¥Ó¥¹¤ÎÀµ¼°Ì¾ (official name)¡£
+サービスの正式名 (official name)。
 .TP
 .I s_aliases
-¥µ¡¼¥Ó¥¹¤ÎÊÌ̾¤Î¥ê¥¹¥È¡£
-¥ê¥¹¥È¤Ï NULL ¤Ç½ªÃ¼¤µ¤ì¤ë¡£
+サービスの別名のリスト。
+リストは NULL で終端される。
 .TP
 .I s_port
-¥µ¡¼¥Ó¥¹¤Î¥Ý¡¼¥ÈÈֹ档¥Í¥Ã¥È¥ï¡¼¥¯¥Ð¥¤¥È¥ª¡¼¥À¤Ç»ØÄꤵ¤ì¤ë¡£
+サービスのポート番号。ネットワークバイトオーダで指定される。
 .TP
 .I s_proto
-¤³¤Î¥µ¡¼¥Ó¥¹¤È¶¦¤ËÍѤ¤¤ë¥×¥í¥È¥³¥ë¤Î̾Á°¡£
+このサービスと共に用いるプロトコルの名前。
 .RE
-.SH ÊÖ¤êÃÍ
+.SH 返り値
 .BR getservent (),
 .BR getservbyname (),
 .BR getservbyport ()
-´Ø¿ô¤Ï¡¢
-ÀÅŪ¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ \fIservent\fP ¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¤ê¡¢¥Õ¥¡¥¤¥ë¤ÎËöÈø¤Ë㤷¤¿¾ì¹ç¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-.SH ¥Õ¥¡¥¤¥ë
+関数は、
+静的に割り当てられた \fIservent\fP 構造体へのポインタを返す。
+エラーが起こったり、ファイルの末尾に達した場合は NULL ポインタを返す。
+.SH ファイル
 .TP
 .I /etc/services
-¥µ¡¼¥Ó¥¹¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.SH ½àµò
+サービスのデータベースファイル
+.SH 準拠
 4.3BSD, POSIX.1-2001.
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
 .BR getnetent (3),
 .BR getprotoent (3),
 .BR getservent_r (3),