clnt_create(3)                      CLIX                      clnt_create(3)



  NAME

    clnt_create - Library function for remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    CLIENT * clnt_create(
      char *host ,
      ulong prog ,
      ulong vers ,
      char *proto );

  PARAMETERS

    host    Points to the name of the remote host in which the server is
            located.

    prog    Specifies the server program number to contact.

    vers    Specifies the server's version number.

    proto   Specifies the address of the transport protocol.

  DESCRIPTION

    The clnt_create() function allows C programs to make procedure calls on
    other machines across the network.  First, the client calls a procedure to
    send a data packet to the server.  Upon receipt of the packet, the server
    calls a dispatch routine to perform the requested service, and then sends
    back a reply.  Finally, the procedure call returns to the client.

    The clnt_create() function is a generic client creation routine.  The host
    parameter identifies the name of the remote host in which the server is
    located.  The proto parameter indicates which kind of transport protocol
    to use.  The currently supported values for this field are udp and tcp.
    Default timeouts are set, but can be modified using clnt_control().

  CAUTIONS

    Using UDP has its shortcomings.  Since UDP-based RPC messages can only
    hold up to 8 kilobytes of encoded data, this transport cannot be used for
    procedures that take large arguments or return huge results.

  RETURN VALUES

    If this function is successful, it returns a valid client handle.  If no
    connection can be established, it returns NULL.



  2/94 - Intergraph Corporation                                              1

  clnt_create(3)                      CLIX                      clnt_create(3)



  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),
    xdrrec_create(3), xdr_array(3), xdr_destroy(3), xdr_free(3),
    xdr_inline(3), xdrmem_create(3), xdr_opaque(3), xdr_union(3),
    xdr_vector(3), xdr_void(3)

    CLIX Programming Guide














































  2                                              Intergraph Corporation - 2/94