svc_destroy()--Destroy an RPC Service Transport Handle

 
 #include <rpc/rpc.h>

 void svc_destroy(SVCXPRT *xprt);

The svc_destroy() function destroys an RPC service transport handle. This function deallocates the private data structures, including the handle itself. After the svc_destroy() API is used, the handle pointed to by the xprt parameter is no longer defined.

Parameters

xprt  (Input) 

A pointer to the RPC service transport handle.

Authorities

No authorization is required.

Return Value

None.

Error Conditions

None.

Error Messages

None.

Related Information

• clnt_destroy()--Destroy the RPC Client's Handle
• svc_create()--Create a Server Handle

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how svc_destroy() is used:

#include <rpc/rpc.h>

main()
{
  SVCXRPT *transp;

  ...

  /* Destroy the service handle */
  svc_destroy(transp);
  ...
}