GETRPCENT(3) | FreeBSD Library Functions Manual | GETRPCENT(3) |
名称
getrpcent, getrpcbyname, getrpcbynumber, endrpcent, setrpcent — RPC エントリを取得するライブラリ
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 ポインタが返されます。バグ
すべての情報は、静的な領域に含まれるので、それが保存されることになっているなら、コピーされなければなりません。December 14, 1987 | FreeBSD |