[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Communications Technical Reference, 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 Version 4.3 Communications Programming Concepts.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]