clnt_destroy(3)                     CLIX                     clnt_destroy(3)



  NAME

    clnt_destroy - Library function for remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    clnt_destroy(
      CLIENT *clnt );

  PARAMETERS

    clnt   Specifies the address of the client handle.

  DESCRIPTION

    The clnt_destroy() 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_destroy() function is a macro that destroys the client's RPC
    handle.  Destruction usually involves deallocation of private data
    structures, including clnt itself.  Use of clnt is undefined after calling
    clnt_destroy().  If the RPC library opened the associated socket, it will
    close it also.  Otherwise, the socket remains open.

  RETURN VALUES

    This function returns void.

  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/94 - Intergraph Corporation                                              1