Technical Reference: Communications, Volume 1

clnt_create Subroutine

Purpose

Creates and returns a generic client handle.

Syntax

#include <rpc/rpc.h>

CLIENT *clnt_create (host, prognum, versnum, protocol) char * host; unsigned prognum, versnum; char * protocol;

Description

Creates and returns a generic client handle.

Remote Procedure Calls (RPC) messages transported by User Datagram Protocol/Internet Protocol (UDP/IP) can hold up to 8KB of encoded data. Use this transport for procedures that take arguments or return results of less than 8KB.

Note: When the clnt_create subroutine is used to create a RPC client handle, the timeout value provided on subsequent calls to clnttcp_call are ignored. Using the clnt_create subroutine has the same effect as using clnttcp_create followed by a call to clnt_control to set the timeout value for the RPC client handle. If the timeout paramater is used on the clnttcp_call interface, use the clnttcp_create interface to create the client handle.

Parameters

host	Identifies the name of the remote host where the server is located.
prognum	Specifies the program number of the remote program.
versnum	Specifies the version number of the remote program.
protocol	Identifies which data transport protocol the program is using, either UDP or Transmission Control Protocol (TCP).

Return Values

Upon successful completion, this subroutine returns a client handle.

Implementation Specifics

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

Related Information

The clnttcp_create subroutine, clntudp_create subroutine.

The clnt_control macro, clnt_destroy macro.

List of RPC Programming References.

TCP/IP Protocols in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

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