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 profile(1m)		     OSF		    show profile(1m)




 NAME
      show profile - Shows the elements of a profile

 SYNOPSIS
      rpccp show profile  profile-entry-name
      {-d    |	 -a annotation	  |    -i if-id	  [-v versions]	  -m member}
      [-r [integer]]	[-s syntax]   [-u]


 OPTIONS
      -d	Selects the default profile element. With the -d option, the
		-a, -i, and -m options are ignored.

		Note that the -a option works with the -d option, but do not
		use them together.

      -a	Declares a single annotation field (optional).	The -a
		option selects only elements containing the specified
		annotation. The option is case sensitive.

		The -a option works alone or in combination with the -i or
		-m options or both; only elements containing all the
		specified values are displayed.

		Note that the shell supports quotation marks around the
		annotation field of profile elements, allowing you to
		include internal spaces in an annotation; the control
		program does not.  To specify or refer to annotations from
		within the control program, limit each annotation to an
		unbroken alphanumeric string; for example, CalendarGroup. To
		refer to annotations from the system prompt, do not
		incorporate quotation marks into any annotation.

      -i	Selects a specified interface identifier (optional).  Only
		elements containing that interface identifier are shown.

		The interface identifier 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.

		The -i option works alone or in combination with the -a or
		-m options or both; only elements containing all the
		specified values are displayed.	 When the -d option is
		specified, the -i option is ignored.



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






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




      -m	Declares a single member name (optional).  Only elements
		containing that member name are shown.

		The -m option works alone or in combination with the -a or
		-i options or both; only elements containing all the
		specified values are displayed.	 When the -d option is
		specified, the -m option is ignored.

      -r	Indicates that the show profile operation recurses.  If the
		member of any element of a profile is also a profile, its
		elements are shown.  By default, the -r option causes the
		show profile operation to recurse until all nested profiles
		are expanded; for example, -r shows the elements of the
		specified profile and of all nested profiles.

		You can limit recursion to one or more levels by specifying
		a decimal integer as part of the -r option. For example, -r
		1 shows the elements of the specified profile and, for
		element members that are profiles, the command also shows
		their elements; then recursion stops.

		Without the -r option, only the profile elements in the
		specified entry are shown.

      -s	Indicates 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.

      -u	Updates the local CDS cache copy of name service data
		(optional).

		Name service data is cached locally on each machine in a
		cell.  If an rpccp inquiry can be satisfied by data in the
		local CDS cache, this cached data is returned.	Locally
		cached copies of name service data might not include a
		recent CDS update, however. If the required data is not
		available in the local CDS cache, rpccp goes to a CDS
		server(s) to retrieve the required data. rpccp then updates
		the local CDS cache.

		Using the -u option bypasses the local cache, allowing rpccp
		to go directly to a CDS server for the inquiry.	 rpccp then
		updates the local CDS cache.

      -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	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 show profile(1m)	  Open Software Foundation	    show profile(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.


 ARGUMENTS
      profile-entry-name
		Indicates the name of the target profile.  For an entry in
		the local cell, you can omit the cell name and specify only
		the cell-relative name.


 DESCRIPTION
      The show profile command shows the elements of a profile in the name
      service database.	 The entry name of the profile is required.

      By default, all elements in the profile are shown. You can select a
      subset of the elements by specifying the -a, -i, or -m options.  The
      -r option enables you to show nested profiles.

    Privilege Required
      You need read permission to the CDS object entry (the target profile
      entry).  If you use the -r option, you also need read permission to
      any nested profiles.

 NOTE
      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 command operates from the system prompt to show the cell



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






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




      profile /.:/cell-profile in the local cell:

       rpccp show profile  /.:/cell-profile


      The initial shell commands set up an environment variable
      MOLLY_O_PROFILE, which represents the user profile
      /.:/LandS/anthro/molly_o_profile. The control program commands start
      the control program and show the user profile associated with the
      MOLLY_O_PROFILE environment variable, as follows:

       MOLLY_O_PROFILE=/.:/LandS/anthro/molly_o_profile
       export MOLLY_O_PROFILE
       rpccp
      pccp>&gt&gt> show profile MOLLY_O_PROFILE


 RELATED INFORMATION
      Commands: add element(1m), remove element(1m), remove profile(1m)



































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