rpcgen 简介

rpcgen可以自动生成RPC服务器程序的大多数代码，它的输入为一个规格说明文件，它的输出为一个C语言的源程序。规格文件（*.x）包含常量、全局数据类型以及远程过程的声明。Rpcgen产生的代码包含了实现客户机和服务器程序所需要的大部分源代码。他包括参数整理、发送RPC报文、参数和结果的外部数据表示以及本地数据表示的转换等。不过在由rpcgen生成的源文件中，没有过程的具体实现，所以程序员必须要手工编辑这些文件，实现这些过程。

Rpc自动生成的文件

文件名	作用
Makefile.file	该文件用于编译所有客户机，服务器代码
File_clnt.c	该文件包含client_stub,程序员一般不用修改
File_svc.c	该文件包含server_stub,程序员一般不用修改
File.h	该文件包含了从说明中产生的所有XDR类型
File_xdr.c	该文件包含了客户机和服务器stub所需的XDR过滤器，程序员一般不用修改
File_server.c	如果生成此文件，则该文件包含远程服务的stub
File_client.c	如果生成此文件，则该文件包含了骨架客户机程序。

Rpcgen的部分选项

-a 生成所有源程序，包括客户机和服务器源程序。

-C 使用ANSI C标准生成编码。

-c 生成xdr转码C程序。（file_xdr.c）。

-l 生成客户机stubs。（file_clnt.c）

-m 生成服务器stubs，但是不生成main函数。（file_svc.c）

-s  rpcgen –C –s tcp file.x，生成服务器stubs，用tcp协议，同时生成了main函数。（file_svc.c）

-h 生成头文件。

-Sc 生成骨架客户机程序，（file_client.c），生成后还需要手动添加代码。

-Ss 生成服务器程序，（file_server.c），生成后还需要手动添加代码。

Rpcgen –C  file.x 生成file_xdr.c,file.h,Makefile.file,file_svc.c和file_client.c

Rpcgen –C –a file.x 比上面多生成了2个文件，file_server.c和file_client.c

Rpcgen示例程序

规格文件（math.x）

/* filename: math.x */

const ADD = 0;

const SUB = 1;

const MUL = 2;

const DIV = 3;

struct MATH

{

int op; /* 0-ADD, 1-SUB, 2-MUL, 3-DIV */

float arg1;

float arg2;

float result;

};

program MATH_PROG

{

version MATH_VER

{

struct MATH MATH_PROC(struct MATH) = 1;

} = 2;

} = 0x20000001;

用 rpcgen –C –a math.x 生成7个文件，math.h、math_xdr.c、math_svc.c、math_clnt.c、Makefile.math、math_client.c、math_server.c。

在math_client.c中添加代码，下面是添加后的代码：

/*

* This is sample code generated by rpcgen.

* These are only templates and you can use them

* as a guideline for developing your own functions.

*/

#include "math.h"

void math_prog_2(char *host)

{

CLIENT *clnt;

struct MATH  *result_1;

struct MATH  math_proc_2_arg;

/* 2006/07/04 Dongyy Add -> */

char c;

printf("choose the operation:/n/t0---ADD/n/t1---SUB/n/t2---MUL/n/t3---DIV/n");

c = getchar();

switch(c) {

case '0':

math_proc_2_arg.op = ADD;

break;

case '1':

math_proc_2_arg.op = SUB;

break;

case '2':

math_proc_2_arg.op = MUL;

break;

case '3':

math_proc_2_arg.op = DIV;

break;

default:

printf("error:operate/n");

exit(1);

}

printf("input the first number:");

scanf("%f", &math_proc_2_arg.arg1);

printf("input the second number:");

scanf("%f", &math_proc_2_arg.arg2);

/* <- 2006/07/04 Dongyy Add */

#ifndef   DEBUG

clnt = clnt_create (host, MATH_PROG, MATH_VER, "udp");

if (clnt == NULL) {

clnt_pcreateerror (host);

exit (1);

}

#endif    /* DEBUG */

result_1 = math_proc_2(&math_proc_2_arg, clnt);

if (result_1 == (struct MATH *) NULL) {

clnt_perror (clnt, "call failed");

}

#ifndef   DEBUG

clnt_destroy (clnt);

#endif    /* DEBUG */

/* 2006/07/04 Dongyy Add -> */

printf("The Result is %.3f /n", result_1->result);

/* <- 2006/07/04 Dongyy Add */

}

int main (int argc, char *argv[])

{

char *host;

if (argc < 2) {

printf ("usage: %s server_host/n", argv[0]);

exit (1);

}

host = argv[1];

math_prog_2 (host);

exit (0);

}

在math_server.c中添加代码，下面是添加后的代码：

/*

* This is sample code generated by rpcgen.

* These are only templates and you can use them

* as a guideline for developing your own functions.

*/

#include "math.h"

struct MATH *

math_proc_2_svc(struct MATH *argp, struct svc_req *rqstp)

{

static struct MATH  result;

/*

* insert server code here

*/

/* 2006/07/04 Dongyy Add -> */

switch(argp->op){

case ADD:

result.result = argp->arg1 + argp->arg2;

break;

case SUB:

result.result = argp->arg1 - argp->arg2;

break;

case MUL:

result.result = argp->arg1 * argp->arg2;

break;

case DIV:

result.result = argp->arg1 / argp->arg2;

break;

default:

break;

}

/* <- 2006/07/04 Dongyy Add */

return &result;

}

红色字体部分为用rpcgen生成代码后，手动添加的代码。

添加完后，执行make –f makefile.math 编译生成math_client和math_server，在命令行运行math_server &，然后运行math_client 127.0.0.1，按照提示输入内容就OK了。

参考书籍《Linux C 高级程序员指南》