release/man3/xdr.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 .\" @(#)xdr.3n  2.2 88/08/03 4.0 RPCSRC; from 1.16 88/03/14 SMI
   8 .\"
   9 .\" 2007-12-30, mtk, Convert function prototypes to modern C syntax
  10 .\"
  11 .\"*******************************************************************
  12 .\"
  13 .\" This file was generated with po4a. Translate the source file.
  14 .\"
  15 .\"*******************************************************************
  16 .TH XDR 3 2007\-12\-30 "" "Linux Programmer's Manual"
  17 .SH 名前
  18 xdr \- 外部データ表現(XDR)のためのライブラリ・ルーティン
  19 .SH 書式と説明
  20 .LP
  21 これらのルーティンは C プログラマーがマシン非依存な形式で 任意のデータ構造体を記述することを可能にする。
  22 リモート・プロシジャ・コールのためのデータはこれらのルーティンを 使用して送信される。
  23
  24 以下に示すプロトタイプ宣言は \fI<rpc/xdr.h>\fP で行われており、その中では次の型が使用される。
  25 .in +4n
  26 .nf
  27
  28 \fBtypedef int \fP\fIbool_t\fP\fB;\fP
  29
  30 \fBtypedef bool_t (*\fP\fIxdrproc_ti\fP\fB) (XDR *, void *,...);\fP
  31 .fi
  32 .in
  33 .LP
  34 \fIXDR\fP 型の宣言については、 \fI<rpc/xdr.h>\fP を参照。
  35 .LP
  36 .nf
  37 \fBbool_t xdr_array(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIarrp\fP\fB, unsigned int *\fP\fIsizep\fP\fB,\fP
  38 \fB                 unsigned int \fP\fImaxsize\fP\fB, unsigned int \fP\fIelsize\fP\fB,\fP
  39 \fB                 xdrproc_t \fP\fIelproc\fP\fB);\fP
  40 .fi
  41 .IP
  42 可変長の配列とそれに対応する外部表現とを変換する基本フィルター。 引き数 \fIarrp\fP は配列へのポインターのアドレスであり、 \fIsizep\fP
  43 は配列の要素数のアドレスである。 これらの要素数は \fImaxsize\fP を超えてはならない。 引き数 \fIelsize\fP は各配列の要素の
  44 \fIsizeof\fP であり、 \fIelproc\fP は配列要素を C 形式からその外部表現に変換するための XDR フィルターである。
  45 このルーティンは成功した場合には 1 を返す。 失敗した場合にはゼロを返す。
  46 .LP
  47 .nf
  48 \fBbool_t xdr_bool(XDR *\fP\fIxdrs\fP\fB, bool_t *\fP\fIbp\fP\fB);\fP
  49 .fi
  50 .IP
  51 真偽値(C の int)とその外部表現とを変換する基本フィルター。 データをエンコードする時、このフィルターは 1 また 0 の値を生成する。
  52 このルーティンは成功した場合には 1 を返す。 失敗した場合には 0 を返す。
  53 .LP
  54 .nf
  55 \fBbool_t xdr_bytes(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIsp\fP\fB, unsigned int *\fP\fIsizep\fP\fB,\fP
  56 \fB                 unsigned int \fP\fImaxsize\fP\fB);\fP
  57 .fi
  58 .IP
  59 ある長さのバイト文字列とその外部表現とを変換する基本フィルター。 引き数 \fIsp\fP は文字列ポインターのアドレスである。文字列の長さは
  60 \fIsizep\fP のアドレスに置く。文字列は \fImaxsize\fP より長くてはいけない。 このルーティンは成功した場合には 1 を返す。
  61 失敗した場合には 0 を返す。
  62 .LP
  63 .nf
  64 \fBbool_t xdr_char(XDR *\fP\fIxdrs\fP\fB, char *\fP\fIcp\fP\fB);\fP
  65 .fi
  66 .IP
  67 C の文字(char)とその外部表現との間を変換する基本フィルター。 このルーティンは成功した場合には 1 を返す。 失敗した場合には 0 を返す。
  68 注意: エンコードされたデータは詰め込まれておらず、それぞれ 4 バイトを 占める。文字の配列の場合には \fBxdr_bytes\fP(),
  69 \fBxdr_opaque\fP(), \fBxdr_string\fP()  などを考慮した方が良い。
  70 .LP
  71 .nf
  72 \fBvoid xdr_destroy(XDR *\fP\fIxdrs\fP\fB);\fP
  73 .fi
  74 .IP
  75 このマクロは XDR ストリーム \fIxdrs\fP に関連付けられた破壊ルーティンを呼び出す。
  76 破壊には通常、ストリームに関連付けられた私的データ構造体の解放が含まれている。 \fBxdr_destroy\fP()  の呼び出しの後に \fIxdrs\fP
  77 を使用することは未定義である。
  78 .LP
  79 .nf
  80 \fBbool_t xdr_double(XDR *\fP\fIxdrs\fP\fB, double *\fP\fIdp\fP\fB);\fP
  81 .fi
  82 .IP
  83 C の \fI倍精度数 (double)\fP とその外部表現との変換を行なう基本フィルター。 このルーティンは成功した場合は 1 を返す。 失敗した場合は
  84 0 を返す。
  85 .LP
  86 .nf
  87 \fBbool_t xdr_enum(XDR *\fP\fIxdrs\fP\fB, enum_t *\fP\fIep\fP\fB);\fP
  88 .fi
  89 .IP
  90 C の \fIenum\fP (実際には int)とその外部表現との変換を行なう基本フィルター。 このルーティンは成功した場合は 1 を返す。 失敗した場合は
  91 0 を返す。
  92 .LP
  93 .nf
  94 \fBbool_t xdr_float(XDR *\fP\fIxdrs\fP\fB, float *\fP\fIfp\fP\fB);\fP
  95 .fi
  96 .IP
  97 C の \fI浮動小数点数 (float)\fP とその外部表現との変換を行なう基本フィルター。 このルーティンは成功した場合は 1 を返す。 失敗した場合は
  98 0 を返す。
  99 .LP
 100 .nf
 101 \fBvoid xdr_free(xdrproc_t \fP\fIproc\fP\fB, char *\fP\fIobjp\fP\fB);\fP
 102 .fi
 103 .IP
 104 汎用解放(free)ルーティン。最初の引き数はオブジェクトを解放するための XDR ルーティンである。二番目の引き数はそのオブジェクト自身へのポインター
 105 である。注意: このルーティンに渡されるポインターは \fI解放されない\fP が、このポインターの指すデータは(再帰的に)  \fI解放される\fP。
 106 .LP
 107 .nf
 108 \fBunsigned int xdr_getpos(XDR *\fP\fIxdrs\fP\fB);\fP
 109 .fi
 110 .IP
 111 このマクロは XDR ストリーム \fIxdrs\fP に関連付けられた位置取得ルーティンを呼び出す。 このルーティンは XDR
 112 バイト・ストリームの位置を指示する符号無し整数を返す。 XDR ストリームの機能としてこの数値で単純な算術作業ができることが
 113 期待されてるいる。しかしながら XDR ストリームの実体はこれを保証する必要はない。
 114 .LP
 115 .nf
 116 \fBlong *xdr_inline(XDR *\fP\fIxdrs\fP\fB, int \fP\fIlen\fP\fB);\fP
 117 .fi
 118 .IP
 119 A macro that invokes the inline routine associated with the XDR stream,
 120 \fIxdrs\fP.  The routine returns a pointer to a contiguous piece of the
 121 stream's buffer; \fIlen\fP is the byte length of the desired buffer.  Note:
 122 pointer is cast to \fIlong\ *\fP.
 123 .IP
 124 警告: \fBxdr_inline\fP()  はバッファーの連続する断片を割り当てることができなかった場合には NULL (0)を返すかもしれない。
 125 どの場合もその動作はストリームの実体によって変化するかもしれない。 これは効率化のために存在している。
 126 .LP
 127 .nf
 128 \fBbool_t xdr_int(XDR *\fP\fIxdrs\fP\fB, int *\fP\fIip\fP\fB);\fP
 129 .fi
 130 .IP
 131 C の整数(int)とその外部表現とを変換するための基本フィルター。 このルーティンは成功した場合は 1 を返す。 失敗した場合はゼロを返す。
 132 .LP
 133 .nf
 134 \fBbool_t xdr_long(XDR *\fP\fIxdrs\fP\fB, long *\fP\fIlp\fP\fB);\fP
 135 .fi
 136 .IP
 137 C の \fIlong\fP 整数とそのその外部表現とを変換するための基本フィルター。 このルーティンは成功した場合は 1 を返す。
 138 失敗した場合はゼロを返す。
 139 .LP
 140 .nf
 141 \fBvoid xdrmem_create(XDR *\fP\fIxdrs\fP\fB, char *\fP\fIaddr\fP\fB, unsigned int \fP\fIsize\fP\fB,\fP
 142 \fB                   enum xdr_op \fP\fIop\fP\fB);\fP
 143 .fi
 144 .IP
 145 このルーティンは \fIxdrs\fP によって指されている XDR ストリーム・オブジェクトを初期化する。 ストリームのデータは \fIaddr\fP
 146 位置にあるメモリーの塊から読み書きされる。 その長さはバイト単位で \fIsize\fP 超えてはいけない。 \fIop\fP は XDR
 147 ストリームの変換方向を決定する (\fBXDR_ENCODE\fP, \fBXDR_DECODE\fP, \fBXDR_FREE\fP のどれか)。
 148 .LP
 149 .nf
 150 \fBbool_t xdr_opaque(XDR *\fP\fIxdrs\fP\fB, char *\fP\fIcp\fP\fB, unsigned int \fP\fIcnt\fP\fB);\fP
 151 .fi
 152 .IP
 153 固定長の不明データとその外部表現との変換を行なう基本フィルター。 引き数 \fIcp\fP は不明オブジェクトのアドレスであり \fIcnt\fP
 154 はそのバイト単位の大きさである。 このルーティンは成功した場合は 1 を返す。 失敗した場合はゼロを返す。
 155 .LP
 156 .nf
 157 \fBbool_t xdr_pointer(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIobjpp\fP\fB,\fP
 158 \fB                   unsigned int \fP\fIobjsize\fP\fB, xdrproc_t \fP\fIxdrobj\fP\fB);\fP
 159 .fi
 160 .IP
 161 \fBxdr_reference\fP()  と同様であるが、これが NULL ポインターを番号化するのに対して \fBxdr_reference\fP()
 162 はそうしない点が異なっている。これにより、 \fBxdr_pointer\fP()  は二分木や連結リストのような再帰的なデータ構造体を 表現できる。
 163 .LP
 164 .nf
 165 \fBvoid xdrrec_create(XDR *\fP\fIxdrs\fP\fB, unsigned int \fP\fIsendsize\fP\fB,\fP
 166 \fB                   unsigned int \fP\fIrecvsize\fP\fB, char *\fP\fIhandle\fP\fB,\fP
 167 \fB                   int (*\fP\fIreadit\fP\fB) (char *, char *, int),\fP
 168 \fB                   int (*\fP\fIwriteit\fP\fB) (char *, char *, int));\fP
 169 .fi
 170 .IP
 171 このルーティンは \fIxdrs\fP で指された XDR ストリーム・オブジェクトを初期化する。 ストリームのデータは大きさ \fIsendsize\fP
 172 のバッファへ書き込まれる。 \fIsendsize\fP をゼロにすると、システムに適切なデフォルトを使用するように指示する。 ストリームのデータは大きさ
 173 \fIrecvsize\fP のバッファから読み込まれる。これもゼロを渡すことで適切なデフォルトに 設定することができる。
 174 ストリームの出力バッファが一杯の場合は \fIwriteit\fP が呼び出される。同様にストリーム入力バッファが空の場合には \fIreadit\fP
 175 が呼び出される。これらの二つのルーティンの動作はシステムコールの \fBread\fP(2)  や \fBwrite\fP(2)
 176 と似ているが、前者のルーティンは最初の引き数として \fIhandle\fP が渡される点で異なっている。 注意: XDR ストリームの \fIop\fP
 177 は呼び出し側で設定しなければならない。
 178 .IP
 179 警告: この XDR ストリームは中間レコード・ストリームを実装している。 レコード境界の情報を提供するためにストリームには余分なバイトが存在する。
 180 .LP
 181 .nf
 182 \fBbool_t xdrrec_endofrecord(XDR *\fP\fIxdrs\fP\fB, int \fP\fIsendnow\fP\fB);\fP
 183 .fi
 184 .IP
 185 このルーティンは \fBxdrrec_create\fP()  によって作成されたストリームに対してのみ呼び出すことができる。
 186 出力バッファのデータは完全なレコードとして印され、 \fIsendnow\fP がゼロでない場合には出力バッファは書き出される。
 187 このルーティンは成功した場合は 1 を返す。失敗した場合はゼロを返す。
 188 .LP
 189 .nf
 190 \fBbool_t xdrrec_eof(XDR *\fP\fIxdrs\fP\fB);\fP
 191 .fi
 192 .IP
 193 このルーティンは \fBxdrrec_create\fP()  によって作成されたストリームに対してのみ呼び出すことができる。
 194 ストリームの現在のレコードの残りを消費した後に、 ストリームに入力が残っていない場合には 1 を返す。 それ以外の場合はゼロを返す。
 195 .LP
 196 .nf
 197 \fBbool_t xdrrec_skiprecord(XDR *\fP\fIxdrs\fP\fB);\fP
 198 .fi
 199 .IP
 200 このルーティンは \fBxdrrec_create\fP()  によって作成されたストリームに対してのみ呼び出すことができる。 XDR
 201 の実装にそのストリームの入力バッファーの現在のレコードの残りを 捨てるように伝える。このルーティンは成功した場合は 1 を返す。
 202 失敗した場合はゼロを返す。
 203 .LP
 204 .nf
 205 \fBbool_t xdr_reference(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIpp\fP\fB, unsigned int \fP\fIsize\fP\fB,\fP
 206 \fB                     xdrproc_t \fP\fIproc\fP\fB);\fP
 207 .fi
 208 .IP
 209 構造体へのポインター追跡を提供する基本ルーティン。 引き数 \fIpp\fP はポインターのアドレスである。 \fIsize\fP は \fI*pp\fP
 210 が指している構造体の \fIsizeof\fP である。 \fIproc\fP はその構造体の C 形式と外部表現との変換を行なう XDR プロシジャである。
 211 このルーティンは成功した場合 1 を返す。 失敗した場合はゼロを返す。
 212 .IP
 213 警告: このルーティンは NULL ポインターを理解することができない。かわりに \fBxdr_pointer\fP()  を使用すること。
 214 .LP
 215 .nf
 216 \fBxdr_setpos(XDR *\fP\fIxdrs\fP\fB, unsigned int \fP\fIpos\fP\fB);\fP
 217 .fi
 218 .IP
 219 このマクロは XDR ストリーム \fIxdrs\fP に関連付けられた位置設定ルーティンを呼び出す。引き数 \fIpos\fP は \fBxdr_getpos\fP()
 220 によって取得される位置数値である。 このルーティンは XDR ストリームの位置の変更ができた場合には 1 を返す。 それ以外の場合は 0 を返す。
 221 .IP
 222 警告: ある種の XDR ストリームの場合は位置の変更を行なうことが困難である。 それでこのルーティンはある種のストリームの場合には成功し、別の種類の
 223 場合には失敗するかもしれない。
 224 .LP
 225 .nf
 226 \fBbool_t xdr_short(XDR *\fP\fIxdrs\fP\fB, short *\fP\fIsp\fP\fB);\fP
 227 .fi
 228 .IP
 229 C の \fIshort\fP 整数とその外部表現との変換を行なう基本フィルター。 このルーティンは成功すると 1 を返す。 失敗した場合はゼロを返す。
 230 .LP
 231 .nf
 232 \fBvoid xdrstdio_create(XDR *\fP\fIxdrs\fP\fB, FILE *\fP\fIfile\fP\fB, enum xdr_op \fP\fIop\fP\fB);\fP
 233 .fi
 234 .IP
 235 このルーティンは \fIxdrs\fP で指された XDR ストリーム・オブジェクトを初期化する。 XDR ストリームに読み書きれたデータは \fIstdio\fP
 236 ストリーム \fIfile\fP が使用される。 \fIop\fP 引き数は XDR ストリームの変換方向を決定する (\fBXDR_ENCODE\fP,
 237 \fBXDR_DECODE\fP, \fBXDR_FREE\fP のどれか)。
 238 .IP
 239 警告: このような XDR ストリームに関連付けられた破壊ルーティンは \fIfile\fP ストリームに対して \fBfflush\fP(3)  を呼び出すが
 240 \fBfclose\fP(3)  を呼び出すことはない。
 241 .LP
 242 .nf
 243 \fBbool_t xdr_string(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIsp\fP\fB, unsigned int \fP\fImaxsize\fP\fB);\fP
 244 .fi
 245 .IP
 246 C の文字列とそれに対応する外部表現とを変換するための基本フィルター。 文字列は \fImaxsize\fP より長くはできない。 注意: \fIsp\fP
 247 は文字列へのポインターのアドレスである。 このルーティンは成功した場合は 1 を返す。 失敗した場合はゼロを返す。
 248 .LP
 249 .nf
 250 \fBbool_t xdr_u_char(XDR *\fP\fIxdrs\fP\fB, unsigned char *\fP\fIucp\fP\fB);\fP
 251 .fi
 252 .IP
 253 C の \fI符号無し文字 (unsigned char)\fP とその外部表現とを変換する基本フィルター。 このルーティンは成功した場合は 1 を返す。
 254 失敗した場合はゼロを返す。
 255 .LP
 256 .nf
 257 \fBbool_t xdr_u_int(XDR *\fP\fIxdrs\fP\fB, unsigned *\fP\fIup\fP\fB);\fP
 258 .fi
 259 .IP
 260 C の \fI符号無し整数 (unsigned)\fP とその外部表現を変換するための基本フィルター。 このルーティンは成功した場合は 1 を返す。
 261 失敗した場合はゼロを返す。
 262 .LP
 263 .nf
 264 \fBbool_t xdr_u_long(XDR *\fP\fIxdrs\fP\fB, unsigned long *\fP\fIulp\fP\fB);\fP
 265 .fi
 266 .IP
 267 C の \fIunsigned long\fP 整数とその外部表現を変換するための基本フィルター。 このルーティンは成功した場合は 1 を返す。
 268 失敗した場合はゼロを返す。
 269 .LP
 270 .nf
 271 \fBbool_t xdr_u_short(XDR *\fP\fIxdrs\fP\fB, unsigned short *\fP\fIusp\fP\fB);\fP
 272 .fi
 273 .IP
 274 C の \fIunsigned short\fP 整数とその外部表現を変換するための基本フィルター。 このルーティンは成功した場合は 1 を返す。
 275 失敗した場合はゼロを返す。
 276 .LP
 277 .nf
 278 \fBbool_t xdr_union(XDR *\fP\fIxdrs\fP\fB, int *\fP\fIdscmp\fP\fB, char *\fP\fIunp\fP\fB,\fP
 279 \fB                 struct xdr_discrim *\fP\fIchoices\fP\fB,\fP
 280 \fB                 xdrproc_t \fP\fIdefaultarm\fP\fB);     /* may equal NULL */\fP
 281 .fi
 282 .IP
 283 分別可能な C の \fI共用体 (union)\fP とその外部形式とを変換する基本フィルター。 最初に \fIdscmp\fP
 284 として与えられた共用体の分別要素が変換される。 この分別要素は常に \fIenum_t\fP である。 次に \fIunp\fP の位置の共用体が変換される。引き数
 285 \fIchoices\fP は \fBxdr_discrim\fP()  構造体の配列へのポインターである。各構造体は [\fIvalue\fP,\fIproc\fP]
 286 の順序付きペアを格納している。 もし共用体の分別要素が関連付けられた \fIvalue\fP と等しい場合には、共用体を変換するために \fIproc\fP
 287 が呼び出される。 \fBxdr_discrim\fP()  構造体の配列の最後は、値 NULL のルーティン を指定することで示される。 分別要素が
 288 \fIchoices\fP 配列の中に見つからなかった場合、 \fIdefaultarm\fP が (NULL でなければ) 呼び出される。 成功した場合は 1
 289 を返す。失敗した場合はゼロを返す。
 290 .LP
 291 .nf
 292 \fBbool_t xdr_vector(XDR *\fP\fIxdrs\fP\fB, char *\fP\fIarrp\fP\fB, unsigned int \fP\fIsize\fP\fB,\fP
 293 \fB                  unsigned int \fP\fIelsize\fP\fB, xdrproc_t \fP\fIelproc\fP\fB);\fP
 294 .fi
 295 .IP
 296 固定長の配列とそれらが対応する外部表現とを変換する基本フィルター。 引き数 \fIarrp\fP は配列へのポインターのアドレスである。一方で \fIsize\fP
 297 は配列の要素数そのものである。引き数 \fIelsize\fP は配列の各要素の \fIsizeof\fP で、 \fIelproc\fP は配列の要素を C
 298 形式からその外部表現へと変換する XDR フィルターである。 このルーティンは成功した場合 1 を返す。 失敗した場合はゼロを返す。
 299 .LP
 300 .nf
 301 \fBbool_t xdr_void(void);\fP
 302 .fi
 303 .IP
 304 このルーティンは常に 1 を返す。 これは何も行なわないが、関数引き数が必要な RPC ルーティンに渡すことができる。
 305 .LP
 306 .nf
 307 \fBbool_t xdr_wrapstring(XDR *\fP\fIxdrs\fP\fB, char **\fP\fIsp\fP\fB);\fP
 308 .fi
 309 .IP
 310 \fBxdr_string(xdrs, sp, \s-1MAXUN.UNSIGNED\s0 );\fP を呼び出す基本ルーティン。 ここで
 311 \fBMAXUN.UNSIGNED\fP は符号無し整数(unsigned int)の最大値である。 \fBxdr_wrapstring\fP()  は、 RPC
 312 パッケージは二つの XDR ルーティンの最大値を引き数として渡すため便利である。 \fBxdr_string\fP()
 313 は最も頻繁に利用される基本ルーティンであるが三つを要求する。 成功した場合は 1 を返す、失敗した場合はゼロを返す。
 314 .SH 関連項目
 315 \fBrpc\fP(3)
 316 .LP
 317 以下のマニュアル:
 318 .RS
 319 eXternal Data Representation Standard: Protocol Specification
 320 .br
 321 eXternal Data Representation: Sun Technical Notes
 322 .br
 323 \fIXDR: External Data Representation Standard\fP, RFC\ 1014, Sun Microsystems,
 324 Inc., USC\-ISI.
 325 .RE
 326 .SH この文書について
 327 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 328 である。プロジェクトの説明とバグ報告に関する情報は
 329 http://www.kernel.org/doc/man\-pages/ に書かれている。