NAME

unexport - Removes binding information, interface identifiers, and object UUIDs from a server entry

SYNOPSIS

rpccp unexport entry-name {[-i if-id [-v versions]] | [-o object-uuid] ...}
[-s syntax]

OPTIONS

-i if-idDefines an interface identifier to be unexported (optional).  Only one interface can be unexported in a single operation.  If specified, binding information for this interface is removed from the entry.  The ­-i option can be qualified by the ­-v option.  The value has the following form:

interface-uuid,major-version.minor-version

The Uinversal Unique Identifier (UUID) is a hexadecimal string and the version numbers are decimal strings, for example:

-i ec1eeb60-5943-11c9-a309-08002b102989,1.1

Leading zeros in version numbers are ignored. 

-v versionsIndicates how a specified interface version is used (optional).  If it is used without the ­-i option, the ­-v option is ignored.  The possible combinations of versions for the ­-v option and their actions as follows:

allThe interface version is ignored. 

exactBoth the major and minor versions must match the specified versions. 

compatibleThe major version must match the specified version, and the minor version must be greater than or equal to the specified version. 

major_only
The major version must match the specified version; the minor version is ignored.

uptoThe major version must be less than or equal to that specified.  If the major versions are equal, the minor version must be less than or equal to that specified. 

If the ­-v option is absent, the command shows compatible version numbers. 

-o object-uuid
Defines an object to be unexported (optional). Each unexport command accepts up to 32 ­-o options.  The UUID is a hexadecimal string, for example:

-o 3c6b8f60-5945-11c9-a236-08002b102989

-s syntaxIndicates the name syntax of the entry name (optional).  The only value for this option is the dce name syntax, which is the default name syntax.  Until an alternative name syntax becomes available, specifying the ­-s option is unnecessary. 

ARGUMENTS

entry-nameIndicates the name of the target name service entry.  Usually, the target is a server entry.  However, objects also can be exported (without an interface identifier or binding information) to a group or a profile. 

For an entry in the local cell, you can omit the cell name and specify only the cell-relative name. 

DESCRIPTION

The unexport command removes binding information and an interface identifier, object UUIDs, or both from a server entry, or it removes object UUIDs from a group’s entry.  The command requires the entry name and either the interface identifier or one or more object UUIDs. 

By default, the unexport operation removes compatible interface versions. 

Privileges Required

You need both r (read) and w (write) permission to the Cell Directory Service (CDS) object entry (the target name service entry). 

NOTES

This command is replaced at DCE Version 1.1 by the dcecp command and may not be provided in future releases of DCE. 

EXAMPLES

This sequence of commands sets up an environment variable Calendar_1_1, which represents the interface identifier of a remote procedure call (RPC) interface, exports it, and removes (unexports) the Calendar Version 1.1 interface from the server entry /.:/LandS/anthro/Cal_host_2 in the local cell:

Calendar_1_1=ec1eeb60-5943-11c9-a309-08002b102989,1.1
export Calendar_1_1
rpccp
rpccp> unexport -i Calendar_1_1 /.:/LandS/anthro/Cal_host_2

RELATED INFORMATION

Commands:

rpccp_export(8rpc), rpccp_import(8rpc), rpccp_show_server(8rpc)