getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

#include <netdb.h>

struct rpcent *getrpcent()

struct rpcent *getrpcbyname(name) char *name;

struct rpcent *getrpcbynumber(number) int number;

setrpcent(stayopen) int stayopen;

endrpcent()

R getrpcent (), R getrpcbyname (), and R getrpcbynumber () each return a pointer to an object with the following structure containing the broken-out fields of a line in the rpc program number data base, R /etc/rpc .

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

The members of this structure are:

r_name

r_aliases

r_number

R getrpcent () reads the next line of the file, opening the file if necessary.

R setrpcent () opens and rewinds the file. If the stayopen flag is non-zero, the net data base will not be closed after each call to R getrpcent () (either directly, or indirectly through one of the other getrpc calls).

R endrpcent () closes the file.

R getrpcbyname () and R getrpcbynumber () sequentially search from the beginning of the file until a matching rpc program name or program number is found, or until end-of-file is encountered.

A NULL pointer is returned on EOF or error.

/etc/rpc

Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems.

All information is contained in a static area so it must be copied if it is to be saved.

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