clnt_call(3)                        CLIX                        clnt_call(3)



  NAME

    clnt_call - Library function for remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    enum clnt_stat clnt_call(
      CLIENT *clnt ,
      ulong procnum ,
      xdrproc_t inproc ,
      char *in ,
      xdrproc_t outproc ,
      char *out ,
      struct timeval tout );

  PARAMETERS

    clnt      Specifies the address of the client handle.

    procnum   Specifies the procedure to call.

    inproc    Specifies the XDR filter used to encode the procedure's
              arguments.

    in        Specifies the address of the buffer holding the procedure's
              arguments.

    outproc   Specifies the XDR filter used to decode the procedure's results.

    out       Specifies the address of the buffer in which the procedure's
              results are stored.

    tout      Specifies the amount of time allowed for receiving replies.

  DESCRIPTION

    The clnt_call() 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_call() function is a macro that calls the remote procedure
    procnum associated with the client handle, clnt, which is obtained with an
    RPC client creation routine such as clnt_create().

  RETURN VALUES



  2/94 - Intergraph Corporation                                              1

  clnt_call(3)                        CLIX                        clnt_call(3)



    This function returns a clnt_stat enumerated status, suitable for
    interpretation using clnt_perrno().

  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