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 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
   6 .\"         all rights reserved.
   7 .\" Translated 2000-01-11, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
   8 .\" Updated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\"
  10 .TH GETRPCENT 3 2008-08-19 "" "Linux Programmer's Manual"
  11 .SH 名前
  12 getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \-
  13 RPC エントリを取得する
  14 .SH 書式
  15 .nf
  16 .B #include <netdb.h>
  17
  18 .BI "struct rpcent *getrpcent(void);"
  19
  20 .BI "struct rpcent *getrpcbyname(char *" name );
  21
  22 .BI "struct rpcent *getrpcbynumber(int " number );
  23
  24 .BI "void setrpcent(int " stayopen );
  25
  26 .BI "void endrpcent(void);"
  27 .fi
  28 .SH 説明
  29 .LP
  30 .BR getrpcent (),
  31 .BR getrpcbyname (),
  32 .BR getrpcbynumber ()
  33 はそれぞれ以下の構造体へのポインタを返す。
  34 この構造体は RPC プログラム番号データベース
  35 の各行のフィールドを含んでいる。
  36 .in +4n
  37 .nf
  38
  39 struct rpcent {
  40     char  *r_name;     /* name of server for this RPC program */
  41     char **r_aliases;  /* alias list */
  42     long   r_number;   /* RPC program number */
  43 };
  44 .fi
  45 .in
  46 .LP
  47 この構造体のメンバーは以下の通り。
  48 .RS 4
  49 .TP 12
  50 .I r_name
  51 この RPC プログラムのサーバの名前
  52 .TP
  53 .I r_aliases
  54 RPC プログラムの別名のリスト。ゼロで終端されている。
  55 .TP
  56 .I r_number
  57 このサービスの RPC プログラム番号。
  58 .RE
  59 .LP
  60 .BR getrpcent ()
  61 はファイルの次のエントリを読み込む。
  62 必要ならばデータベースへの接続がオープンされる。
  63 .LP
  64 .BR setrpcent ()
  65 はデータベースへの接続をオープンし、
  66 次の読み込みエントリを先頭のエントリに設定する。
  67 \fIstayopen\fP が 0 でない場合、
  68 一つ一つの
  69 .BR getrpc* ()
  70 関数の呼び出し間でデータベースへの接続をクローズしない。
  71 .LP
  72 .BR endrpcent ()
  73 はデータベースへの接続をクローズする。
  74 .LP
  75 .BR getrpcbyname ()
  76 と
  77 .BR getrpcbynumber ()
  78 はファイルの最初から一致する RPC プログラム名かプログラム番号が
  79 見つかるか、ファイルの最後 (end-of-file) に到達するまで、順番に
  80 探していく。
  81 .SH 返り値
  82 成功すると、
  83 .BR getrpcent (),
  84 .BR getrpcbyname (),
  85 .BR getrpcbynumber ()
  86 は、静的に割り当てられた
  87 .I rpcent
  88 構造体へのポインタを返す。
  89 EOF か エラーに遭遇した場合には NULL ポインタを返す。
  90 .SH ファイル
  91 .TP
  92 .I /etc/rpc
  93 RPC プログラム番号データベース
  94 .SH 準拠
  95 POSIX.1-2001 にはない。
  96 BSD 系、Solaris や他の多くのシステムに存在する。
  97 .SH バグ
  98 全ての情報は静的領域に格納される。
  99 保存するためには全てをコピーする必要がある。
 100 .SH 関連項目
 101 .BR getrpcent_r (3),
 102 .BR rpc (5),
 103 .BR rpcinfo (8),
 104 .BR ypserv (8)