Changes or retrieves various information about a client object.
#include <rpc/rpc.h>
bool_t clnt_control (cI, req, info) CLIENT *cl; int req; char *info;
The clnt_control macro is used to change or retrieve various information about a client object.
User Datagram Protocol (UDP) and Transmission Control Protocol (TCP) have the following supported values for the req parameter's argument types and functions:
Values for the req Parameter | Argument Type | Function | |
CLSET_TIMEOUT | struct timeval | Sets total time out. | |
CLGET_TIMEOUT | struct timeval | Gets total time out. | |
CLGET_SERVER_ADDR | struct sockaddr | Gets server's address. |
The following operations are valid for UDP only:
Values for the req Parameter | Argument Type | Function | |
CLSET_RETRY_TIMEOUT | struct timeval | Sets the retry time out. | |
CLGET_RETRY_TIMEOUT | struct timeval | Gets the retry time out. |
Notes:
- If the time out is set using the clnt_control subroutine, the time-out parameter passed to the clnt_call subroutine will be ignored in all future calls.
- The retry time out is the time that User Datagram Protocol/Remote Procedure Call (UDP/RPC) waits for the server to reply before retransmitting the request.
cl | Points to the structure of the client handle. |
req | Indicates the type of operation. |
info | Points to the information for request type. |
Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.
This macro is part of Base Operating System (BOS) Runtime.
The clnttcp_create subroutine, clntudp_create subroutine.
The clnt_call macro.
List of RPC Programming References.
TCP/IP Protocols in AIX Version 4.3 System Management Guide: Communications and Networks.
Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.