ONC+ 開発ガイド

標準インタフェースのルーチン

標準インタフェースはトップレベル、中間レベル、エキスパートレベル、ボトムレベルの 4 つのレベルにわけられます。開発者はこれらのインタフェースを使用して、トランスポートの選択、エラーへの応答または要求の再送まで待つ時間の指定などのパラメータをかなり詳細に制御できます。

トップレベルのルーチン

トップレベルのインタフェースも簡単に使用できますが、RPC 呼び出しを行う前にクライアントハンドルを作成し、RPC 呼び出しを受ける前にサーバーハンドルを作成しなければなりません。アプリケーションをすべてのトランスポート上で実行したい場合は、このインタフェースを使用してください。このルーチンの使用方法とコード例は、「トップレベルのインタフェース」を参照してください。

表 2-2 RPC ルーチン - トップレベル

ルーチン 

説明 

clnt_create()

汎用のクライアント作成ルーチン。このルーチンは、サーバーの位置と、使用するトランスポートのタイプを指定して呼び出す。 

clnt_create_timed()

clnt_create() に似ているが、クライアントの作成を試みる間、各トランスポートタイプに許される最長時間を指定できる。

svc_create()

指定したタイプのトランスポートすべてに対しサーバーハンドルを作成する。このルーチンは、使用するディスパッチ関数を svc_create() に指定して呼び出す。

clnt_call()

要求をサーバーに送信するための手続きをクライアント側から呼び出すルーチン。 

中間レベルのインタフェース

RPC の中間レベルのインタフェースを使用すると、通信を詳細に制御できます。このような下位レベルのインタフェースを使用すると、プログラムは複雑になりますが、効率はよくなります。中間レベルでは特定のトランスポートを指定できます。このルーチンの使用方法とコード例は、「中間レベルのインタフェース」を参照してください。

表 2-3 RPC ルーチン - 中間レベル

ルーチン 

説明 

clnt_tp_create()

指定したトランスポートに対するクライアントハンドルを作成する。 

clnt_tp_create_timed()

clnt_tp_create() に似ているが、許される最長時間を指定できる。

svc_tp_create()

指定したトランスポートに対するサーバーハンドルを作成する。 

clnt_call()

要求をサーバーに送信するための手続きをクライアント側から呼び出す。 

エキスパートレベルのインタフェース

エキスパートレベルには、トランスポートに関連するパラメータを指定するさまざまなルーチンがあります。このルーチンの使用方法とコード例は、「エキスパートレベルのインタフェース」を参照してください。

表 2-4 RPC ルーチン - エキスパートレベル

ルーチン 

説明 

clnt_tli_create()

指定したトランスポートに対するクライアントハンドルを作成する。 

svc_tli_create()

指定したトランスポートに対するサーバーハンドルを作成する。 

rpcb_set()

rpcbind デーモンを呼び出して、RPC サービスとネットワークアドレスとのマップを作成する。

rpcb_unset()

rpcb_set() で作成したマップを削除する。

rpcb_getaddr()

rpcbind デーモンを呼び出して、指定した RPC サービスのトランスポートアドレスを取り出す。

svc_reg()

指定したプログラム番号とバージョン番号のペアを、指定したディスパッチルーチンに関連付ける。 

svc_unreg()

svc_reg() で設定した関連付けを解除する。

clnt_call()

要求をサーバーに送信するための手続きをクライアント側から呼び出す。 

ボトムレベルのインタフェース

ボトムレベルには、トランスポートを完全に制御することができるルーチンがあります。これらのルーチンについては、「ボトムレベルのインタフェース」を参照してください。

表 2-5 RPC ルーチン - ボトムレベル

ルーチン 

説明 

clnt_dg_create()

非接続型トランスポートを使用して、指定した遠隔プログラムに対する RPC クライアントハンドルを作成する。 

svc_dg_create()

非接続型トランスポートを使用して、RPC サーバーハンドルを作成する。 

clnt_vc_create()

接続型トランスポートを使用して、指定した遠隔プログラムに対する RPC クライアントハンドルを作成する。 

svc_vc_create()

接続型トランスポートを使用して、RPC サーバーハンドルを作成する。 

clnt_call()

要求をサーバーに送信するための手続きをクライアント側から呼び出す。