Help
The DCE control program provides several kinds of help. All returned help strings are obtained from appropriate message catalogs.
To see which operations an object supports, use the operations command. An example is:
dcecp> principal operations catalog create delete modify rename show help operations dcecp>
This command provides simple help similar to usage messages found on many systems. Users unsure of an operation name or whether an operation is supported by an object can use this command to find
the answer. The output is a dcecp list that can be used by other dcecp commands.
To see other information about an object, use an object's help operation. All dcecp objects have a help operation that offers three kinds of information.
· View brief information about an object's operations by using help without arguments or options. Operations are listed in alphabetical order, with the
operations and help operations listed last because all objects support these operations. An example is:
dcecp> principal help catalog Returns all the names of principals in the registry. create Creates a DCE principal. delete
Deletes a principal from the registry. modify Changes the information about a principal. rename Renames the specified principal.
show Returns the attributes of a principal. help Print summary of command-line options. operations Returns a list of the
valid operations for this command. dcecp>
· View brief information about the options an operation supports by using help with one argument - the name of the operation. This operation returns attribute
options in alphabetical order. If no options are supported, an empty string is returned. An example is:
dcecp> principal help create
-alias Add principal named as an alias of specified uid. -attribute Attribute list to be assigned to the new principal. -fullname Fullname
of the new principal. -quota Quota of the new principal. -uid User Identifier of the new principal. -uuid Orphaned
UUID to be adopted by the specified principal. dcecp>
· View a short description of a dcecp object using the help operation with the -verbose option. This command returns text explaining what the object
represents and how to use it. An example is:
dcecp> principal help -verbose This object allows manipulation of principal information stored in the DCE registry. The argument is a list of either
relative or fully-qualified principal names. Specify fixed attributes using attribute options or attribute lists. Specify any extended attributes using
attribute lists. Principal operations connect to a registry that can service the request. Specify a particular registry by setting the _s(sec) convenience variable to be a
cell-relative or global replica name, or the binding of the host where the replica exists. The completed operation sets _b(sec) to the name of the registry
contacted.
dcecp>
|