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

       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.	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 dis-
       played.

       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.  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 dis-
       played.	When the -d option is specified, the -i option is ignored.  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 dis-
       played.	When the -d option is specified, the -m option is ignored.  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  ele-
       ments 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.  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  avail-
       able, specifying the -s option is unnecessary.  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.  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.

						   ---------------------------------------------------
						   +-----------+-------------------------------------+
						   |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.

ARGUMENTS

       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 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_pro-
       file.  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 rpccp> show profile  MOLLY_O_PRO-
       FILE

RELATED INFORMATION

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

																  show profile(1m)