NAME

remove mapping - Removes specified elements from the local endpoint map

SYNOPSIS

rpccp remove mapping -b string-binding ... -i interface-identifier
[-o object-uuid] ... 

OPTIONS

-b string-binding
Specifies a string representation of a binding over which the server can receive remote procedure calls. Each remove mapping command accepts up to 32 ­-b options.  At least one binding is required. 

The value has the form of a remote procedure call (RPC) string binding, without an object UUID, as in the following example:

-b ncadg_ip_udp:63.0.2.17[5347]

Note that, depending on your system, string binding delimiters such as [ ] (brackets) may need to be preceded by a \ (backslash) or placed within ’ ’ or " " (single or double quotation marks).  Requirements vary from system to system, and you must conform to the usage rules of a system. 

-i interface-identifier
Specifies an interface identifier to remove from the local endpoint map. An interface identifier is required.  Only one interface can be removed in a single operation. The interface identifier has the following form:

interface-uuid,major-version.minor-version

The Universal Unique Identifier (UUID) is a hexadecimal string and the version numbers are decimal strings, as in the following example:

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

Leading zeros in version numbers are ignored. 

-o object-uuid
Defines an object UUID that further determines the endpoint map elements that are removed (optional). Each remove mapping command accepts up to 32 ­-o options. 

The UUID is a hexadecimal string, as in the following example:

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

DESCRIPTION

The remove mapping command removes server address information from the local endpoint map.  Each element in the local endpoint map logically contains the following:

       •interface ID, consisting of an interface UUID and versions (major and minor)

       •binding information

       •object UUID (optional)

       •annotation (optional)

This command requires one interface identifier (the ­-i option), at least one string binding (the ­-b option), and optionally, one or more object UUIDs (the ­-o option).  Each instance of the command accepts from 1 to 32 ­-b options and from 0 to 32 ­-o options.  The options work together to delimit the elements to be removed from the target endpoint map.  The command removes any map element that contains the specified interface identifier, a specified string binding, and a specified object UUID (if any). 

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

The following command operates from the system prompt to remove a map element from the local endpoint map.  The command removes only the map element that contains the specified interface identifier, server address (specified as a string binding), and object UUID. 

rpccp remove mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
  -b ncadg_ip_udp:16.20.16.64[3424] \
  -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528

RELATED INFORMATION

Commands:

rpccp_add_mapping(8rpc), rpccp_show_mapping(8rpc), rpccp_show_server(8rpc).