getrpcent(NS)

getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent -- get RPC entry

Syntax

cc ... -lsocket

#include <rpc/netdb.h>

struct rpcent *getrpcent()

struct rpcent *getrpcbyname(name)
char *name;

struct rpcent *getrpcbynumber(number)
int number;

setrpcent(stayopen)
int stayopen

endrpcent()

Description

These functions get RPC entries.

getrpcent, getrpcbyname, and getrpcbynumber all return pointers to an object with the following structure, which contains 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 */
       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 null-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.

setrpcent opens and rewinds the file. If the stayopen flag is non-zero, the database 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 EOF is encountered.

NOTE: All routines in librpc and libyp have been incorporated into libsocket. libyp and libsocket have been retained so that existing Makefiles will continue to work. New code should be linked with libsocket.

Diagnostics

Each function returns a NULL pointer if it encounters EOF or error.

Limitations

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

Files