struct
rpcent
*
getrpcent(
void
)
struct
rpcent
*
getrpcbyname(
const char *name
)
struct
rpcent
*
getrpcbynumber(
int number
)
void
setrpcent(
int stayopen
)
void
endrpcent(
void
)
),
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:
getrpcent()
reads the next line of the file, opening the file if necessary.
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
getrpcent()
(either directly, or indirectly through one of
the other
``getrpc''
calls).
endrpcent()
closes the file.
getrpcbyname()
and
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.
/etc/rpc
NULL
pointer is returned on
EOF
or error.