名称

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_aliasesrpcプログラム用の別名のゼロで終わるリスト

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

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

setrpcent は、 ファイルを オープンして先頭にポインタをセットします。 stayopen フラグがゼロでない値の場合、 ネットワークデータベースは、 getrpcent の各呼び出し後にクローズされることはありません(直接的にも、 または別の “getrpc” 呼び出しを介して間接的にも)。

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

getrpcbyname と getrpcbynumber は、 マッチする rpc プログラム名またはプログラム番号が見つかるまで、 あるいは EOF に出合うまで、 ファイルの先頭から順次に検索を 行います。

関連ファイル

/etc/rpc
/etc/yp/domainname/rpc.bynumber

関連事項

rpc(5), rpcinfo(8), ypservices(8)

診断

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

バグ

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

NEWS-OSRelease 3.3