manページ  — GETRPCENT

getrpcent, getrpcbyname, getrpcbynumber, endrpcent, setrpcent – RPC エントリを取得

書式 解説 関連ファイル 関連項目 診断 バグ

#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 でなければ、 (直接呼び出しかまたは、ほかの getrpcent() 関数ファミリの 1 つを介しての間接呼び出しかにかかわらず) 、 getrpcent() の各呼び出しの後でネットデータベースはクローズされません。

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

getrpcbyname() および getrpcbynumber() 関数は、適合する rpc プログラム名またはプログラム番号が見付かるか、またはエンドオブファイルに 出会うまで、最初から順次ファイルを検索します。

/etc/rpc

EOF またはエラーの場合 NULL ポインタが返ります。

すべての情報は静的領域に含まれるので、保存が必要な場合はコピー しなければなりません。