rpcgen的简单讲解及例子程序

rpcgen是一个远程过程调用（RPC）协议编译器，它可以生成客户端和服务器端程序代码，用于实现跨网络的程序通信。下面是一个简单的rpcgen例子程序：

/* message.x - RPC协议文件 */

struct message {
    int id;
    string text<200>;
};

program MESSAGEPROG {
    version MESSAGEVERS {
        message MESSAGEPROC(int) = 1;
    } = 1;
} = 0x31230000; /* 用于标识RPC协议的唯一值 */

上面的代码定义了一个名为MESSAGEPROG的RPC程序，包含一个版本MESSAGEVERS，其中有一个名为MESSAGEPROC的过程。过程接受一个整数作为参数，并返回一个消息结构体。现在我们使用rpcgen来编译这个协议文件，生成客户端和服务器端的代码：

rpcgen message.x

这将生成四个文件：message.h、message_clnt.c、message_svc.c、message_xdr.c。其中，message.h包含了协议的数据类型定义和函数声明，message_clnt.c是客户端程序的代码，message_svc.c是服务器端程序的代码，message_xdr.c是帮助程序将数据转换为网络字节序的代码。

下面是一个简单的服务器端程序代码示例：

#include "message.h"
#include <stdio.h>
#include <stdlib.h>

message * messageproc_1_svc(int *id, struct svc_req *rqstp)
{
    static message result;
    result.id = *id;
    sprintf(result.text, "Hello, client %d!", *id);
    return &result;
}

int main(int argc, char **argv)
{
    register SVCXPRT *transp;

    /* 创建TCP连接 */
    transp = svc_tcp_create(RPC_ANYSOCK, 0, 0);
    if (transp == NULL) {
        fprintf(stderr, "cannot create TCP service.\n");
        exit(1);
    }

    /* 注册服务程序 */
    if (!svc_register(transp, MESSAGEPROG, MESSAGEVERS, messageprog_1, IPPROTO_TCP)) {
        fprintf(stderr, "unable to register (MESSAGEPROG, MESSAGEVERS, tcp).\n");
        exit(1);
    }

    /* 运行RPC服务 */
    svc_run();
    fprintf(stderr, "unable to run RPC service.\n");
    exit(1);
}

上面的代码实现了MESSAGEPROC过程的服务端代码，该过程接受一个整数作为参数，返回一个包含问候信息的message结构体。函数注册和运行部分使用了rpc库提供的函数。

下面是一个简单的客户端程序代码示例：

#include "message.h"
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char **argv)
{
    CLIENT *cl;
    message *result;
    int *id;

    /* 创建RPC客户端 */
    cl = clnt_create(argv[1], MESSAGEPROG, MESSAGEVERS, "tcp");
    if (cl == NULL) {
        fprintf(stderr, "cannot create RPC client.\n");
        exit(1);
    }

    /* 发送RPC请求 */
    id = (int *) malloc(sizeof(int));
    *id = atoi(argv[2]);
    result = messageproc_1(id, cl);
    if (result == NULL) {
        fprintf(stderr, "RPC error: %s\n", clnt_sperror(cl, argv[1]));
        exit(1);
    }

    /* 处理RPC响应 */
    printf("%s\n", result->text);

    /* 释放资源 */
    clnt_destroy(cl);
    free(id);
    exit(0);
}

上面的代码实现了MESSAGEPROC过程的客户端代码，该过程接受一个整数作为参数，发送RPC请求到服务器端，接收并输出服务器端返回的问候信息。需要注意的是，程序需要接受命令行参数，分别为服务器端的IP地址和一个整数作为ID参数。