.\"
.TH RPC 3 2013\-09\-26 "" "Linux Programmer's Manual"
.SH 名前
-rpc \- é\81 é\9a\94æ\89\8bç¶\9aã\81\8då\91¼ã\81³å\87ºã\81\97(RPC)ã\81®ã\81\9fã\82\81ã\81®ã\83©ã\82¤ã\83\96ã\83©ã\83ªã\83»ã\83«ã\83¼ã\83\86ã\82£ã\83³
+rpc \- 遠隔手続き呼び出し(RPC)のためのライブラリルーティン
.SH 書式と説明
.\" .LP
.\" We don't have an rpc_secure.3 page at the moment -- MTK, 19 Sep 05
.\" Routines that are used for Secure RPC (DES authentication) are described in
.\" .BR rpc_secure (3).
.\" Secure RPC can be used only if DES encryption is available.
-ã\81\93ã\82\8cã\82\89ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ C ã\83\97ã\83ã\82°ã\83©ã\83 ã\81§ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82\92é\80\9aã\81\97ã\81¦ ä»\96ã\81®ã\83\9eã\82·ã\83³ã\81«ã\82¢ã\82¯ã\82»ã\82¹ã\81\99ã\82\8bã\83\97ã\83ã\82·ã\82¸ã\83£を作成することを可能にする。
-æ\9c\80å\88\9dã\81«ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯ã\83\87ã\83¼ã\82¿ã\83\91ã\82±ã\83\83ã\83\88ã\82\92ã\82µã\83¼ã\83\90ã\81«é\80\81ã\82\8bã\81\9fã\82\81ã\81« ã\83\97ã\83ã\82·ã\82¸ã\83£を呼び出す。 サーバはパケットを受け取ると、配分ルーチンを呼び出して
-è¦\81æ±\82ã\81\95ã\82\8cã\81\9fã\82µã\83¼ã\83\93ã\82¹ã\81«å®\9fè¡\8cã\81\97ã\80\81è¿\94ç\94ã\82\92é\80\81ã\82\8aè¿\94ã\81\99ã\80\82 æ\9c\80å¾\8cã\81«ã\83\97ã\83ã\82·ã\82¸ã\83£ã\83»コールはクライアントへと戻る。
+ã\81\93ã\82\8cã\82\89ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ C ã\83\97ã\83ã\82°ã\83©ã\83 ã\81§ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82\92é\80\9aã\81\97ã\81¦ ä»\96ã\81®ã\83\9eã\82·ã\83³ã\81«ã\82¢ã\82¯ã\82»ã\82¹ã\81\99ã\82\8bã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を作成することを可能にする。
+æ\9c\80å\88\9dã\81«ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯ã\83\87ã\83¼ã\82¿ã\83\91ã\82±ã\83\83ã\83\88ã\82\92ã\82µã\83¼ã\83\90ã\81«é\80\81ã\82\8bã\81\9fã\82\81ã\81« ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を呼び出す。 サーバはパケットを受け取ると、配分ルーチンを呼び出して
+è¦\81æ±\82ã\81\95ã\82\8cã\81\9fã\82µã\83¼ã\83\93ã\82¹ã\81«å®\9fè¡\8cã\81\97ã\80\81è¿\94ç\94ã\82\92é\80\81ã\82\8aè¿\94ã\81\99ã\80\82 æ\9c\80å¾\8cã\81«ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼コールはクライアントへと戻る。
.LP
-これらのルーティンを使用するには、ヘッダファイル \fI<rpc/rpc.h>\fP をインクルードすること。
+ã\81\93ã\82\8cã\82\89ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\82\92使ç\94¨ã\81\99ã\82\8bã\81«ã\81¯ã\80\81ã\83\98ã\83\83ã\83\80ã\83¼ã\83\95ã\82¡ã\82¤ã\83« \fI<rpc/rpc.h>\fP ã\82\92ã\82¤ã\83³ã\82¯ã\83«ã\83¼ã\83\89ã\81\99ã\82\8bã\81\93ã\81¨ã\80\82
下記のプロトタイプでは次の型を使用している。
.in +4n
.fi
.in
.LP
-型 \fIAUTH\fP, \fICLIENT\fP, \fISVCXPRT\fP, \fIXDR\fP の宣言についてはヘッダファイルを参照。
+å\9e\8b \fIAUTH\fP, \fICLIENT\fP, \fISVCXPRT\fP, \fIXDR\fP ã\81®å®£è¨\80ã\81«ã\81¤ã\81\84ã\81¦ã\81¯ã\83\98ã\83\83ã\83\80ã\83¼ã\83\95ã\82¡ã\82¤ã\83«ã\82\92å\8f\82ç\85§ã\80\82
.LP
.nf
\fBvoid auth_destroy(AUTH *\fP\fIauth\fP\fB);\fP
\fBAUTH *authnone_create(void);\fP
.fi
.IP
-å\90\84ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\83»コールで使用できない仮の認証情報として渡される RPC 認証ハンドルを作成して返す。 これは RPC
+å\90\84ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼コールで使用できない仮の認証情報として渡される RPC 認証ハンドルを作成して返す。 これは RPC
で使用されるデフォルトの認証である。
.LP
.nf
.fi
.IP
認証情報を含んだ RPC 認証ハンドルを作成して返す。 \fIhost\fP パラメーターは情報が作成されたマシンの名前である。 \fIuid\fP
-ã\81¯ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\81®ã\83¦ã\83¼ã\82¶
+ã\81¯ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81®ã\83¦ã\83¼ã\82¶ã\83¼
.SM ID
-、 \fIgid\fP はそのユーザの現在のグループ
+ã\80\81 \fIgid\fP ã\81¯ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81®ç\8f¾å\9c¨ã\81®ã\82°ã\83«ã\83¼ã\83\97
.SM ID
である。 \fIlen\fP と
-\fIaup_gids\fP ã\81¯ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\81\8cæ\89\80å±\9eã\81\99ã\82\8bã\82°ã\83«ã\83¼ã\83\97ã\81®é\85\8då\88\97ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\82\8bã\80\82 ä»\96ã\81®ã\83¦ã\83¼ã\82¶になりすますことは簡単である。
+\fIaup_gids\fP ã\81¯ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81\8cæ\89\80å±\9eã\81\99ã\82\8bã\82°ã\83«ã\83¼ã\83\97ã\81®é\85\8då\88\97ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\82\8bã\80\82 ä»\96ã\81®ã\83¦ã\83¼ã\82¶ã\83¼になりすますことは簡単である。
.LP
.nf
\fBAUTH *authunix_create_default(void);\fP
\fB xdrproc_t \fP\fIoutproc\fP\fB, char *\fP\fIout\fP\fB);\fP
.fi
.IP
-ã\83\9eã\82·ã\83³ \fIhost\fP ä¸\8aã\81§ \fIprognum\fP, \fIversnum\fP, \fIprocnum\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9fã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£を呼び出す。
-ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ \fIin\fP ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£の引き数のアドレスであり \fIout\fP は結果を格納するアドレスである。 \fIinproc\fP
-ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£のパラメーターをエンコードするのに使用され、 \fIoutproc\fP は結果をデコードするのに使用される。
+ã\83\9eã\82·ã\83³ \fIhost\fP ä¸\8aã\81§ \fIprognum\fP, \fIversnum\fP, \fIprocnum\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9fã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を呼び出す。
+ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ \fIin\fP ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼の引き数のアドレスであり \fIout\fP は結果を格納するアドレスである。 \fIinproc\fP
+ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼のパラメーターをエンコードするのに使用され、 \fIoutproc\fP は結果をデコードするのに使用される。
このルーティンは成功した場合にはゼロを返す。失敗した場合には \fBenum clnt_stat\fP を整数にキャストした値を返す。
\fBclnt_perrno\fP() ルーティンが失敗の状態をメッセージに変換するのに使用できる。
.IP
-è¦å\91\8a: ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81§ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£を呼び出すと通信には UDP/IP が使用される。この際の制限については
+è¦å\91\8a: ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81§ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を呼び出すと通信には UDP/IP が使用される。この際の制限については
\fBclntudp_create\fP() を参照すること。このルーティンを使用して認証や時間切れの制御を することはできない。
.LP
.nf
\fB resultproc_t \fP\fIeachresult\fP\fB);\fP
.fi
.IP
-\fBcallrpc\fP() ã\81¨å\90\8cæ§\98ã\81§ã\81\82ã\82\8bã\81\8cã\80\81ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ã\81\8cã\83ã\83¼ã\82«ã\83«ã\81®ã\83\96ã\83ã\83¼ã\83\89ã\82ã\83£ã\82¹ã\83\88ã\83»ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯
+\fBcallrpc\fP() と同様であるが、メッセージがローカルのブロードキャストネットワーク
全体へとブロードキャストされる点が異っている。回答を受け取る度に このルーティンは以下の形式の \fBeachresult\fP() を呼び出す。
.IP
.in +4n
.in
.IP
ここで \fIout\fP は \fBclnt_broadcast\fP() に渡される \fIout\fP
-ã\81¨å\90\8cã\81\98ã\81§ã\81\82ã\82\8bã\81\8cã\80\81ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£からの出力がデコードされている 点のみが異っている。 \fIaddr\fP
+ã\81¨å\90\8cã\81\98ã\81§ã\81\82ã\82\8bã\81\8cã\80\81ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼からの出力がデコードされている 点のみが異っている。 \fIaddr\fP
は結果を送って来たマシンのアドレスを指している。 \fBeachresult\fP() がゼロを返した場合、 \fBclnt_broadcast\fP()
はさらなる回答を待つ。そうでなければ適切な状態で終了する。
.IP
-è¦å\91\8a: ã\83\96ã\83ã\83¼ã\83\89ã\82ã\83£ã\82¹ã\83\88ã\83»ã\82½ã\82±ã\83\83ã\83\88ã\81¯ã\83\87ã\83¼ã\82¿ã\83ªã\83³ã\82¯å±¤ã\81®æ\9c\80大転é\80\81å\8d\98ä½\8dã\81« å\88¶é\99\90ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\80\82ã\82¤ã\83¼ã\82µã\83\8dã\83\83ã\83\88ã\81®å ´å\90\88ã\80\81æ\9c\80大å\80¤ã\81¯ 1500 ã\83\90ã\82¤ã\83\88ã\81§ã\81\82ã\82\8bã\80\82
+警告: ブロードキャストソケットはデータリンク層の最大転送単位に 制限されている。イーサネットの場合、最大値は 1500 バイトである。
.LP
.nf
\fBenum clnt_stat clnt_call(CLIENT *\fP\fIclnt\fP\fB, unsigned long \fP\fIprocnum\fP\fB,\fP
\fB struct timeval \fP\fItout\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83\9eã\82¯ã\83ã\81¯ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\83»ã\83\8fã\83³ã\83\89ã\83« \fIclnt\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9f \fIprocnum\fP ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\82\92å\91¼ã\81³å\87ºã\81\99ã\80\82 ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\83»ハンドルは
+ã\81\93ã\81®ã\83\9eã\82¯ã\83ã\81¯ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\83\8fã\83³ã\83\89ã\83« \fIclnt\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9f \fIprocnum\fP ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\82\92å\91¼ã\81³å\87ºã\81\99ã\80\82 ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ハンドルは
\fBclnt_create\fP() のような
.SM RPC
クライアント作成ルーティンによって得られる。 パタメータ \fIin\fP
-ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£ã\81®å¼\95ã\81\8dæ\95°ã\81®ã\82¢ã\83\89ã\83¬ã\82¹ã\81§ã\81\82ã\82\8bã\80\82 \fIout\fP ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£の返り値を格納するアドレスである。 \fIinproc\fP
-ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\82\92ã\82¨ã\83³ã\82³ã\83¼ã\83\89ã\81\99ã\82\8bã\81®ã\81«ä½¿ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82 \fIoutproc\fP ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£ã\81®è¿\94ã\82\8aå\80¤ã\82\92ã\83\87ã\82³ã\83¼ã\83\89ã\81\99ã\82\8bã\81®ã\81«ä½¿ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82 \fItout\fP
-は結果が返されるのを待つ時間である。
+ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\81®å¼\95ã\81\8dæ\95°ã\81®ã\82¢ã\83\89ã\83¬ã\82¹ã\81§ã\81\82ã\82\8bã\80\82 \fIout\fP ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼の返り値を格納するアドレスである。 \fIinproc\fP
+ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\82\92ã\82¨ã\83³ã\82³ã\83¼ã\83\89ã\81\99ã\82\8bã\81®ã\81«ä½¿ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82 \fIoutproc\fP ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\81®è¿\94ã\82\8aå\80¤ã\82\92ã\83\87ã\82³ã\83¼ã\83\89ã\81\99ã\82\8bã\81®ã\81«ä½¿ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82
+\fItout\fP は結果が返されるのを待つ時間である。
.LP
.nf
\fBclnt_destroy(CLIENT *\fP\fIclnt\fP\fB);\fP
デフォルトの時間切れが設定されるが、 \fBclnt_control\fP() を使用して変更可能である。
.IP
警告: UDP を使用した場合には欠点がある。 UDP に基づいた RPC メッセージは 最大でも 8 KByte のエンコードデータしか保持する
-ã\81\93ã\81¨ã\81\8cã\81§ã\81\8dã\81ªã\81\84ã\81\9fã\82\81ã\80\81大ã\81\8dã\81ªå¼\95ã\81\8dæ\95°ã\82\84巨大ã\81ªçµ\90æ\9e\9cã\82\92å\8f\96ã\82\8bã\83\97ã\83ã\82·ã\82¸ã\83£に は使用することができない。
+ã\81\93ã\81¨ã\81\8cã\81§ã\81\8dã\81ªã\81\84ã\81\9fã\82\81ã\80\81大ã\81\8dã\81ªå¼\95ã\81\8dæ\95°ã\82\84巨大ã\81ªçµ\90æ\9e\9cã\82\92å\8f\96ã\82\8bã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼に は使用することができない。
.LP
.nf
\fBbool_t clnt_control(CLIENT *\fP\fIcl\fP\fB, int \fP\fIreq\fP\fB, char *\fP\fIinfo\fP\fB);\fP
\fBvoid clnt_geterr(CLIENT *\fP\fIclnt\fP\fB, struct rpc_err *\fP\fIerrp\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83\9eã\82¯ã\83ã\81¯ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\83»ã\83\8fã\83³ã\83\89ã\83«ã\81®ã\82¨ã\83©ã\83¼æ§\8bé\80 ä½\93ã\82\92 \fIerrp\fP ã\82¢ã\83\89ã\83¬ã\82¹ã\81§æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fæ§\8bé\80 ä½\93ã\81¸ã\82³ã\83\94ã\83¼ã\81\99ã\82\8bã\80\82
+このマクロはクライアントハンドルのエラー構造体を \fIerrp\fP アドレスで指定された構造体へコピーする。
.LP
.nf
\fBvoid clnt_pcreateerror(char *\fP\fIs\fP\fB);\fP
\fBCLIENT *clntraw_create(unsigned long \fP\fIprognum\fP\fB, unsigned long \fP\fIversnum\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 \fIprognum\fPã\80\81 ã\83\90ã\83¼ã\82¸ã\83§ã\83³ \fIversnum\fP ã\81®ã\81\9fã\82\81ã\81®æ\93¬ä¼¼ RPC
+このルーティンはリモートプログラム \fIprognum\fP、 バージョン \fIversnum\fP のための擬似 RPC
クライアントを作成する。メッセージをサービスに渡すために使用する 通信は実際にはそのプロセスのアドレス空間にあるバッファーである。 それで、対応する
RPC サーバが同じアドレス空間の中にいなければならない。 \fBsvcraw_create\fP() を参照すること。 これにより RPC
-ã\81®ã\82·ã\83\9fã\83¥ã\83¬ã\83¼ã\82·ã\83§ã\83³ã\82\84ã\80\81ã\82«ã\83¼ã\83\8dã\83«ã\83»ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81«å½±é\9f¿ã\81\95ã\82\8cã\81\9aã\81« å¿\9cç\94æ\99\82é\96\93ã\81ªã\81©ã\81® RPC ã\82ªã\83¼ã\83\90ã\83\98ã\83\83ã\83\89ã\81®ç\8d²å¾\97ã\81\8cã\81§ã\81\8dã\82\8bã\80\82 失æ\95\97ã\81\97ã\81\9få ´å\90\88ã\81«ã\81¯ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯
+のシミュレーションや、カーネルインターフェースに影響されずに 応答時間などの RPC オーバヘッドの獲得ができる。 失敗した場合にはこのルーティンは
NULL を返す。
.LP
.nf
.fi
.IP
.\"The following inline font conversion is necessary for the hyphen indicator
-ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 \fIprognum\fPã\80\81 ã\83\90ã\83¼ã\82¸ã\83§ã\83³ \fIversnum\fP ã\81®ã\81\9fã\82\81ã\81® RPC
-ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« TCP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88ã\83»アドレスの \fI*addr\fP にある。
-\fIaddr\->sin_port\fP ã\81\8cã\82¼ã\83ã\81ªã\82\89ã\81°ã\80\81å®\9fé\9a\9bã\81«ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81\8c listen
+このルーティンはリモートプログラム \fIprognum\fP、 バージョン \fIversnum\fP のための RPC
+ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« TCP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88アドレスの \fI*addr\fP にある。
+\fIaddr\->sin_port\fP がゼロならば、実際にリモートプログラムが listen
しているポートが設定される。(この情報のためにリモートの \fBportmap\fP サービスが利用される。) パラメーター \fIsockp\fP
はソケットである。もしこれが \fBRPC_ANYSOCK\fP に設定されている場合は、このルーティンが新しいソケットをオープンして \fIsockp\fP
-ã\81«è¨å®\9aã\81\99ã\82\8bã\80\82 TCP ã\81«å\9fºã\81¥ã\81\84ã\81\9f RPC ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\81\95ã\82\8cã\81\9f I/O ã\82\92使ç\94¨ã\81\99ã\82\8bã\81\9fã\82\81ã\80\81ã\83¦ã\83¼ã\82¶はパラメーター \fIsendsz\fP と \fIrecvsz\fP
-ã\82\92使ç\94¨ã\81\97ã\81¦é\80\81ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\81¨å\8f\97ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡のサイズを指定することができる。 ゼロを指定した場合には適切なデフォルトが選択される。
+ã\81«è¨å®\9aã\81\99ã\82\8bã\80\82 TCP ã\81«å\9fºã\81¥ã\81\84ã\81\9f RPC ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\95ã\82\8cã\81\9f I/O ã\82\92使ç\94¨ã\81\99ã\82\8bã\81\9fã\82\81ã\80\81ã\83¦ã\83¼ã\82¶ã\83¼はパラメーター \fIsendsz\fP と \fIrecvsz\fP
+ã\82\92使ç\94¨ã\81\97ã\81¦é\80\81ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81¨å\8f\97ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼のサイズを指定することができる。 ゼロを指定した場合には適切なデフォルトが選択される。
このルーティンは失敗した場合は NULL を返す。
.LP
.nf
\fB struct timeval \fP\fIwait\fP\fB, int *\fP\fIsockp\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 \fIprognum\fPã\80\81 ã\83\90ã\83¼ã\82¸ã\83§ã\83³ \fIversnum\fP ã\81®ã\81\9fã\82\81ã\81® RPC
-ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« UDP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88ã\83»アドレスの \fI*addr\fP にある。
-\fIaddr\->sin_port\fP ã\81\8cã\82¼ã\83ã\81ªã\82\89ã\81°ã\80\81å®\9fé\9a\9bã\81«ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81\8c listen
+このルーティンはリモートプログラム \fIprognum\fP、 バージョン \fIversnum\fP のための RPC
+ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« UDP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88アドレスの \fI*addr\fP にある。
+\fIaddr\->sin_port\fP がゼロならば、実際にリモートプログラムが listen
しているポートが設定される。(この情報のためにリモートの \fBportmap\fP サービスが利用される。) パラメーター \fIsockp\fP
はソケットである。もしこれが \fBRPC_ANYSOCK\fP に設定されている場合は、このルーティンが新しいソケットをオープンして \fIsockp\fP
に設定する。 UDP 通信は回答があるか、時間切れが起こるまで \fBwait\fP 間隔で呼び出しメッセージを再送する。時間切れが起こるまでの合計時間は
\fBclnt_call\fP() で指定する。
.IP
警告: UDP に基づいた RPC メッセージは最大でも 8 Kbyte までのエンコードされたデータしか
-ä¿\9dæ\8c\81ã\81§ã\81\8dã\81ªã\81\84ã\81\9fã\82\81ã\80\81ã\81\93ã\81®é\80\9aä¿¡ã\81¯å¤§ã\81\8dã\81ªå¼\95ã\81\8dæ\95°ã\82\84巨大ã\81ªçµ\90æ\9e\9cã\82\92å\8f\96ã\82\8b ã\83\97ã\83ã\82·ã\82¸ã\83£には使用できない。
+ä¿\9dæ\8c\81ã\81§ã\81\8dã\81ªã\81\84ã\81\9fã\82\81ã\80\81ã\81\93ã\81®é\80\9aä¿¡ã\81¯å¤§ã\81\8dã\81ªå¼\95ã\81\8dæ\95°ã\82\84巨大ã\81ªçµ\90æ\9e\9cã\82\92å\8f\96ã\82\8b ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼には使用できない。
.LP
.nf
\fBCLIENT *clntudp_bufcreate(struct sockaddr_in *\fP\fIaddr\fP\fB,\fP
\fB unsigned int \fP\fIsendsize\fP\fB, unsigned int \fP\fIrecosize\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 \fIprognum\fPã\80\81 ã\83\90ã\83¼ã\82¸ã\83§ã\83³ \fIversnum\fP ã\81®ã\81\9fã\82\81ã\81® RPC
-ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« UDP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88ã\83»アドレスの \fI*addr\fP にある。
-\fIaddr\->sin_port\fP ã\81\8cã\82¼ã\83ã\81ªã\82\89ã\81°ã\80\81å®\9fé\9a\9bã\81«ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82°ã\83©ã\83 ã\81\8c listen
+このルーティンはリモートプログラム \fIprognum\fP、 バージョン \fIversnum\fP のための RPC
+ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bã\80\82ã\82¯ã\83©ã\82¤ã\82¢ã\83³ã\83\88ã\81¯é\80\9aä¿¡ã\81« UDP/IP ã\82\92使ç\94¨ã\81\99ã\82\8bã\80\82ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82°ã\83©ã\83 ã\81¯ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88アドレスの \fI*addr\fP にある。
+\fIaddr\->sin_port\fP がゼロならば、実際にリモートプログラムが listen
しているポートが設定される。(この情報のためにリモートの \fBportmap\fP サービスが利用される。) パラメーター \fIsockp\fP
はソケットである。もしこれが \fBRPC_ANYSOCK\fP に設定されている場合は、このルーティンが新しいソケットをオープンして \fIsockp\fP
に設定する。 UDP 通信は回答があるか、時間切れが起こるまで \fBwait\fP 間隔で呼び出しメッセージを再送する。時間切れが起こるまでの合計時間は
\fBvoid get_myaddress(struct sockaddr_in *\fP\fIaddr\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83\9eã\82·ã\83³ã\81® IP ã\82¢ã\83\89ã\83¬ã\82¹ã\82\92 \fI*addr\fP ã\81«æ ¼ç´\8dã\81\99ã\82\8bã\80\82 \fI/etc/hosts\fP ã\82\92æ\89±ã\81\86ã\83©ã\82¤ã\83\96ã\83©ã\83ªã\83»ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ä½¿ç\94¨ã\81\97ã\81ªã\81\84ã\80\82ã\83\9dã\83¼ã\83\88ç\95ªå\8f·ã\81¯å¸¸ã\81«
+このマシンの IP アドレスを \fI*addr\fP に格納する。 \fI/etc/hosts\fP を扱うライブラリルーティンは使用しない。ポート番号は常に
\fBhtons(PMAPPORT)\fP に設定される。
.LP
.nf
\fBstruct pmaplist *pmap_getmaps(struct sockaddr_in *\fP\fIaddr\fP\fB);\fP
.fi
.IP
-\fBportmap\fP サービスのためのユーザインターフェースであり、 IP アドレス \fI*addr\fP にあるホストの現在の RPC
+\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81§ã\81\82ã\82\8aã\80\81 IP ã\82¢ã\83\89ã\83¬ã\82¹ \fI*addr\fP ã\81«ã\81\82ã\82\8bã\83\9bã\82¹ã\83\88ã\81®ç\8f¾å\9c¨ã\81® RPC
プログラムからポート番号へのマッピングの一覧を返す。 このルーティンが NULL を返す場合もある。 `\fBrpcinfo \-p\fP'
コマンドはこのルーティンを使用している。
.LP
\fB unsigned int \fP\fIprotocol\fP\fB);\fP
.fi
.IP
-\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83»インターフェースで、 プログラム番号 \fIprognum\fP、 バージョン \fIversnum\fP、
+\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83¼インターフェースで、 プログラム番号 \fIprognum\fP、 バージョン \fIversnum\fP、
関連付けられた通信プロトコル \fIprotocol\fP をサポートするサービスが待っているポート番号を返す。 \fIprotocol\fP の値はほとんどの場合
IPPROTO_UDP か IPPROTO_TCP である。 返り値ゼロはマッピングが存在しないか、 RPC システムがリモートの \fBportmap\fP
サービスの参照に失敗したことを意味する。後者の場合は大域変数 \fIrpc_createerr\fP が RPC 状態を保持している。
\fB struct timeval \fP\fItout\fP\fB, unsigned long *\fP\fIportp\fP\fB);\fP
.fi
.IP
-\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83»インターフェースで、 IP アドレス \fI*addr\fP のホストの \fBportmap\fP を参照して、
-RPC å\91¼ã\81³å\87ºã\81\97ã\82\92ç\94\9fæ\88\90ã\81\97ã\80\81ã\81\9dã\81®ã\83\9bã\82¹ã\83\88ä¸\8aã\81®ã\83\97ã\83ã\82·ã\82¸ã\83£を呼び出す。 パラメーター \fI*portp\fP
-ã\81¯ã\83\97ã\83ã\82·ã\82¸ã\83£が成功した場合にはプログラムのポート番号に修正される。 他のパラメーターの定義については \fBcallrpc\fP() や
-\fBclnt_call\fP() ã\81§èª¬æ\98\8eã\81\97ã\81¦ã\81\82ã\82\8bã\80\82 ã\81\93ã\81®ã\83\97ã\83ã\82·ã\82¸ã\83£は \(lqping\(rq のみに使用すべきである。
+\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83¼インターフェースで、 IP アドレス \fI*addr\fP のホストの \fBportmap\fP を参照して、
+RPC å\91¼ã\81³å\87ºã\81\97ã\82\92ç\94\9fæ\88\90ã\81\97ã\80\81ã\81\9dã\81®ã\83\9bã\82¹ã\83\88ä¸\8aã\81®ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を呼び出す。 パラメーター \fI*portp\fP
+ã\81¯ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼が成功した場合にはプログラムのポート番号に修正される。 他のパラメーターの定義については \fBcallrpc\fP() や
+\fBclnt_call\fP() ã\81§èª¬æ\98\8eã\81\97ã\81¦ã\81\82ã\82\8bã\80\82 ã\81\93ã\81®ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼は \(lqping\(rq のみに使用すべきである。
\fBclnt_broadcast\fP() も参照すること。
.LP
.nf
\fB unsigned int \fP\fIprotocol\fP\fB, unsigned short \fP\fIport\fP\fB);\fP
.fi
.IP
-\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83»インターフェースで、 [\fIprognum\fP,\fIversnum\fP,\fIprotocol\fP]
+\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83¼インターフェースで、 [\fIprognum\fP,\fIversnum\fP,\fIprotocol\fP]
の組み合わせと \fIport\fP との間のマッピングを、そのマシン上の \fBportmap\fP サービスに登録する。 \fIprotocol\fP
はほとんどの場合 \fBIPPROTO_UDP\fP か \fBIPPROTO_TCP\fP のどちらかである。 このルーティンは成功した場合には 1
を返す。失敗した場合にはゼロを返す。 \fBsvc_register\fP() によって自動的に実行される。
\fBbool_t pmap_unset(unsigned long \fP\fIprognum\fP\fB, unsigned long \fP\fIversnum\fP\fB);\fP
.fi
.IP
-\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83»インターフェースで、 [\fIprognum\fP,\fIversnum\fP,\fI*\fP] の組み合わせと
+\fBportmap\fP ã\82µã\83¼ã\83\93ã\82¹ã\81®ã\81\9fã\82\81ã\81®ã\83¦ã\83¼ã\82¶ã\83¼インターフェースで、 [\fIprognum\fP,\fIversnum\fP,\fI*\fP] の組み合わせと
\fBports\fP の間のマッピングをそのマシン上の \fBportmap\fP サービスから削除する。このルーティンは成功した場合は 1 を返す。
失敗した場合には 0 を返す。
.LP
\fB xdrproc_t \fP\fIinproc\fP\fB, xdrproc_t \fP\fIoutproc\fP\fB);\fP
.fi
.IP
-RPC ã\82µã\83¼ã\83\93ã\82¹ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\82\92使ç\94¨ã\81\97ã\81¦ \fIprocname\fP ã\83\97ã\83ã\82·ã\82¸ã\83£を登録する。プログラム \fIprognum\fP、 バージョン
-\fIversnum\fPã\80\81 ã\83\97ã\83ã\82·ã\82¸ã\83£ \fIprocnum\fP への要求が届いた場合、 \fIprocname\fP
+RPC ã\82µã\83¼ã\83\93ã\82¹ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\82\92使ç\94¨ã\81\97ã\81¦ \fIprocname\fP ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼を登録する。プログラム \fIprognum\fP、 バージョン
+\fIversnum\fPã\80\81 ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ \fIprocnum\fP への要求が届いた場合、 \fIprocname\fP
がパラメーターへのポインターを持って呼び出される。 \fIprogname\fP は静的な結果へのポインターを返す必要がある。 \fIinproc\fP
はパラメーターをデコードするために使用される。 \fIoutproc\fP は結果をエンコードするために使用される。
このルーティンは登録に成功した場合にはゼロを返す。 失敗した場合には \-1 を返す。
.IP
-è¦å\91\8a: ã\81\93ã\81®å½¢å¼\8fã\81§ç\99»é\8c²ã\81\95ã\82\8cã\81\9fã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£は UDP/IP 通信を使用する。制限に関しては \fBsvcudp_create\fP()
+è¦å\91\8a: ã\81\93ã\81®å½¢å¼\8fã\81§ç\99»é\8c²ã\81\95ã\82\8cã\81\9fã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼は UDP/IP 通信を使用する。制限に関しては \fBsvcudp_create\fP()
を参照すること。
.LP
.nf
\fBfd_set \fP\fIsvc_fdset\fP\fB;\fP
.fi
.IP
-RPC ã\82µã\83¼ã\83\93ã\82¹å\81´ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81®ã\83\93ã\83\83ã\83\88ã\83\9eã\82¹ã\82¯ã\82\92å\8f\8dæ\98 ã\81\97ã\81\9f大å\9f\9få¤\89æ\95°ã\80\82 \fBselect\fP(2)
+RPC サービス側のファイルディスクリプターのビットマスクを反映した大域変数。 \fBselect\fP(2)
システムコールのパラメーターのために利用できる。これは、サービスの実装者が \fBsvc_run\fP()
を呼び出さずに、独自の非同期イベント処理を用いる場合にのみ意味がある。 この変数は読み込み専用で (そのまま \fBselect\fP(2)
へ渡してはならない!)、 \fBsvc_getreqset\fP() 呼び出しや生成ルーティンの後に変更されているかもしれない。
\fBsvc_freeargs(SVCXPRT *\fP\fIxprt\fP\fB, xdrproc_t \fP\fIinproc\fP\fB, char *\fP\fIin\fP\fB);\fP
.fi
.IP
-ã\81\93ã\81®ã\83\9eã\82¯ã\83ã\81¯ã\82µã\83¼ã\83\93ã\82¹ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£が \fBsvc_getargs\fP() を使用して引き数をデコードした時に RPC/XDR
+ã\81\93ã\81®ã\83\9eã\82¯ã\83ã\81¯ã\82µã\83¼ã\83\93ã\82¹ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼が \fBsvc_getargs\fP() を使用して引き数をデコードした時に RPC/XDR
システムによって割り当てられたデータを解放する。 このルーティンは解放に成功した場合には 1 を返す。 失敗した場合にはゼロを返す。
.LP
.nf
\fBstruct sockaddr_in *svc_getcaller(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-RPC ã\82µã\83¼ã\83\93ã\82¹é\80\9aä¿¡ã\83\8fã\83³ã\83\89ã\83« \fIxprt\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9fã\83\97ã\83ã\82·ã\82¸ã\83£ã\81®å\91¼ã\81³å\87ºã\81\97å\85\83ã\81®ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\83»アドレスを 取得するための標準的な手段。
+RPC ã\82µã\83¼ã\83\93ã\82¹é\80\9aä¿¡ã\83\8fã\83³ã\83\89ã\83« \fIxprt\fP ã\81«é\96¢é\80£ä»\98ã\81\91ã\82\89ã\82\8cã\81\9fã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\81®å\91¼ã\81³å\87ºã\81\97å\85\83ã\81®ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯アドレスを 取得するための標準的な手段。
.LP
.nf
\fBvoid svc_getreqset(fd_set *\fP\fIrdfds\fP\fB);\fP
.IP
このルーティンはサービスの実装者が \fBsvc_run\fP() を呼び出さず、独自の非同期イベント処理を実装する場合にのみ意味がある。 これは
\fBselect\fP(2) システムコールが RPC ソケットに RPC 要求が到着したと返した場合にのみ呼び出される。 \fIrdfds\fP
-ã\81¯çµ\90æ\9e\9cã\81®èªã\81¿è¾¼ã\81¿ã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81®ã\83\93ã\83\83ã\83\88ã\83\9eã\82¹ã\82¯ã\81§ã\81\82ã\82\8bã\80\82 ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ \fIrdfds\fP
+は結果の読み込みファイルディスクリプターのビットマスクである。 このルーティンは \fIrdfds\fP
の値に関連付けられた全てのソケットのサービスが行なわれた時に 返ってくる。
.LP
.nf
\fB unsigned long \fP\fIprotocol\fP\fB);\fP
.fi
.IP
-\fIprognum\fP ã\81¨ \fIversnum\fP ã\82\92ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83\97ã\83ã\82·ã\82¸ã\83£ \fIdispatch\fP で関連付ける。 \fIprotocol\fP
+\fIprognum\fP ã\81¨ \fIversnum\fP ã\82\92ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ \fIdispatch\fP で関連付ける。 \fIprotocol\fP
がゼロの場合、サービスは \fBportmap\fP サービスには登録されない。 \fIprotocol\fP がゼロ以外の場合、
[\fIprognum\fP,\fIversnum\fP,\fIprotocol\fP] の組み合わせと \fIxprt\->xp_port\fP
とのマッピングがローカルの \fBportmap\fP サービスに登録される。(一般的に \fIprotocol\fP はゼロ、 \fBIPPROTO_UDP\fP、
-\fBIPPROTO_TCP\fP ã\81®ã\81©ã\82\8cã\81\8bã\81§ã\81\82ã\82\8bã\80\82) ã\83\97ã\83ã\82·ã\82¸ã\83£ \fIdispatch\fP は以下の形式である:
+\fBIPPROTO_TCP\fP ã\81®ã\81©ã\82\8cã\81\8bã\81§ã\81\82ã\82\8bã\80\82) ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ \fIdispatch\fP は以下の形式である:
.in +4n
.nf
このルーティンは戻ってこない。これは
.SM RPC
要求の到着を待ち、どれかが届いた場合に \fBsvc_getreq\fP()
-ã\82\92使ç\94¨ã\81\97ã\81¦é\81©å\88\87ã\81ªã\82µã\83¼ã\83\93ã\82¹ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\82\92å\91¼ã\81³å\87ºã\81\99ã\80\82 ã\81\93ã\81®ã\83\97ã\83ã\82·ã\82¸ã\83£は通常は \fBselect\fP(2) システムコールから返るのを待っている。
+ã\82\92使ç\94¨ã\81\97ã\81¦é\81©å\88\87ã\81ªã\82µã\83¼ã\83\93ã\82¹ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼ã\82\92å\91¼ã\81³å\87ºã\81\99ã\80\82 ã\81\93ã\81®ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼は通常は \fBselect\fP(2) システムコールから返るのを待っている。
.LP
.nf
\fBbool_t svc_sendreply(SVCXPRT *\fP\fIxprt\fP\fB, xdrproc_t \fP\fIoutproc\fP\fB, char *\fP\fIout\fP\fB);\fP
.fi
.IP
-RPC ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81«ã\82\88ã\81£ã\81¦ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\83»コールの結果を 返すために呼び出される。 パラメーター \fIxprt\fP
+RPC ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81«ã\82\88ã\81£ã\81¦ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼コールの結果を 返すために呼び出される。 パラメーター \fIxprt\fP
はその要求に関連付けられた通信ハンドルである。 \fIoutproc\fP は結果をエンコードするために使用する XDR ルーティンである。 \fIout\fP
は結果のアドレスである。このルーティンは成功した場合は 1 を返す。 失敗した場合はゼロを返す。
.LP
\fBvoid svcerr_auth(SVCXPRT *\fP\fIxprt\fP\fB, enum auth_stat \fP\fIwhy\fP\fB);\fP
.fi
.IP
-èª\8d証ã\82¨ã\83©ã\83¼ã\81«ã\82\88ã\82\8aã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\83»コールの実行を拒否された 場合にサービス配分ルーティンによって呼び出される。
+èª\8d証ã\82¨ã\83©ã\83¼ã\81«ã\82\88ã\82\8aã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼コールの実行を拒否された 場合にサービス配分ルーティンによって呼び出される。
.LP
.nf
\fBvoid svcerr_decode(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-パラメータのデコードに失敗した場合に サービス配分ルーティンによって呼び出される。 \fBsvc_getargs\fP() も参照すること。
+ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81®ã\83\87ã\82³ã\83¼ã\83\89ã\81«å¤±æ\95\97ã\81\97ã\81\9få ´å\90\88ã\81« ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81«ã\82\88ã\81£ã\81¦å\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bã\80\82 \fBsvc_getargs\fP() ã\82\82å\8f\82ç\85§ã\81\99ã\82\8bã\81\93ã\81¨ã\80\82
.LP
.nf
\fBvoid svcerr_noproc(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-è¦\81æ±\82ã\81®ã\81\82ã\81£ã\81\9fã\83\97ã\83ã\82·ã\82¸ã\83£番号が実装されていない場合に サービス配分ルーティンより呼び出される。
+è¦\81æ±\82ã\81®ã\81\82ã\81£ã\81\9fã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼番号が実装されていない場合に サービス配分ルーティンより呼び出される。
.LP
.nf
\fBvoid svcerr_noprog(SVCXPRT *\fP\fIxprt\fP\fB);\fP
\fBvoid svcerr_systemerr(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-ç\89¹å®\9aã\81®ã\83\97ã\83ã\83\88ã\82³ã\83«ã\81«ã\82\88ã\81£ã\81¦ã\82«ã\83\90ã\83¼ã\81\95ã\82\8cã\81¦ã\81\84ã\81ªã\82·ã\82¹ã\83\86ã\83 ã\83»ã\82¨ã\83©ã\83¼ã\81\8c æ¤\9cå\87ºã\81\95ã\82\8cã\81\9få ´å\90\88ã\81«ã\82µã\83¼ã\83\93ã\82¹é\85\8då\88\86ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81«ã\82\88ã\81£ã\81¦å\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bã\80\82
+特定のプロトコルによってカバーされていなシステムエラーが 検出された場合にサービス配分ルーティンによって呼び出される。
例えば、サービスがそれ以上、記憶装置を割り当てることができない場合には このルーティンが呼び出されるかもしれない。
.LP
.nf
\fBvoid svcerr_weakauth(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-èª\8d証ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\81\8c足ã\82\8aã\81ªã\81\84ã\81\9fã\82\81ã\81«ã\83ªã\83¢ã\83¼ã\83\88ã\83»ã\83\97ã\83ã\82·ã\82¸ã\83£ã\83»コールの実行を 拒否された場合にサービス配分ルーティンによって呼び出される。 このルーティンは
+èª\8d証ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81\8c足ã\82\8aã\81ªã\81\84ã\81\9fã\82\81ã\81«ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼コールの実行を 拒否された場合にサービス配分ルーティンによって呼び出される。 このルーティンは
\fBsvcerr_auth(xprt, AUTH_TOOWEAK)\fP を呼び出す。
.LP
.nf
.fi
.IP
任意のオープンされたディスクリプター上にサービスを作成する。 典型的に、ディスクリプターは TCP
-ã\81®ã\82\88ã\81\86ã\81ªã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\83»ã\83\97ã\83ã\83\88ã\82³ã\83«ã\81§æ\8e¥ç¶\9aã\81\95ã\82\8cã\81\9fã\82½ã\82±ã\83\83ã\83\88ã\81§ã\81\82ã\82\8bã\80\82 \fIsendsize\fP ã\81¨ \fIrecvsize\fP
-ã\81«ã\81¯é\80\81ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\81¨å\8f\97ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡の大きさを指定する。もしゼロが指定された 場合は適切なデフォルトが選択される。
+のようなストリームプロトコルで接続されたソケットである。 \fIsendsize\fP と \fIrecvsize\fP
+ã\81«ã\81¯é\80\81ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81¨å\8f\97ä¿¡ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼の大きさを指定する。もしゼロが指定された 場合は適切なデフォルトが選択される。
.LP
.nf
\fBSVCXPRT *svcraw_create(void);\fP
.fi
.IP
-このルーティンは擬似 RPC サービス通信を生成して、そのポインターを返す。 通信は実際にはそのプロセスのアドレス空間にあるバッファなので 対応する
+ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯æ\93¬ä¼¼ RPC ã\82µã\83¼ã\83\93ã\82¹é\80\9aä¿¡ã\82\92ç\94\9fæ\88\90ã\81\97ã\81¦ã\80\81ã\81\9dã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\80\82 é\80\9aä¿¡ã\81¯å®\9fé\9a\9bã\81«ã\81¯ã\81\9dã\81®ã\83\97ã\83ã\82»ã\82¹ã\81®ã\82¢ã\83\89ã\83¬ã\82¹ç©ºé\96\93ã\81«ã\81\82ã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81ªã\81®ã\81§ 対å¿\9cã\81\99ã\82\8b
RPC クライアントは同じアドレス空間にいる必要がある。 \fBclntraw_create\fP() を参照すること。 このルーティンで RPC
-ã\81®ã\82·ã\83\9fã\83¥ã\83¬ã\83¼ã\82·ã\83§ã\83³ã\82\84ã\80\81ã\82«ã\83¼ã\83\8dã\83«ã\83»ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81«å½±é\9f¿ã\81\95ã\82\8cã\81\9aã\81«å¿\9cç\94æ\99\82é\96\93ã\81ªã\81©ã\81® RPC ã\82ªã\83¼ã\83\90ã\83\98ã\83\83ã\83\89ã\82\92å\8f\96å¾\97ã\81\8cã\81§ã\81\8dã\82\8bã\80\82ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯å¤±æ\95\97ã\81\97ã\81\9få ´å\90\88ã\81¯
-NULL を返す。
+ã\81®ã\82·ã\83\9fã\83¥ã\83¬ã\83¼ã\82·ã\83§ã\83³ã\82\84ã\80\81ã\82«ã\83¼ã\83\8dã\83«ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81«å½±é\9f¿ã\81\95ã\82\8cã\81\9aã\81«å¿\9cç\94æ\99\82é\96\93ã\81ªã\81©ã\81® RPC ã\82ªã\83¼ã\83\90ã\83\98ã\83\83ã\83\89ã\82\92å\8f\96å¾\97ã\81\8cã\81§ã\81\8dã\82\8bã\80\82ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯å¤±æ\95\97ã\81\97ã\81\9få ´å\90\88ã\81¯ NULL
+を返す。
.LP
.nf
\fBSVCXPRT *svctcp_create(int \fP\fIsock\fP\fB, unsigned int \fP\fIsend_buf_size\fP\fB,\fP
.IP
このルーティンは TCP/IP に基づく RPC サービス通信を作成し、それへのポインターを返す。 通信はソケット \fIsock\fP に結びつけられる。
\fIsock\fP は \fBRPC_ANYSOCK\fP でも良い。この場合は新しいソケットが作成される。 もしソケットがローカルな TCP ポートに bind
-されていない場合は、 このルーティンが適当なポートに bind する。 補完された場合、\fIxprt\->xp_sock\fP には通信のソケット・
+されていない場合は、 このルーティンが適当なポートに bind する。 補完された場合、\fIxprt\->xp_sock\fP には通信のソケット
ディスクリプターが、\fIxprt\->xp_port\fP には通信のポート番号が 設定される。 このルーティンは失敗した場合は NULL を返す。
-TCP ã\81«å\9fºã\81¥ã\81\84ã\81\9f RPC ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\81\95ã\82\8cã\81\9f I/O ã\82\92使ç\94¨ã\81\99ã\82\8bã\81\9fã\82\81ã\80\81 ã\83¦ã\83¼ã\82¶ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡の大きさを指定できる。
+TCP ã\81«å\9fºã\81¥ã\81\84ã\81\9f RPC ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\95ã\82\8cã\81\9f I/O ã\82\92使ç\94¨ã\81\99ã\82\8bã\81\9fã\82\81ã\80\81 ã\83¦ã\83¼ã\82¶ã\83¼ã\81¯ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼の大きさを指定できる。
ゼロを指定した場合は適切なデフォルトが選択される。
.LP
.nf
\fBvoid xdr_callhdr(XDR *\fP\fIxdrs\fP\fB, struct rpc_msg *\fP\fIchdr\fP\fB);\fP
.fi
.IP
-RPC å\91¼ã\81³å\87ºã\81\97ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\83»ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ã\82\92è¨\98è¿°ã\81\99ã\82\8bã\81\9fã\82\81ã\81«ä½¿ç\94¨ã\81\99ã\82\8bã\80\82 ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯ RPC ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\82\92使ç\94¨ã\81\9bã\81\9aã\81«
+RPC 呼び出しのヘッダーメッセージを記述するために使用する。 このルーティンは RPC パッケージを使用せずに
RPC\-形式のメッセージを作成しようとする場合に便利である。
.LP
.nf
\fBbool_t xdr_pmap(XDR *\fP\fIxdrs\fP\fB, struct pmap *\fP\fIregs\fP\fB);\fP
.fi
.IP
-å\90\84種ã\81® \fBportmap\fP ã\83\97ã\83ã\82·ã\82¸ã\83£へのパラメーターを外部的に記述するために使用する。 このルーティンは \fBpmap\fP
+å\90\84種ã\81® \fBportmap\fP ã\83\97ã\83ã\82·ã\83¼ã\82¸ã\83£ã\83¼へのパラメーターを外部的に記述するために使用する。 このルーティンは \fBpmap\fP
インターフェースを使用せずに、これらのパラメーターを 作成したい場合に便利である。
.LP
.nf
\fBvoid xprt_register(SVCXPRT *\fP\fIxprt\fP\fB);\fP
.fi
.IP
-RPC ã\82µã\83¼ã\83\93ã\82¹é\80\9aä¿¡ã\83\8fã\83³ã\83\89ã\83«ã\82\92ç\94\9fæ\88\90ã\81\97ã\81\9få¾\8cã\81«ã\80\81ã\81\9dã\82\8cã\82\89è\87ªèº«ã\82\92 RPC ã\82µã\83¼ã\83\93ã\82¹ã\83»ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81«ç\99»é\8c²ã\81\99ã\82\8bå¿\85è¦\81ã\81\8cã\81\82ã\82\8bã\80\82 ã\81\93ã\81®ã\83«ã\83¼ã\83\86ã\82£ã\83³ã\81¯å¤§å\9f\9få¤\89æ\95°
+RPC サービス通信ハンドルを生成した後に、それら自身を RPC サービスパッケージに登録する必要がある。 このルーティンは大域変数
\fIsvc_fds\fP を修正する。サービスの実装者は通常、このルーティンは必要ない。
.LP
.nf
\fIRPC: Remote Procedure Call Protocol Specification\fP, RFC\ 1050, Sun
Microsystems, Inc., USC\-ISI.
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.65 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
