GETRPCENT - Linux手册页

时间:2019-08-20 18:00:10  来源:igfitidea点击:

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)。

InterfaceAttributeValue
getrpcent(),getrpcbyname(),
getrpcbynumber()
Thread safetyMT-Unsafe
setrpcent(),endrpcent()Thread safetyMT-Safe locale

遵循规范

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

BUGS

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

另外参见

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

出版信息

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