ultrix man page for rpc_dup_handle

rpc_dup_handle(3ncs)													      rpc_dup_handle(3ncs)

Name
       rpc_dup_handle - make a copy of an RPC handle (client only)

Syntax
       #include <idl/c/rpc.h>

       handle_t rpc_$dup_handle(handle, status)
       handle_t handle;
       status_$t *status;

Arguments
       handle The RPC handle to be copied.

       status The completion status.  If the completion status returned in is equal to status_$ok , then the routine that supplied it was success-
	      ful.

Description
       The routine returns a copy of an existing RPC handle.  Both handles can then be used in the client program for concurrent multiple accesses
       to  a binding.  Because all duplicates of a handle reference the same data, an or routine made on any one duplicate affects all duplicates.
       However, an RPC handle is not freed until is called on all copies of the handle.

Files
See Also
       intro(3ncs), rpc_alloc_handle(3ncs), rpc_free_handle(3ncs)

															      rpc_dup_handle(3ncs)