rpcgen(1) manページ

オプションは以下の通りです:

-a
	サンプルファイルを含め、全てのファイルを生成します。
-b
	従来互換モード。以前のバージョンの OS のために、トランスポート固有の RPC コードを生成します。
-c
	XDR ルーチンをコンパイル出力します。
-C
	ANSI C コンパイラで使用できるヘッダおよびスタブファイルを生成します。このオプションで生成したヘッダファイルは C++ プログラムでも使用できます。
-D name -D name=value
	シンボル name を定義します。ソース中の #define 指示行と等価です。 value が指定されない場合、 value は 1 と定義されます。このオプションは複数回の指定が可能です。
-h
	C のデータ定義 (ヘッダファイル) をコンパイル出力します。同時に -T オプションを指定することで、 RPC ディスパッチテーブルをサポートするヘッダファイルを生成できます。
-i size
	インラインコードを生成し始めるサイズを指定します。最適化を行う際に用いられます。デフォルト値は 5 です。注: FreeBSD プラットホームでの以前の rpcgen と互換性を保つため、デフォルト値は実際には 0 (つまり、デフォルトではインラインコードは生成しない) となっています。このデフォルト値を上書きするには明示的に 0 以外の値を指定しなければなりません。
-I
	サーバ側スタブにおける inetd(8) サポートコードを生成します。このようにして生成したサーバは、単独で起動することも、 inetd(8) から起動することもできます。単独で起動した場合、デフォルトでは自らバックグラウンド動作に移ります。特殊シンボル RPC_SVC_FG を定義するか、単に -I オプションなしでコンパイルすると、サーバプロセスはフォアグラウンドで動作します。クライアントからの未処理リクエストがなければ、 inetd(8) サーバは 120 秒 (デフォルト値) 経過の後、終了します。このデフォルト値は -K オプションにより変更できます。 inetd(8) サーバの全エラーメッセージは常に syslog(3) によってログに残されます。注: ポートモニタと inetd(8) から起動可能なサーバを作成するには、他のシステムとは異なり、 FreeBSD では本オプションが必要です。
-K seconds
	デフォルトでは、 rpcgen を用いて作成され、ポートモニタから起動されたサービスは、リクエストを処理した後 120 秒待って終了します。この時間は -K オプションを用いて変更できます。リクエスト処理が済むと直ちに終了するようなサーバを生成するには、 -K file ... と指定します。また、決して終了しないサーバを生成するには、 -K -1 として下さい。サーバをモニタする場合、あるサービスリクエストに対して常に新しいプロセスを生成するようなポートモニタがあります。そのようなモニタを用いてサーバを使用することがわかっている場合は、サーバは処理完了後直ちに終了すべきです。そのようなサーバを生成するには、 rpcgen は -K file ... オプションとともに使用すべきです。
-l
	クライアント側スタブをコンパイル出力します。
-L
	サーバがフォアグラウンドで起動された場合、サーバのエラーを記録するのに、標準エラー出力に出力する代わりに syslog(3) を使用します。
-m
	サーバ側スタブをコンパイル出力しますが、 "main" ルーチンは生成しません。コールバックルーチンのみを作成したり、初期化を行うために独自の "main" ルーチンを必要とする場合に便利です。
-M
	rpcgen が生成したコードとユーザが書いたコードの間で引数や結果を受渡しするために、マルチスレッド対応の (MT-safe な) スタブを生成します。ユーザプログラム中でスレッドを使用する場合に有用です。しかし関数 rpc_svc_calls(3) [英語] はまだ MT-safe にはなっていません。つまり rpcgen が生成したサーバ側コードは MT-safe ではありません。
-N
	手続きが複数の引数を持てるようにします。これはまた、C 言語に大変似たパラメータ渡し方法を用います。ですから遠隔手続きにある引数を渡す場合、その引数へのポインタを渡す必要はなく、引数そのものを渡せます。この動作は rpcgen が生成したコードの以前の振る舞いとは異なっています。以前との互換性を保つため、このオプションはデフォルトでは有効ではありません。
-n netid
	netid で指定したトランスポート用のサーバ側スタブをコンパイル出力します。 netconfig データベースには netid 用エントリが存在しなければなりません。このオプションを複数回指定することで、複数のトランスポートに対してサービスするサーバを作成することができます。
-o outfile
	出力ファイル名を指定します。何も指定されなければ標準出力が用いられます ( -c, -h, -l, -m, -n, -s, -amp;Sc, -amp;Sm, -amp;Ss, -t モード時のみ)。
-P
	サーバ側のスタブにポートモニタサポートを組み込みます。注: モニタ可能なサーバを作成するには、他のシステムとは異なり、 FreeBSD では本オプションが必要です。 -I オプションが指定された場合、 -P は自動的にオフになります。
-s nettype
	クラス nettype に属する全てのトランスポート用のサーバ側スタブをコンパイル出力します。サポートされているクラスは以下の通りです: netpath, visible, circuit_n, circuit_v, datagram_n, datagram_v, tcp, udp (これらのクラスの意味については rpc(3) を参照して下さい) このオプションは複数回指定できます。注: トランスポートはコンパイル時ではなく実行時に選択されます。
-amp;Sc
	遠隔手続き呼び出しを用いるサンプルクライアントコードを生成します。
-amp;Sm
	アプリケーションをコンパイルする際に用いるサンプル `Makefile` を生成します。
-amp;Ss
	遠隔手続き呼び出しを用いるサンプルサーバコードを生成します。
-t
	RPC ディスパッチテーブルをコンパイル出力します。
-T
	RPC ディスパッチテーブルをサポートするコードを生成します。ある特定のタイプのファイルを生成するために、以下のオプション -c, -h, -l, -m, -s, -amp;Sc, -amp;Sm, -amp;Ss, -t は排他的に使用されます。他方、オプション -D と -T は大域的であり、他のオプションと組み合わせて使用できます。
-Y pathname
	rpcgen が C プリプロセッサを探し始めるディレクトリ名を指定します。

RPC_HDR
	ヘッダをコンパイルする際に定義されます
RPC_XDR
	XDR ルーチンをコンパイルする際に定義されます
RPC_SVC
	サーバ側スタブをコンパイルする際に定義されます
RPC_CLNT
	クライアント側スタブをコンパイルする際に定義されます
RPC_TBL
	RPC ディスパッチテーブルをコンパイルする際に定義されます

“	On two occasions I have been asked [by members of Parliament], 'Pray, Mr. Babbage, if you put into the machine wrong figures, will the right answers come out?' I am not able rightly to apprehend the kind of confusion of ideas that could provoke such a question.	”
— Charles Babbage

manページ — RPCGEN

名称

内容

書式

解説

オプション

使用例

関連項目