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

The following example shows how xdr_free() is used.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#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

[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]