GETRPCENT(3) GETRPCENT(3)

NAME getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

SYNOPSIS #include <netdb.h>

struct rpcent *getrpcent()

struct rpcent *getrpcbyname(name) char *name;

struct rpcent *getrpcbynumber(number) int number;

setrpcent (stayopen) int stayopen;

endrpcent ()

DESCRIPTION getrpcent(), getrpcbyname(), and 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, /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 The name of the server for this rpc program. r_aliases A zero terminated list of alternate names for the rpc program. r_number The rpc program number for this service.

getrpcent() reads the next line of the file, opening the file if neces- sary.

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 getrp- cent() (either directly, or indirectly through one of the other getrpc calls).

endrpcent() closes the file.

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

FILES /etc/rpc

CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other sys- tems.

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

DIAGNOSTICS A NULL pointer is returned on EOF or error.

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

1987-12-14 GETRPCENT(3)