DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

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

/etc/rpc

See also

rpc(NF), rpcinfo(NADM)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003