989d921f5d
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
93 lines
2 KiB
Groff
93 lines
2 KiB
Groff
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
|
|
.\" %FreeBSD: src/lib/libc/rpc/getrpcent.3,v 1.11.2.3 2001/12/14 18:33:56 ru Exp %
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd December 14, 1987
|
|
.Dt GETRPCENT 3
|
|
.Os
|
|
.Sh 名称
|
|
.Nm getrpcent ,
|
|
.Nm getrpcbyname ,
|
|
.Nm getrpcbynumber ,
|
|
.Nm endrpcent ,
|
|
.Nm setrpcent
|
|
.Nd RPC エントリを取得
|
|
.Sh 書式
|
|
.In 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 プログラムの、0 で終わる別名 (エイリアス) リスト。
|
|
.It Fa r_number
|
|
このサービスの rpc プログラム番号。
|
|
.El
|
|
.Pp
|
|
.Fn getrpcent
|
|
関数は、必要ならばファイルをオープンして次の行を読み込みます。
|
|
.Fn setrpcent
|
|
関数はファイルをオープンしリワインドします。
|
|
.Fa stayopen
|
|
フラグが 0 でなければ、 (直接呼び出しかまたは、ほかの
|
|
.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 バグ
|
|
すべての情報は静的領域に含まれるので、保存が必要な場合はコピー
|
|
しなければなりません。
|