draft/man3/getrpcent.3

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