getrpcent(3C)getrpcent(3C)NAMEgetrpcent(), getrpcbyname(), getrpcbynumber(), setrpcent(), endrpcent()
- get RPC entry
[ flag ]... file ... [ library ]...
These functions are used to obtain entries for RPC (Remote Procedure
Call) services. An entry may come from any of the sources for speci‐
fied in the file (see nsswitch.conf(4)).
searches for an entry with the RPC service name specified by the param‐
searches for an entry with the RPC program number number.
The functions and are used to enumerate RPC entries from the database.
sets (or resets) the enumeration to the beginning of the set of RPC
entries. This function should be called before the first call to Calls
to and leave the enumeration position in an indeterminate state. If
the stayopen flag is non-zero, the system may keep allocated resources
such as open file descriptors until a subsequent call to
Successive calls to return either successive entries or NULL, indicat‐
ing the end of the enumeration.
may be called to indicate that the caller expects to do no further RPC
entry retrieval operations; the system may then deallocate resources it
was using. It is still allowed, but possibly less efficient, for the
process to call more RPC entry retrieval functions after calling
Thread Safe: Yes
Cancel Safe: Yes
Fork Safe: No
Async-cancel Safe: No
Async-signal Safe: No
These functions can be called safely in a multithreaded environment.
They may be cancellation points in that they call functions that are
In a multithreaded environment, these functions are not safe to be
called by a child process after and before These functions should not
be called by a multithreaded application that supports asynchronous
cancellation or asynchronous signals.
and use thread specific storage that is re-used in each call. The
return value, should be unique for each thread and should be saved, if
desired, before the thread makes the next call.
For enumeration in multithreaded applications, the position within the
enumeration is a process-wide property shared by all threads. may be
used in a multithreaded application but resets the enumeration position
for all threads. If multiple threads interleave calls to the threads
will enumerate disjoint subsets of the RPC entry database.
RPC entries are represented by the structure defined in
The functions and each return a pointer to a if they successfully
locate the requested entry; otherwise they return NULL.
The function returns a pointer to a if it successfully enumerates an
entry; otherwise it returns NULL, indicating the end of the enumera‐
Programs that use the interfaces described in this manual page cannot
be linked statically since the implementations of these functions
employ dynamic loading and linking of shared objects at run time.
was developed by Sun Microsystems, Inc.
FILESSEE ALSOrpcinfo(1M), rpc(4), nsswitch.conf(4).