1 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
3 .\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
4 .\"*******************************************************************
6 .\" This file was generated with po4a. Translate the source file.
8 .\"*******************************************************************
9 .TH GETRPCENT 3 2008\-08\-19 "" "Linux Programmer's Manual"
11 getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- RPC
15 \fB#include <netdb.h>\fP
17 \fBstruct rpcent *getrpcent(void);\fP
19 \fBstruct rpcent *getrpcbyname(char *\fP\fIname\fP\fB);\fP
21 \fBstruct rpcent *getrpcbynumber(int \fP\fInumber\fP\fB);\fP
23 \fBvoid setrpcent(int \fP\fIstayopen\fP\fB);\fP
25 \fBvoid endrpcent(void);\fP
29 \fBgetrpcent\fP(), \fBgetrpcbyname\fP(), \fBgetrpcbynumber\fP()
30 はそれぞれ以下の構造体へのポインタを返す。 この構造体は RPC プログラム番号データベース の各行のフィールドを含んでいる。
35 char *r_name; /* name of server for this RPC program */
36 char **r_aliases; /* alias list */
37 long r_number; /* RPC program number */
49 RPC プログラムの別名のリスト。ゼロで終端されている。
55 \fBgetrpcent\fP() はファイルの次のエントリを読み込む。 必要ならばデータベースへの接続がオープンされる。
57 \fBsetrpcent\fP() はデータベースへの接続をオープンし、 次の読み込みエントリを先頭のエントリに設定する。 \fIstayopen\fP が 0
58 でない場合、 一つ一つの \fBgetrpc*\fP() 関数の呼び出し間でデータベースへの接続をクローズしない。
60 \fBendrpcent\fP() はデータベースへの接続をクローズする。
62 \fBgetrpcbyname\fP() と \fBgetrpcbynumber\fP() はファイルの最初から一致する RPC プログラム名かプログラム番号が
63 見つかるか、ファイルの最後 (end\-of\-file) に到達するまで、順番に 探していく。
65 成功すると、 \fBgetrpcent\fP(), \fBgetrpcbyname\fP(), \fBgetrpcbynumber\fP() は、静的に割り当てられた
66 \fIrpcent\fP 構造体へのポインタを返す。 EOF か エラーに遭遇した場合には NULL ポインタを返す。
72 POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステムに存在する。
74 全ての情報は静的領域に格納される。 保存するためには全てをコピーする必要がある。
76 \fBgetrpcent_r\fP(3), \fBrpc\fP(5), \fBrpcinfo\fP(8), \fBypserv\fP(8)