getrpcentのヘルプ・マニュアル
日本語 英語
getrpcent --help
man getrpcent
GETRPCENT(3) Linux Programmer’s Manual GETRPCENT(3)
名前
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - RPC エ
ントリを取得する
書式
#include
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 プログラム番号データベースの各行のフ
ィールドを含んでいる。
struct rpcent {
char *r_name; /* name of server for this RPC program */
char **r_aliases; /* alias list */
long r_number; /* RPC program number */
};
この構造体のメンバーは以下の通り。
r_name この RPC プログラムのサーバの名前
r_aliases RPC プログラムの別名のリスト。ゼロで終端されている。
r_number このサービスの RPC プログラム番号。
getrpcent() はファイルの次のエントリを読み込む。必要ならばデータベー ス
への接続がオープンされる。
setrpcent() はデータベースへの接続をオープンし、次の読み込みエントリを
先頭のエントリに設定する。 stayopen が 0 でない 場 合 、 一 つ 一 つ の
getrpc*() 関数の呼び出し間でデータベースへの接続をクローズしない。
endrpcent() はデータベースへの接続をクローズする。
getrpcbyname() と getrpcbynumber() はファイルの最初から一致する RPC プ
ログラム名かプログラム番号が見つかるか、ファイルの最後 (end-of-file) に
到達するまで、順番に探していく。
返り値
成功すると、 getrpcent(), getrpcbyname(), getrpcbynumber() は、静的に割
り当てられた rpcent 構造体へのポインタを返す。 EOF か エラーに遭遇し た
場合には NULL ポインタを返す。
ファイル
/etc/rpc
RPC プログラム番号データベース
準拠
POSIX.1-2001 にはない。 BSD 系、Solaris や他の多くのシステムに存在する
。
バグ
全ての情報は静的領域に格納される。保存するためには全てをコピーする必 要
がある。
関連項目
getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)
2008-08-19 GETRPCENT(3)
GETRPCENT(3) Linux Programmer’s Manual GETRPCENT(3)
NAME
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - get RPC
entry
SYNOPSIS
#include
struct rpcent *getrpcent(void);
struct rpcent *getrpcbyname(char *name);
struct rpcent *getrpcbynumber(int number);
void setrpcent(int stayopen);
void endrpcent(void);
DESCRIPTION
getrpcent(), getrpcbyname(), and getrpcbynumber() each return a pointer
to an object with the following structure containing the broken-out
fields of an entry in the RPC program number data base.
struct rpcent {
char *r_name; /* name of server for this RPC program */
char **r_aliases; /* alias list */
long r_number; /* RPC program number */
};
The members of this structure are:
r_name The name of the server for this RPC program.
r_aliases A NULL-terminated list of alternate names for the RPC
program.
r_number The RPC program number for this service.
getrpcent() reads the next entry from the database. A connection is
opened to the database if necessary.
setrpcent() function opens a connection to the database, and sets the
next entry to the first entry. If stayopen is non-zero, then the con-
nection to the database will not be closed between calls to one of the
getrpc*() functions.
The endrpcent() function closes the connection to the database.
getrpcbyname() and getrpcbynumber() sequentially search from the begin-
ning of the file until a matching RPC program name or program number is
found, or until end-of-file is encountered.
RETURN VALUE
On success, getrpcent(), getrpcbyname(), and getrpcbynumber() return a
pointer to a statically allocated rpcent structure. A NULL pointer is
returned on EOF or error.
FILES
/etc/rpc
RPC program number database.
CONFORMING TO
Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other sys-
tems.
BUGS
All information is contained in a static area so it must be copied if
it is to be saved.
SEE ALSO
getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
2008-08-19 GETRPCENT(3)