[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


clnt_call Macro

Purpose

Calls the remote procedure associated with the clnt parameter.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>


enum clnt_stat clnt_call (clnt, procnuminprocinoutprocouttout)
CLIENT * clnt;
u_long  procnum;
xdrproc_t  inproc;
char * in;
xdrproc_t  outproc;
char * out;
struct timeval  tout;

Description

The clnt_call macro calls the remote procedure associated with the client handle pointed to by the clnt parameter.

Parameters


clnt Points to the structure of the client handle that results from a Remote Procedure Call (RPC) client creation subroutine, such as the clntudp_create subroutine that opens a User Datagram Protocol/Internet Protocol (UDP/IP) socket.
procnum Identifies the remote procedure on the host machine.
inproc Specifies the procedure that encodes the procedure's parameters.
in Specifies the address of the procedure's arguments.
outproc Specifies the procedure that decodes the procedure's results.
out Specifies the address where results are placed.
tout Sets the time allowed for results to return.

Implementation Specifics

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

Related Information

The callrpc subroutine, clnt_perror subroutine, clnttcp_create subroutine, clntudp_create subroutine.

List of RPC Programming References.

Remote Procedure Call (RPC) Overview for Programming and Sockets Overview in AIX 5L Version 5.1 Communications Programming Concepts.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]