NAME

show mapping - Shows the elements of the local or a remote endpoint map

SYNOPSIS

rpccp show mapping [host-address] [-i if-id [-v versions]] [-o object-uuid] ... 

OPTIONS

-i if-idDefines an interface identifier to be shown (optional).  Only one interface can be shown in a single operation.  If specified, only elements containing this interface identifier are shown.  The ­-i option can be qualified by the ­-v option.  The value 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. 

-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 are 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 shown (optional). Each show 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

ARGUMENTS

host-addressThe host-address argument is a string binding that indicates where to find the target endpoint map.  When accessing the local endpoint map, you can specify which protocol sequence to use (optional), as in the following example:

ncadg_ip_udp:

When accessing a remote endpoint map, you must specify both a protocol sequence and a network address for the remote system (required), as in the following example:

ncadg_ip_udp:16.20.16.44

An endpoint is unnecessary in local or remote host addresses, and the remove mapping command ignores any endpoint specified as part of a host address. 

DESCRIPTION

The show mapping command shows elements of an endpoint map.  Each element corresponds to an object UUID, interface identifier, annotation, and binding information.  The binding information contains a remote procedure call (RPC) protocol sequence, a network address, and an endpoint within square brackets, as follows:

rpc-prot-seq:network-addr[endpoint]

The endpoint map can be either the local endpoint map or the endpoint map of a specified remote host.  If entered without a remote host address, the command accesses the local endpoint map.  For the local endpoint map, a show mapping command without any options displays all the map elements.  For a remote endpoint map, map elements are accessible only for protocol sequences that are supported on both your system and the remote system. 

The options list a selected subset of map elements.  The ­-i option selects a specific interface, and the ­-v option qualifies the ­-i option.  The ­-o option selects a specific object.  You can use from 0 to 32 ­-o options per command.  The options work together to specify the subset of elements for the target protocol sequence(s). 

NOTES

Note that to ensure that you can remotely display all map elements from every remote endpoint map, run the RPC control program on a system that supports all of the protocol sequences available in your network environment. 

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

EXAMPLES

     1.The following command shows the map elements in the local endpoint map that contain the specified interface identifier:

rpccp> show mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1

     2.The  following  command  accesses  the  endpoint  map of the  remote host specified by the host address (ncadg_ip_udp:16.20.16.44) and displays the one map element that contains both the specified interface identifier and the specified object UUID:

rpccp show mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
  -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528 ncadg_ip_udp:16.20.16.44

RELATED INFORMATION

Commands:

rpccp_remove_mapping(8rpc), rpccp_show_server(8rpc).