getrpcent(3RPC)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | DIAGNOSTICS | BUGS | RESTRICTIONS | ATTRIBUTES

NAME

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

SYNOPSIS

$(OS_DIR)/lib/librpc.a
#include <netdb.h>

struct rpcent * getrpcent(void);
struct rpcent * getrpcbyname(char * name);
struct rpcent * getrpcbynumber(int number);
setrpcent(int stayopen);
endrpcent(void);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

POSIX_SOCKETS

DESCRIPTION

The getrpcent() , getrpcbyname() , and getrpcbynumber() functions each return a pointer to an object containing the broken-out fields of a line in the RPC program number database, /etc/rpc . The object has the following structure:

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

The getrpcent() function reads the next line of the file, opening the file if necessary.

The getrpcent() function opens and rewinds the file. If the stayopen flag is non-zero, the net database will not be closed after each call to getrpcent() (called either directly, or indirectly through one of the other "getrpc*" calls).

The endrpcent() function closes the file.

The getrpcbyname() and getrpcbynumber() functions search sequentially from the beginning of the file until a matching rpc program name or program number is found, or until end-of-file is encountered.

DIAGNOSTICS

A NULL pointer is returned on EOF or error.

BUGS

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

RESTRICTIONS

These library calls do not support multi-threaded applications.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-Level	Unsafe

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | DIAGNOSTICS | BUGS | RESTRICTIONS | ATTRIBUTES