release/man3/getrpcent.3

   1 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
   2 .\"
   3 .\" @(#)getrpcent.3n    2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
   4 .\"*******************************************************************
   5 .\"
   6 .\" This file was generated with po4a. Translate the source file.
   7 .\"
   8 .\"*******************************************************************
   9 .TH GETRPCENT 3 2008\-08\-19 "" "Linux Programmer's Manual"
  10 .SH 名前
  11 getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- RPC
  12 エントリを取得する
  13 .SH 書式
  14 .nf
  15 \fB#include <netdb.h>\fP
  16
  17 \fBstruct rpcent *getrpcent(void);\fP
  18
  19 \fBstruct rpcent *getrpcbyname(char *\fP\fIname\fP\fB);\fP
  20
  21 \fBstruct rpcent *getrpcbynumber(int \fP\fInumber\fP\fB);\fP
  22
  23 \fBvoid setrpcent(int \fP\fIstayopen\fP\fB);\fP
  24
  25 \fBvoid endrpcent(void);\fP
  26 .fi
  27 .SH 説明
  28 .LP
  29 \fBgetrpcent\fP(), \fBgetrpcbyname\fP(), \fBgetrpcbynumber\fP()
  30 はそれぞれ以下の構造体へのポインタを返す。 この構造体は RPC プログラム番号データベース の各行のフィールドを含んでいる。
  31 .in +4n
  32 .nf
  33
  34 struct rpcent {
  35     char  *r_name;     /* name of server for this RPC program */
  36     char **r_aliases;  /* alias list */
  37     long   r_number;   /* RPC program number */
  38 };
  39 .fi
  40 .in
  41 .LP
  42 この構造体のメンバーは以下の通り。
  43 .RS 4
  44 .TP  12
  45 \fIr_name\fP
  46 この RPC プログラムのサーバの名前
  47 .TP
  48 \fIr_aliases\fP
  49 RPC プログラムの別名のリスト。ゼロで終端されている。
  50 .TP
  51 \fIr_number\fP
  52 このサービスの RPC プログラム番号。
  53 .RE
  54 .LP
  55 \fBgetrpcent\fP()  はファイルの次のエントリを読み込む。 必要ならばデータベースへの接続がオープンされる。
  56 .LP
  57 \fBsetrpcent\fP()  はデータベースへの接続をオープンし、 次の読み込みエントリを先頭のエントリに設定する。 \fIstayopen\fP が 0
  58 でない場合、 一つ一つの \fBgetrpc*\fP()  関数の呼び出し間でデータベースへの接続をクローズしない。
  59 .LP
  60 \fBendrpcent\fP()  はデータベースへの接続をクローズする。
  61 .LP
  62 \fBgetrpcbyname\fP()  と \fBgetrpcbynumber\fP()  はファイルの最初から一致する RPC プログラム名かプログラム番号が
  63 見つかるか、ファイルの最後 (end\-of\-file) に到達するまで、順番に 探していく。
  64 .SH 返り値
  65 成功すると、 \fBgetrpcent\fP(), \fBgetrpcbyname\fP(), \fBgetrpcbynumber\fP()  は、静的に割り当てられた
  66 \fIrpcent\fP 構造体へのポインタを返す。 EOF か エラーに遭遇した場合には NULL ポインタを返す。
  67 .SH ファイル
  68 .TP
  69 \fI/etc/rpc\fP
  70 RPC プログラム番号データベース
  71 .SH 準拠
  72 POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステムに存在する。
  73 .SH バグ
  74 全ての情報は静的領域に格納される。 保存するためには全てをコピーする必要がある。
  75 .SH 関連項目
  76 \fBgetrpcent_r\fP(3), \fBrpc\fP(5), \fBrpcinfo\fP(8), \fBypserv\fP(8)