User login |
endrpcent (3)
GETRPCENT(3) Linux Programmer's Manual GETRPCENT(3)
NAME
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - 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.
RETURN VALUE
A NULL pointer is returned on EOF or error.
FILES
/etc/rpc
CONFORMING TO
Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other sys-
tems.
BUGS
All information is contained in a static area so it must be copied if
it is to be saved.
SEE ALSO
rpc(5), rpcinfo(8), ypserv(8)
2007-05-18 GETRPCENT(3)
|