ONC+ 開発ガイド

インタフェースルーチンの概要

RPC が提供するサービスには、さまざまなレベルのアプリケーションインタフェースがあります。レベルごとに制御の度合いが異なるため、インタフェースのコーディング量との兼ね合いで適当なレベルを使用してください。この節では、制御の度合いとプログラムの複雑さの順に、各レベルで利用できるルーチンについて要約します。

単純インタフェースのルーチン

単純インタフェースは、使用するトランスポートタイプだけを指定して、他のマシン上のルーチンを遠隔手続き呼び出しにより実行します。ほとんどのアプリケーションで、このレベルのルーチンを使用します。この説明とコード例は、「単純インタフェース」を参照してください。

表 2-1 RPC ルーチン - 単純レベル


ルーチン	説明
`rpc_reg()`	手続きを RPC プログラムとして、指定したタイプのトランスポートすべてに登録する
`rpc_call()`	指定した遠隔ホスト上の指定した手続きを遠隔呼び出しする
`rpc_broadcast()`	指定したタイプのトランスポートすべてに呼び出しメッセージをブロードキャストする

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

標準インタフェースはトップレベル、中間レベル、エキスパートレベル、ボトムレベルの 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()`	要求をサーバーに送信するための手続きをクライアント側から呼び出す