[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

clnt_control Macro

Purpose

Changes or retrieves various information about a client object.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>
bool_t clnt_control (cI, req, info)
CLIENT *cl;
int req;
char *info;

Description

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:
  1. 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.
  2. 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.

Parameters

cl Points to the structure of the client handle.
req Indicates the type of operation.
info Points to the information for request type.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

This macro is part of Base Operating System (BOS) Runtime.

Related Information

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.


[ Previous | Next | Contents | Glossary | Home | Search ]