最简单的RPC程序hello word的实现

一、概述
本文主要是在linux下面编写一个简单的RPC的程序。在linux下面编写RPC程序的最简单的办法就是使用rpcgen工具，它通过一个规格说明文件rpcsth.x(这个文件爱你可以自由命名，但是必须要以.x结尾)。然后通过rpcgen rpcsth.x命令来生成rpcsth.h、rpcsth_xdr.c、rpcsth_clnt.c和rpcsth_svc.c四个文件。
二、Hello word程序
1）首先编写test.x文件，代码如下：

program RTEST
{
    version RDICTVER
    {
        int TESTVOID(void) = 1;
        int TESTSTRING(string) = 2;
    } = 1;
} = 0x12345;

在这里，函数的说明基本和下面的说明是一致的，只是char *变成了string。另外要给每个定义的函数赋一个值。
2）生成源文件
   在linux下面输入rpcgen test.x命令，然后你就会发现生成了桑文件：test.h 、test_clnt.c  和test_svc.c。由于没有在test.x中定义结构体，所以没有生成test_xdr.c文件。
打开test.h会发现如下几行函数：

define TESTVOID 1
extern int * testvoid_1(void *, CLIENT *);
extern int * testvoid_1_svc(void *, struct svc_req *);
#define TESTSTRING 2
extern int * teststring_1(char **, CLIENT *);
extern int * teststring_1_svc(char **, struct svc_req *);

在test.x中定义的函数被转换成了小写，并加上了版本号1.其中teststring_1对应的是client端的stub通信例程，即test_clnt.c。而teststring_1_svc.c对应的是server端的stub接口例程，需要我们自己来完成。
3）编写客户端常规函数和主函数（testclient.c）
testclient.c的代码如下；

#include "test.h"
#define RMACHINE "127.0.0.1"//表示的是服务器端的ip地址，在这里主要是声明的是本地的

CLIENT *handle;

int testvoid();
int teststring(char * szTest);

int main(int argc,char *argv)
{
    char szTest[100];
    strcpy(szTest,"hello world!");
    handle = clnt_create(RMACHINE,RTEST,RDICTVER,"tcp");

    if(handle == 0){
      printf("error to create the handle!\n");
      return 1;
    }
    testvoid();
    teststring(szTest);
    return 0;
}

int teststring(char *szTest)
{
   char ** pszArg;
   int *ret;
   pszArg = &szTest;
   ret = teststring_1(pszArg,handle);

   return (ret ==0?0:*ret);
}

int testvoid(void)
{
    int *ret;
    ret = testvoid_1(0,handle);
    return(ret ==0?0:*ret);
}

4）编写server端的stub接口例程（test_srvint.c函数）
test_srvint.c函数的代码如下：

#include "test.h"
static int ret;

int *testvoid_1_svc(void *v,struct svc_req *s)
{
    ret = testvoid();
    return &ret;
}

int *teststring_1_svc(char **pszstring,struct svc_req *s)
{
   ret = teststring(*pszstring);
   return &ret;
}

5）编写server端常规函数（testserver.c函数）
testserver.c函数的代码如下：

#include "test.h"

int testvoid(void)
{
   printf("void !\n");
   return 0;
}

int teststring(char *szTest)
{
    printf("Tthe test string is :%s\n",szTest);
    return 0;
}

6）Makefile文件如下（自己写的makefile很戳的）

TAR = testclient testserver

all:$(TAR)

testclient:testclient.o test_clnt.o
    cc -O3 -o testclient testclient.o test_clnt.o
testclient.o:testclient.c
    cc -O3 -o testclient.o -c testclient.c
test_clnt.o:test_clnt.c
    cc -O3 -o test_clnt.o -c test_clnt.c

testserver:testserver.o test_srvint.o test_svc.o
    cc -O3 $^ -o $@
test_svc.o:test_svc.c
    cc -O3 -o test_svc.o -c test_svc.c
test_srvint.o:test_srvint.c
     cc -O3 -o test_srvint.o -c test_srvint.c
test_server.o:test_server.c
    cc -O3 -o test_server.o -c test_server.c

.PHONY:clean
clean:
    rm *.o $(TAR)

三、运行程序
直接运行testserver和testclient即可。
可能遇到的问题如下：
（1）运行testserver的时候出现：Cannot register service: RPC: Unable to receive; errno = Connection refused。出现这个错误的原因是因为服务器端没有开启端口映射的功能。开启portmap就可以了：
sudo /etc/init.d/portmap restart
当然，如果没有安装portmap，那么需要安装portmap直接执行下面的命令即可：
sudo apt-get install portmap
2）程序运行的时候需要在root权限的情况下运行。
如果一切顺利的话就可以在服务器端看到我么熟悉的hello word输出了。