名称

getrpcent, getrpcbyname, getrpcbyaddr  −  RPCエントリを得る

形式

#include <netdb.h>
struct rpcent ∗getrpcent()
struct rpcent ∗getrpcbyname(name)
char ∗name;
struct rpcent ∗getrpcbynumber(number)
int number;
setrpcent (stayopen)
int stayopen
endrpcent()

解説

getrpcent および getrpcbyname、 getrpcbynumber() はそれぞれ、 次のような構造を 持つ構造体へのポインタを 返します。 この構造体は、 rpc プログラム番号のデータベース /etc/rpcs 中の 1行を いくつかに区切ったフィールドを 含んでいます。

struct rpcent{
        char∗r_name;/∗  rpcプログラム用のサーバの名前  ∗/
        char∗∗r_aliases;/∗  別名リスト  ∗/
        longr_number;/∗  rpcプログラム番号  ∗/
};

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

r_name rpcプログラム用のサーバの名前

r_aliases rpcプログラム用の別名のゼロで終わるリスト

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

getrpcent() は、 必要ならファイルを オープンして、 ファイルの次の行を 読み込みます。 getrpcent() は、 ファイルを オープンして先頭にポインタをセットします。 stayopen フラグがゼロでない値の場合、 ネットワークデータベースは、 getrpcent() の各呼び出し後にクローズされることはありません(直接的にも、 または別の “getrpc” 呼び出しを介して間接的にも)。 endrpcent はファイルを クローズします。 getrpcbyname() と getrpcbynumber() は、 マッチする rpc プログラム名またはプログラム番号が見つかるまで、 あるいは EOF に出合うまで、 ファイルの先頭から順次に検索を 行います。

関連ファイル

/etc/rpc

/var/yp/domainname/rpc.bynumber

関連事項

rpc(5), nis.conf(5), rpcinfo(8), ypserv(8)

診断

EOF またはエラーのときには、 ナル ポインタ(0)が返されます。

バグ

すべての情報は、 静的領域の中に含まれているため、 セーブしようとする場合には、 コピーしなければなりません。

NEWS-OSRelease 4.1C