OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man3 / getprotoent.3
index 4c18aca..dedf5d3 100644 (file)
 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 19:26:03 1993 by Rik Faith (faith@cs.unc.edu)
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
-.\" Translated Fri Mar 15 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" Updated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH GETPROTOENT 3  2008-08-19 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
-.\"O getprotoent, getprotobyname, getprotobynumber, setprotoent,
-.\"O endprotoent \- get protocol entry
-.SH Ì¾Á°
+.\"*******************************************************************
+.TH GETPROTOENT 3 2008\-08\-19 GNU "Linux Programmer's Manual"
+.SH 名前
 getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent \-
-¥×¥í¥È¥³¥ë¤Î¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+プロトコルのエントリを取得する
+.SH 書式
 .nf
-.B #include <netdb.h>
+\fB#include <netdb.h>\fP
 .sp
-.B struct protoent *getprotoent(void);
+\fBstruct protoent *getprotoent(void);\fP
 .sp
-.BI "struct protoent *getprotobyname(const char *" name );
+\fBstruct protoent *getprotobyname(const char *\fP\fIname\fP\fB);\fP
 .sp
-.BI "struct protoent *getprotobynumber(int " proto );
+\fBstruct protoent *getprotobynumber(int \fP\fIproto\fP\fB);\fP
 .sp
-.BI "void setprotoent(int " stayopen );
+\fBvoid setprotoent(int \fP\fIstayopen\fP\fB);\fP
 .sp
-.B void endprotoent(void);
+\fBvoid endprotoent(void);\fP
 .fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR getprotoent ()
-.\"O function reads the next entry from the protocols database (see
-.\"O .BR protocols (5))
-.\"O and returns a \fIprotoent\fP structure
-.\"O containing the broken-out fields from the entry.
-.\"O A connection is opened to the database if necessary.
-.BR getprotoent ()
-´Ø¿ô¤Ï¡¢¥×¥í¥È¥³¥ë¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹
-.RB ( protocols (5)
-»²¾È) ¤«¤é¼¡¤Î¥¨¥ó¥È¥ê¤òÆɤ߹þ¤ß¡¢
-¤½¤Î¥¨¥ó¥È¥ê¤ò \fIprotoent\fP ¹½Â¤ÂΤÎÍ×ÁÇÊ̤Υե£¡¼¥ë¥É¤Ë³ÊǼ¤·¡¢
-¤½¤Î¹½Â¤ÂΤòÊÖ¤¹¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+.SH 説明
+\fBgetprotoent\fP()  関数は、プロトコルのデータベース (\fBprotocols\fP(5)  参照) から次のエントリを読み込み、
+そのエントリを \fIprotoent\fP 構造体の要素別のフィールドに格納し、 その構造体を返す。 必要であれば、データベースへの接続がオープンされる。
 .PP
-.\"O The
-.\"O .BR getprotobyname ()
-.\"O function returns a \fIprotoent\fP structure
-.\"O for the entry from the database
-.\"O that matches the protocol name \fIname\fP.
-.\"O A connection is opened to the database if necessary.
-.BR getprotobyname ()
-´Ø¿ô¤Ï¡¢¥×¥í¥È¥³¥ë̾ \fIname\fP ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢¤½¤Î¥¨¥ó¥È¥ê¤ò¼ý¤á¤¿ \fIprotoent\fP ¹½Â¤ÂΤòÊÖ¤¹¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+\fBgetprotobyname\fP()  関数は、プロトコル名 \fIname\fP にマッチするエントリを データベースから探し、そのエントリを収めた
+\fIprotoent\fP 構造体を返す。 必要であれば、データベースへの接続がオープンされる。
 .PP
-.\"O The
-.\"O .BR getprotobynumber ()
-.\"O function returns a \fIprotoent\fP structure
-.\"O for the entry from the database
-.\"O that matches the protocol number \fInumber\fP.
-.\"O A connection is opened to the database if necessary.
-.BR getprotobynumber ()
-´Ø¿ô¤Ï¡¢¥×¥í¥È¥³¥ëÈÖ¹æ \fInumber\fP ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤ò
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤éõ¤·¡¢¤½¤Î¥¨¥ó¥È¥ê¤ò¼ý¤á¤¿ \fIprotoent\fP ¹½Â¤ÂΤòÊÖ¤¹¡£
-ɬÍפǤ¢¤ì¤Ð¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
+\fBgetprotobynumber\fP()  関数は、プロトコル番号 \fInumber\fP にマッチするエントリを
+データベースから探し、そのエントリを収めた \fIprotoent\fP 構造体を返す。 必要であれば、データベースへの接続がオープンされる。
 .PP
-.\"O The
-.\"O .BR setprotoent ()
-.\"O function opens a connection to the database,
-.\"O and sets the next entry to the first entry.
-.\"O If \fIstayopen\fP is nonzero,
-.\"O then the connection to the database
-.\"O will not be closed between calls to one of the
-.\"O .BR getproto* ()
-.\"O functions.
-.BR setprotoent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥ª¡¼¥×¥ó¤·¡¢
-¼¡¤ÎÆɤ߹þ¤ß¥¨¥ó¥È¥ê¤òÀèƬ¤Î¥¨¥ó¥È¥ê¤ËÀßÄꤹ¤ë¡£
-\fIstayopen\fP ¤¬ 0 ¤Ç¤Ê¤¤¾ì¹ç¡¢
-°ì¤Ä°ì¤Ä¤Î
-.BR getproto* ()
-´Ø¿ô¤Î¸Æ¤Ó½Ð¤·´Ö¤Ç¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤·¤Ê¤¤¡£
+\fBsetprotoent\fP()  関数はデータベースへの接続をオープンし、 次の読み込みエントリを先頭のエントリに設定する。 \fIstayopen\fP
+が 0 でない場合、 一つ一つの \fBgetproto*\fP()  関数の呼び出し間でデータベースへの接続をクローズしない。
 .PP
-.\"O The
-.\"O .BR endprotoent ()
-.\"O function closes the connection to the database.
-.BR endprotoent ()
-´Ø¿ô¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀܳ¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
+\fBendprotoent\fP()  関数はデータベースへの接続をクローズする。
 .PP
-.\"O The \fIprotoent\fP structure is defined in \fI<netdb.h>\fP as follows:
-\fIprotoent\fP ¹½Â¤ÂΤϠ\fI<netdb.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+\fIprotoent\fP 構造体は \fI<netdb.h>\fP で以下のように定義されている。
 .sp
 .in +4n
 .nf
@@ -127,52 +75,26 @@ struct protoent {
 .fi
 .in
 .PP
-.\"O The members of the \fIprotoent\fP structure are:
-\fIprotoent\fP ¹½Â¤ÂΤΥá¥ó¥Ð¡¼¤Ï°Ê²¼¤ÎÄ̤ꡣ
-.RS
-.TP 12
-.I p_name
-.\"O The official name of the protocol.
-¥×¥í¥È¥³¥ë¤ÎÀµ¼°Ì¾ (official name)¡£
-.TP
-.I p_aliases
-.\"O A NULL-terminated list of alternative names for the protocol.
-¥×¥í¥È¥³¥ë¤ÎÊÌ̾¤Î¥ê¥¹¥È¡£
-¥ê¥¹¥È¤Ï NULL ¤Ç½ªÃ¼¤µ¤ì¤ë¡£
-.TP
-.I p_proto
-.\"O The protocol number.
-¥×¥í¥È¥³¥ë¤ÎÈÖ¹æ
-.RE
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR getprotoent (),
-.\"O .BR getprotobyname ()
-.\"O and
-.\"O .BR getprotobynumber ()
-.\"O functions return a pointer to a
-.\"O statically allocated \fIprotoent\fP structure, or a NULL pointer if an
-.\"O error occurs or the end of the file is reached.
-.BR getprotoent (),
-.BR getprotobyname (),
-.BR getprotobynumber ()
-´Ø¿ô¤Ï¡¢ÀÅŪ¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ \fIprotoent\fP ¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¤ê¡¢¥Õ¥¡¥¤¥ë¤ÎºÇ¸å¤Ë㤷¤¿¾ì¹ç¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-.\"O .SH FILES
-.SH ¥Õ¥¡¥¤¥ë
+\fIprotoent\fP 構造体のメンバーは以下の通り。
+.TP 
+\fIp_name\fP
+プロトコルの正式名 (official name)。
+.TP 
+\fIp_aliases\fP
+プロトコルの別名のリスト。 リストは NULL で終端される。
+.TP 
+\fIp_proto\fP
+プロトコルの番号
+.SH 返り値
+\fBgetprotoent\fP(), \fBgetprotobyname\fP(), \fBgetprotobynumber\fP()  関数は、静的に割り当てられた
+\fIprotoent\fP 構造体へのポインタを返す。 エラーが起こったり、ファイルの最後に達した場合は NULL ポインタを返す。
+.SH ファイル
 .PD 0
-.TP
-.I /etc/protocols
-.\"O protocol database file
-¥×¥í¥È¥³¥ë¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
+.TP 
+\fI/etc/protocols\fP
+プロトコルのデータベースファイル
 .PD
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-4.3BSD, POSIX.1-2001.
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR getnetent (3),
-.BR getprotoent_r (3),
-.BR getservent (3),
-.BR protocols (5)
+.SH 準拠
+4.3BSD, POSIX.1\-2001.
+.SH 関連項目
+\fBgetnetent\fP(3), \fBgetprotoent_r\fP(3), \fBgetservent\fP(3), \fBprotocols\fP(5)