-N フラグを指定して rpcgen を起動すると、C 形式モード (Newstyle モードとも呼ばれる) で処理が行われます。このモードでは、引数は値で渡され、複数の引数も構造体にせずに渡すことができます。この機能を使用して、RPC コードを、C 言語やその他の高級言語に近い形式で書くことができます。既存のプログラムや makefile との互換性を保つため、従来モード (標準モード) がデフォルトになっています。次の例では、-N フラグにより利用できる機能を示します。従来モードと C 形式モードの両方のソースモジュールを、例 3-8と 例 3-9 に示します。
/* * このプログラムには、2 つの数値を加える手続きが入っています。 * ここでは、C 形式モードによる引数の引き渡し方法を示します。 * 関数 add() が 2 つの引数を取ることに注意してください。 */ program ADDPROG { /* プログラム番号 */ version ADDVER { /* バージョン番号 */ int add(int, int) = 1; /* 手続き */ } = 1; } = 0x20000199; |
/* * このプログラムには、2 つの数値を加える手続きが入っています。 * ここでは、デフォルトモードによる引数の引き渡し方法を示します。 * デフォルトモードの場合、rpcgen は引数を 1 つしか処理しないことに * 注意してください。 */ struct add_arg { int first; int second; }; program ADDPROG { /* プログラム番号 */ version ADDVER { /* バージョン番号 */ int add (add_arg) = 1; /* 手続き */ } = 1; } = 0x20000199; |
/* * C 形式のクライアント側メインルーチン。 * 遠隔 RPC サーバー上の関数 add() を呼び出します。 */ #include <stdio.h> #include "add.h" main(argc, argv) int argc; char *argv[]; { CLIENT *clnt; int *result,x,y; if(argc != 4) { printf("usage: %s host num1 num2¥n" argv[0]); exit(1); } /* * クライアントハンドルの作成 - サーバーに結合 */ clnt = clnt_create(argv[1], ADDPROG, ADDVER, "udp"); if (clnt == NULL) { clnt_pcreateerror(argv[1]); exit(1); } x = atoi(argv[2]); y = atoi(argv[3]); /* 遠隔手続きの呼び出し: add_1() には、ポインタではなく、 * 複数の引数が渡されていることに注意してください。 */ result = add_1(x, y, clnt); if (result == (int *) NULL) { clnt_perror(clnt, "call failed:"); exit(1); } else { printf("Success: %d + %d = %d¥n", x, y, *result); } exit(0); } |
例 3-11 に、デフォルトモードと C 形式モードとのコードの相違点を示します。
arg.first = atoi(argv[2]); arg.second = atoi(argv[3]); /* * 遠隔手続きの呼び出し -- クライアント側スタブプログラムには、 * 引数へのポインタを渡さなければならないことに注意してください。 */ result = add_1(&arg, clnt); |
例 3-12 に、C 形式モードのサーバー側手続きを示します。
#include "add.h" int * add_1(arg1, arg2, rqstp) int arg1; int arg2; struct svc_req *rqstp; { static int result; result = arg1 + arg2; return(&result); } |
例 3-13 に、デフォルトモードのサーバー側手続きを示します。
#include "add.h" int * add_1(argp, rqstp) add_arg *argp; struct svc_req *rqstp; { static int result; result = argp->first + argp->second; return(&result); } |