show mapping(1m)														  show mapping(1m)

NAME

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

SYNOPSIS

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

OPTIONS

       Defines	an  interface  identifier to be shown (optional).  Only one interface can be shown in a single operation.  If specified, only ele-
       ments 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 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.	Indicates 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 described in  the  fol-
       lowing table.

						   ---------------------------------------------------
						   +-----------+-------------------------------------+
						   |Versions   | Action 			     |
						   +-----------+-------------------------------------+
						   |all        | The interface version is ignored.   |
						   |exact      | Both  the  major and minor versions |
						   |	       | must match the specified versions.  |
						   |compatible | The 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	ver- |
						   |	       | sion is ignored.		     |
						   |upto       | The 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.  Defines an object to be shown (optional).  Each show mapping
       command accepts up to 32 -o options.

       The UUID is a hexadecimal string, for example: -o 3c6b8f60-5945-11c9-a236-08002b102989

ARGUMENTS

       The 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); for example, ncadg_ip_udp: When accessing a remote endpoint map, you must spec-
       ify both a protocol sequence and a network address for the remote system (required); for 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 an RPC protocol sequence, a network address, and an endpoint within square brack-
       ets (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	object 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 Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

EXAMPLES

       The  following  commands start the control program and show the map elements in the local endpoint map that contain the specified interface
       identifier: $ rpccp rpccp> show mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1

       The following rpccp show mapping command operates from the system prompt.  The command accesses the endpoint map of the remote host  speci-
       fied  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: remove mapping(1m), show server(1m)

																  show mapping(1m)