Name

rpc_unregister − unregister an interface (server only)

Syntax

#include <idl/c/rpc.h>
 void rpc_$unregister(ifspec, status)
rpc_$if_spec_t *ifspec;
status_$t *status;

Arguments

ifspec An rpc_$if_spec_t.  An interface specifier obtained from a previous RPC register call.  The interface being unregistered. 

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

Description

The rpc_$unregister routine unregisters an interface that the server previously registered with the RPC runtime library. After an interface is unregistered, the RPC runtime library will not pass requests for that interface to the server.

If a server uses several rpc_$register or rpc_$register_mgr routines to register an interface more than once, then it must call rpc_$unregister an equal number of times to unregister the interface.

Examples

The following statement unregisters a matrix arithmetic interface:

rpc_$unregister (&matrix_$if_spec, &status);

Diagnostics

This section lists status codes for errors returned by this rpc_$ routine in status.all.

rpc_$op_rng_error
The requested operation does not correspond to a valid operation in the requested interface.

rpc_$unk_if The requested interface is not known.  It is not registered in the server, the version number of the registered interface is different from the version number specified in the request, or the UUID in the request does not match the UUID of the registered interface. 

rpc_$not_in_call An internal error. 

rpc_$proto_error An internal protocol error. 

Files

/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl

See Also

intro(3ncs), rpc_register(3ncs), rpc_register_mgr(3ncs), rpc_register_object(3ncs)