show profile(8rpc) — Maintenance
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
-dSelects the default profile element. With the -d option, the -a, -i, and -m options are ignored.
Although that the -a option does operate with the -d option, you should not use them together.
-a annotation
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 the use of " " (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 if-idSelects 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 Universal Unique Identifier 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.
-v versionsIndicates 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 as follows:
allThe interface version is ignored.
exactBoth the major and minor versions must match the specified versions.
compatibleThe 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.
uptoThe 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.
-m memberDeclares 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 [integer]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 syntaxIndicates 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.
-uUpdates the local Cell Directory Service (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 The local CDS cache is then updated by rpccp.
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.
Privileges Required
You need r (read) permission to the CDS object entry (the target profile entry). If you use the -r option, you also need r (read) permission to any nested profiles.
NOTES
This command is replaced at DCE Version 1.1 by the dcecp command and may not be provided in future releases of DCE.
EXAMPLES
1.The following command shows the cell profile /.:/cell-profile in the local cell:
rpccp show profile /.:/cell-profile
2.This sequence sets up an environment variable MOLLY_O_PROFILE, which represents the user profile /.:/LandS/anthro/molly_o_profile, exports it, and show the user profile associated with the MOLLY_O_PROFILE environment variable:
MOLLY_O_PROFILE=/.:/LandS/anthro/molly_o_profile
export MOLLY_O_PROFILE
rpccp
rpccp> show profile MOLLY_O_PROFILE
RELATED INFORMATION
Commands:
rpccp_add_element(8rpc), rpccp_remove_element(8rpc), rpccp_remove_profile(8rpc).