unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 show mapping(1m)		     OSF		    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
      -i	Defines 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 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	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
		following table.























 Hewlett-Packard Company	    - 1 -	      OSF DCE 1.1/HP DCE 1.8






 show mapping(1m)	  Open Software Foundation	    show mapping(1m)




		     __________________________________________________
		     __________________________________________________
		     |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	       |
		     |		 | version 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.

      -o	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
      host-address
		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 specify 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.




 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 show mapping(1m)	  Open Software Foundation	    show mapping(1m)




 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 brackets (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
      pccp>&gt&gt> 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
      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





 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8






 show mapping(1m)	  Open Software Foundation	    show mapping(1m)




 RELATED INFORMATION
      Commands: remove mapping(1m), show server(1m)




















































 Hewlett-Packard Company	    - 4 -	      OSF DCE 1.1/HP DCE 1.8