[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 1
clnt_create Subroutine
Purpose
Creates and returns a generic client handle.
Library
C Library (libc.a)
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.
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.2 System Management Guide: Communications and Networks.
Remote Procedure Call (RPC)
Overview for Programming in AIX 5L Version 5.2 Communications Programming Concepts.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]