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 Lead‐
ing 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 ele‐
ments 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. 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, speci‐
fying 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 num‐
bers.
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_PRO‐
FILE, 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 vari‐
able, as follows: $ MOLLY_O_PROFILE=/.:/LandS/anthro/molly_o_profile $
export MOLLY_O_PROFILE $ rpccp rpccp> show profile MOLLY_O_PROFILE
RELATED INFORMATION
Commands: add element(1m), remove element(1m), remove profile(1m)
show profile(1m)