getrpcbyname(3)

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 プログラム番号 */

};

この構造体のメンバは次のとおりです。

この rpc プログラムのサーバ名。

r_aliases
rpc プログラムの、0 で終わる別名 (エイリアス) リスト。

r_number
このサービスの rpc プログラム番号。

getrpcent() 関数は、必要ならばファイルをオープンして次の行を読み込みま す。 setrpcent() 関数はファイルをオープンしリワインドします。 stayopen フ ラグが 0 でなければ、 (直接呼び出しかまたは、ほかの getrpcent() 関数ファ ミリの 1 つを介しての間接呼び出しかにかかわらず) 、 getrpcent() の各呼び 出しの後でネットデータベースはクローズされません。

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

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

関連ファイル

関連項目

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

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

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

FreeBSD 10.0 December 14, 1987 FreeBSD 10.0