rpc_dup_handle(3ncs) [ultrix man page]

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)

rpc_bind(3ncs)															    rpc_bind(3ncs)

Name
       rpc_bind - allocate an RPC handle and set its binding to a server (client only)

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

       handle_t rpc_$bind(object, sockaddr, slength, status)
       uuid_$t *object;
       socket_$addr_t *sockaddr;
       unsigned long slength;
       status_$t *status;

Arguments
       object		   The UUID of the object to be accessed.  If there is no specific object, specify uuid_$nil.

       sockaddr 	   The socket address of the server.

       slength		   The length, in bytes, of sockaddr.

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

Description
       The routine creates a fully bound RPC handle that identifies a particular object and server.  This routine is equivalent to an routine fol-
       lowed by an routine.

Examples
       The  following  statement binds the binop client to the specified object and socket address.  The loc parameter is the result of a previous
       call to which converted the host name and port number to a socket address.
       rh = rpc_$bind (&uuid_$nil, &loc, llen, &status);

Diagnostics
       This section lists status codes for errors returned by this routine in

       rpc_$cant_bind_sock The RPC runtime library created a socket but was unable to bind it to a socket address.

       rpc_$not_in_call    An internal error.

       rpc_$proto_error    An internal protocol error.

Files
See Also
       intro(3ncs), rpc_clear_binding(3ncs), rpc_clear_server_binding(3ncs), rpc_set_binding(3ncs)

																    rpc_bind(3ncs)