cb5d1a9147
jpman project specific RCS keyword (jpman %Id) is obsolete, after manual entries are stored in freefall CVS repository. This old Id is useless and more worse it confuses users and bug reporters. So, this old Id is removed. Submitted by:jpman project <man-jp@jp.FreeBSD.org>
92 lines
2 KiB
Groff
92 lines
2 KiB
Groff
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
|
|
.\" $FreeBSD$
|
|
.Dd December 14, 1987
|
|
.Dt GETRPCENT 3
|
|
.Os
|
|
.Sh 名称
|
|
.Nm getrpcent ,
|
|
.Nm getrpcbyname ,
|
|
.Nm getrpcbynumber ,
|
|
.Nm endrpcent ,
|
|
.Nm setrpcent
|
|
.Nd RPC エントリを取得
|
|
.Sh 書式
|
|
.Fd #include <rpc/rpc.h>
|
|
.Ft struct rpcent *
|
|
.Fn getrpcent void
|
|
.Ft struct rpcent *
|
|
.Fn getrpcbyname "char *name"
|
|
.Ft struct rpcent *
|
|
.Fn getrpcbynumber "int number"
|
|
.Ft void
|
|
.Fn setrpcent "int stayopen"
|
|
.Ft void
|
|
.Fn endrpcent void
|
|
.Sh 解説
|
|
.Fn getrpcent
|
|
、
|
|
.Fn getrpcbyname
|
|
および
|
|
.Fn getrpcbynumber
|
|
関数はそれぞれ、次に
|
|
示す構造体を持つオブジェクトのポインタを返します。構造体には
|
|
rpc
|
|
プログラム番号データベース
|
|
.Pa /etc/rpc
|
|
にある、行の内訳フィールドが
|
|
含まれます。
|
|
.Bd -literal
|
|
struct rpcent {
|
|
char *r_name; /* この rpc プログラムのサーバ名 */
|
|
char **r_aliases; /* エイリアスリスト */
|
|
long r_number; /* rpc プログラム番号 */
|
|
};
|
|
.Ed
|
|
.Pp
|
|
この構造体のメンバは次のとおりです。
|
|
.Bl -tag -width r_aliasesxxx
|
|
.It Fa r_name
|
|
この rpc プログラムのサーバ名。
|
|
.It Fa r_aliases
|
|
rpc プログラムの、ゼロで終わる別名 (エイリアス) リスト。
|
|
.It Fa r_number
|
|
このサービスの rpc プログラム番号。
|
|
.El
|
|
.Pp
|
|
.Fn getrpcent
|
|
関数は、必要ならばファイルをオープンして次の行を読み込みます。
|
|
.Nm getrpcent
|
|
関数はファイルをオープンしリワインドします。
|
|
.Fa stayopen
|
|
フラグがゼロでなければ、 (直接呼び出しかまたは、ほかの
|
|
.Fn getrpcent
|
|
関数ファミリの 1 つを介しての間接呼び出しかにかかわらず) 、
|
|
.Fn getrpcent
|
|
の各呼び出しの後でネットデータベースはクローズされません。
|
|
.Pp
|
|
.Fn endrpcent
|
|
はファイルをクローズします。
|
|
.Pp
|
|
.Fn getrpcbyname
|
|
および
|
|
.Fn getrpcbynumber
|
|
関数は、適合する
|
|
rpc
|
|
プログラム名またはプログラム番号が見付かるか、またはエンドオブファイルに
|
|
出会うまで、最初から順次ファイルを検索します。
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /etc/rpc -compact
|
|
.It Pa /etc/rpc
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr rpc 5 ,
|
|
.Xr rpcinfo 8 ,
|
|
.Xr ypserv 8
|
|
.Sh 診断
|
|
.Dv EOF
|
|
またはエラーの場合
|
|
.Dv NULL
|
|
ポインタが返ります。
|
|
.Sh バグ
|
|
すべての情報は静的領域に含まれるので、保存が必要な場合はコピー
|
|
しなければなりません。
|