getrpcent(3C)															     getrpcent(3C)

NAME

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

SYNOPSIS

       [ flag ]... file ... [ library ]...

DESCRIPTION

       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 parameter name.

       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, indicating 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

MULTITHREAD USAGE

       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
       cancel points.

       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.

RETURN VALUE

       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-
       tion.

WARNINGS

       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.

AUTHOR

       was developed by Sun Microsystems, Inc.

FILES

SEE ALSO

       rpcinfo(1M), rpc(4), nsswitch.conf(4).

																     getrpcent(3C)