HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

r
rpc_clnt_calls(3N) rpc_clnt_calls(3N)
enum clnt_stat rpc_call()
Calls the remote procedure associated with prognum, versnum, and procnum on the machine, host.
The parameter inproc is used to encode the procedure’s parameters, and outproc is used to decode the
procedures results. in is the address of the procedure’s argument(s), and out is the address of where
to place the result(s). nettype can be any of the values listed on rpc(3N). This routine returns
RPC_SUCCESS if it succeeds, or it returns an appropriate status. Use the
clnt_perrno()
rou-
tine to translate failure status into error messages.
The
rpc_call() function uses the first available transport belonging to the class nettype on which
it can create a connection. You do not have control of timeouts or authentication using this routine.
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 supports
asynchronous cancellation or asynchronous signals.
SEE ALSO
printf(3S), rpc(3N), rpc_clnt_auth(3N), rpc_clnt_create(3N).
312 Hewlett-Packard Company 3 HP-UX 11i Version 3: February 2007