GETRPCENT(3) BSD Programmer's Manual GETRPCENT(3)NAME
getrpcent, getrpcbyname, getrpcbynumber, endrpcent, setrpcent - get RPC
entry
SYNOPSIS
#include <rpc/rpc.h>
struct rpcent *
getrpcent(void);
struct rpcent *
getrpcbyname(char *name);
struct rpcent *
getrpcbynumber(int number);
void
setrpcent(int stayopen);
void
endrpcent(void);
DESCRIPTIONgetrpcent(), 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 database, /etc/rpc:
struct rpcent {
char *r_name; /* name of server for this rpc program */
char **r_aliases; /* alias list */
int 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 database will not be closed after each call to getrpcent() (ei-
ther 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
DIAGNOSTICS
A NULL pointer is returned on EOF or error.
SEE ALSOrpc(5), rpcinfo(8), ypserv(8)BUGS
All information is contained in a static area so it must be copied if it
is to be saved.
MirOS BSD #10-current December 14, 1987 1