Linux程序员手册 第3部分
更新日期： 2020-04-11

名称

getrpcent，getrpcbyname，getrpcbynumber，setrpcent，endrpcent-获取RPC条目

语法

#include <netdb.h>

struct rpcent *getrpcent(void);

struct rpcent *getrpcbyname(const char *name);

struct rpcent *getrpcbynumber(int number);

void setrpcent(int stayopen);

void endrpcent(void);

说明

getrpcent()，getrpcbyname()和getrpcbynumber()函数均返回指向对象的指针，该对象具有以下结构，其中包含RPC程序编号数据库中条目的细分字段。

struct rpcent {
    char  *r_name;     /* name of server for this RPC program */
    char **r_aliases;  /* alias list */
    long   r_number;   /* RPC program number */
};

该结构的成员是：

r_name

此RPC程序的服务器名称。

r_aliases

RPC程序的备用名称的NULL终止列表。

r_number

此服务的RPC程序号。

getrpcent()函数从数据库读取下一个条目。如有必要，将打开与数据库的连接。

setrpcent()函数打开与数据库的连接，并将下一个条目设置为第一个条目。如果stayopen为非零，则在调用getrpc *()函数之一之间不会断开与数据库的连接。

endrpcent()函数关闭与数据库的连接。

getrpcbyname()和getrpcbynumber()函数从文件的开头开始顺序搜索，直到找到匹配的RPC程序名称或程序号，或者直到遇到文件结尾。

返回值

成功完成后，getrpcent()，getrpcbyname()和getrpcbynumber()将返回一个指向静态分配的rpcent结构的指针。 EOF或错误时返回NULL。

文件

/etc/rpc

RPC程序编号数据库。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

不在POSIX.1中。存在于BSD，Solaris和许多其他系统上。

BUGS

所有信息都包含在静态区域中，因此如果要保存，必须将其复制。

另外参见

getrpcent_r(3)，rpc(5)，rpcinfo(8)，ypserv(8)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。