xdr_free()--Generic Freeing Function


  Syntax
 #include <rpc/rpc.h>

 void xdr_free(xdrproc_t proc,
                       char *objp);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The xdr_free() function recursively frees the object pointed to by the pointer passed in.


Parameters

proc  (Input) 
XDR routine for the object being freed.

objp  (Input) 
A pointer to the object to be freed.

Authorities

No authorization is required.


Return Value

None.


Error Conditions

In case of an exception, the errno global variable is set to EUNKNOWN.


Error Messages

Message ID Error Message Text
CPF3CF2 E Error(s) occurred during running of &1 API.


Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how xdr_free() is used:

#include <rpc/rpc.h>

main()
{
  CLIENT *cl;
  char *outparam;
  int inparam;
  ...
  cl = clnt_create(...);
  ...
  outparam = NULL;
  clnt_call(cl, MYPROC, xdr_int, &inparam,
            xdr_wrapstring, &outparam, timeout);
  ...
  xdr_free(xdr_wrapstring, &outparam);
  ...
}



API introduced: V4R2
Top | Remote Procedure Call (RPC) APIs | APIs by category