EN JA
GETRPCENT(3)
GETRPCENT(3) FreeBSD Library Functions Manual GETRPCENT(3)

名称

getrpcent, getrpcbyname, getrpcbynumber, endrpcent, setrpcentRPC エントリを取得する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < rpc/rpc.h>

struct rpcent *
getrpcent( void);

struct rpcent *
getrpcbyname( char *name);

struct rpcent *
getrpcbynumber( int number);

void
setrpcent( int stayopen);

void
endrpcent( void);

解説

getrpcent(), getrpcbyname() と getrpcbynumber() 関数は、それぞれ、rpc プログラム番号データベース、 /etc/rpc の行の切り離されたフィールドを含んでいる次の構造体があるオブジェクトへのポインタを返します:

struct rpcent { 
 char *r_name; /* この rpc プログラムのためにサーバの名前 */ 
 char **r_aliases; /* 別名リスト */ 
 long r_number; /* rpc プログラム番号 */ 
};

この構造体のメンバは、次の通りです:

r_name
この rpc プログラムのためのサーバの名前。
r_aliases
rpc プログラムの代わりの名前の 0 で終了するリスト。
r_number
このサービスのための rpc プログラム番号。

getrpcent() 関数は、必要ならば、ファイルをオープンして、ファイルの次の行を読み込みます。

setrpcent() 関数は、ファイルをオープンしてリワインドします。 stayopen フラグが 0 でないなら、ネットデータベースは、(他の“getrpc”呼び出しの 1 つを通して直接的な、または間接的な) getrpcent() への各呼び出しの後にクローズされません。

endrpcent() 関数は、ファイルをクローズします。

getrpcbyname() と getrpcbynumber() 関数は、一致する rpc プログラム名またはプログラム番号が見つかるか、またはファイルの終りに遭遇するまで、ファイルの始めから連続して検索します。

関連ファイル

/etc/rpc

診断

EOF またはエラーのときに NULL ポインタが返されます。

関連項目

rpc(5), rpcinfo(8), ypserv(8)

バグ

すべての情報は、静的な領域に含まれるので、それが保存されることになっているなら、コピーされなければなりません。
December 14, 1987 FreeBSD