HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)
r
rpc_clnt_create(3N) rpc_clnt_create(3N)
routine returns NULL if it fails.
The address svcaddr should not be
NULL and should point to the actual address of the remote pro-
gram. clnt_vc_create()
does not consult the remote rpcbind service for this information.
struct rpc_createerr rpc_createerr;
A global variable whose value is set by any RPC client handle creation routine that fails. It is used
by the routine clnt_pcreateerror()
to print the reason for the failure.
In multithreaded applications,
rpc_createerr becomes a macro which enables each thread to
have its own
rpc_createerr
.
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
fork()
and before exec(). These functions should not be called by a multithreaded application that support
asynchronous cancellation or asynchronous signals.
SEE ALSO
rpc(3N), rpc_clnt_auth(3N), rpc_clnt_calls(3N), rpcbind(1M).
Section 3−−892 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: August 2003