clnt_tli_create()--Create a Client Handle

 #include <rpc/rpc.h>
 #include <netconfig.h>

 CLIENT *clnt_tli_create(const int fildes,
                         const struct netconfig
                            *netconf,
                         const struct netbuf *svcaddr,
                         const u_long prognum,
                         const u_long versnum,
                         const u_int sendsz,
                         const u_int recvsz);

The clnt_tli_create() API creates an RPC client handle for the remote program prognum and version versnum. The remote program is located at address svcaddr. The client uses the transport that is specified by netconf. Depending upon the type of the transport (connection-oriented or connectionless), clnt_tli_create() calls the appropriate client-creation functions.

Parameters

fildes  (Input) 

A file descriptor. The only permitted value is RPC_ANYFD. The API opens an internal file descriptor which is not accessible by the user applications.

netconf  (Input) 

The transport protocol.

svcaddr  (Input) 

A pointer to the address where the remote program is located.

prognum  (Input) 

The program number of the remote program.

vernum  (Input) 

The version number of the remote program.

sendsz  (Input) 

The size of the send buffer. When a value of zero is specified, a suitable default will be chosen by the system.

recvsz  (Input) 

The size of the receive buffer. When a value of zero is specified, a suitable default will be chosen by the system.

Authorities

No authorization is required.

Return Value

Error Conditions

Upon failure, clnt_tli_create() sets the global structure rpc_createerr. The rpc_createerr.cf_stat variable contains a status value that indicates the error reason. The rpc_createerr.cf_error.re_errno variable is meaningful when some status values are set.

The rpc_createerr.cf_stat variable can be set to one of the following values:

Error Messages

Related Information

• clnt_create()--Create a Generic Client Handle
• clnt_tp_create()--Create a Client Handle

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how clnt_tli_create() is used:

/* Define remote program number and version */
#define RMTPROGNUM ((u_long)0x3fffffff)
#define RMTPROGVER ((u_long)0x1)

#include <stdio.h>
#include <rpc/rpc.h>
#include <netconfig.h>
#include <netdir.h>

main()
{
  CLIENT *client;
  struct netconfig *nconf;
  struct netbuf *service_address;
  struct nd_addrlist *nas;
  struct nd_hostserv hs;

  /* Returns a pointer to nconf corresponding to NETCONF */
  if ((nconf = getnetconfigent("UDP")) ==
               (struct netconfig *)NULL) {
    fprintf(stderr, "Cannot get netconfig entry for UDP\n");
    exit(1);
  }

  hs.h_host = "as400.somewhere.ibm.com";
  hs.h_serv = "RPCBIN";
  if(netdir_getbyname(nconf,&hs,&nas) < 0
  || nas->n_cnt == 0) {
     fprintf(stderr, "Cannot translate host name or service name\n");
  service_address = nas->n_addrs;

  client = clnt_tli_create(RPC_ANYFD, nconf, service_address,
                       RMTPROGNUM, RMTPROGVER, 0, 0);
  if (client == (CLIENT *)NULL) {
    fprintf(stderr, "Cannot create an RPC client\n");
    exit(1);
  }

  fprintf(stderr, "Successfully created a client handle\n"); 

  clnt_destroy(client);
}