GETRPCENT (3)

SYNOPSIS

B
#include <netdb.h>

B
struct rpcent *getrpcent(\|)

B
struct rpcent *getrpcbyname(name)
char *name;

B
struct rpcent *getrpcbynumber(number)
int number;

B
setrpcent (stayopen)
int stayopen

B
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 .

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

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 necessary.

getrpcent(\|) 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 \*(lqgetrpc\*(rq 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.

FILES

/etc/rpc

SEE ALSO

- rpc (5) - rpcinfo(8C) - ypserv (8) -

DIAGNOSTICS

A pointer is returned on or error.

BUGS

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