getrpcent man page on HP-UX

Printed from

getrpcent(3C)							 getrpcent(3C)

       getrpcent(), 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‐
       eter 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, 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
       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.

       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.

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


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net