NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | DIAGNOSTICS | BUGS | RESTRICTIONS | ATTRIBUTES
$(OS_DIR)/lib/librpc.a #include <netdb.h>struct rpcent * getrpcent(void);
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.
POSIX_SOCKETS
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:
The name of the server for this rpc program
A zero terminated list of alternate names for the rpc program
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.
A
NULL
pointer is returned on
EOF
or error.
All information is contained in a static area, and must be copied if it is to be saved.
These library calls do not support multi-threaded applications.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
MT-Level | Unsafe |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | DIAGNOSTICS | BUGS | RESTRICTIONS | ATTRIBUTES