NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO
#include <rpc/rpc.h>enum clnt_stat clnt_send (CLIENT *clnt , const u_long procnum , const xdrproc_t proc , const caddr_t in);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
The clnt_send() function calls the remote function procnum() associated with the client handle, clnt, which is obtained with an RPC client creation routine such as clnt_create() (see rpc_clnt_create(3RPC)). The parameter proc is the XDR function used to encode the procedure's parameters. The parameter in is the address of the procedure's argument(s).
The clnt_send() function does not check if the program version number supplied to clnt_create() is registered with the rpcbind service. Use clnt_create_vers() instead of clnt_create() to check on incorrect version number registration. clnt_create_vers() will return a valid handle to the client only if a version within the range supplied to clnt_create_vers() is supported by the server.
By default, the blocking I/O mode is used. See the clnt_control(3RPC) man page for more information on I/O modes.
RPC_SUCCESS is returned when a request is successfully sent. This does not mean that the request was received. If an error is returned use the clnt_getterr() routine to find the failure status or the clnt_perrno() routine to translate failure status into error messages.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | MT-Safe |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO