clnt_destroy()--Destroy the RPC Client's Handle

 #include <rpc/rpc.h>

 void clnt_destroy(CLIENT *clnt);

The clnt_destroy() API destroys the RPC client's handle. This function deallocates private data structures, including the clnt parameter itself. The use of the clnt parameter becomes undefined upon calling the clnt_destroy() API. If the RPC library opened the associated file descriptor, or was set using clnt_control(), the associated file descriptor will be closed.

The caller should call auth_destroy (before calling clnt_destroy) to destroy the associated AUTH structure.

Parameters

clnt  (Input) 

A pointer to the client handle structure.

Authorities

No authorization is required.

Return Value

None.

Error Conditions

None.

Error Messages

Related Information

svc_destroy()--Destroy an RPC Service Transport Handle

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how clnt_destroy() is used:

#include <rpc/rpc.h>

main()
{
  CLIENT *clnt;

  /* Create client handle */
  clnt = clnt_create(..);

  ...

  /* Destroy the client handle */
  clnt_destroy(clnt);
  exit(0);
}