PreviousNext

principal create

Creates a new principal in the registry database. The syntax is:

principal create principal_name_list
{-attribute extended_rgy_attr_list | attribute value}

Options

-attribute value
As an alternative to using the -attribute option with an attribute list, you can change individual attribute options by prepending a hyphen (-) to any attributes listed in the Attributes topic of this reference page. You cannot use this option to specify ERAs; it is only for standard group attributes described in Attributes.

-attribute extended_rgy_attribute_list
Allows you to specify attributes, including ERAs, by using an attribute list rather than using the -attribute value option. The format of an attribute list is:

{extended_rgy_attribute_list value}…{extended_rgy_attribute_list value}}

Description
The principal create operation creates a new principal in the registry database. The argument is a list of names of principals to be created. Returns an empty string on success. Options are used to specify the attributes of the newly created principal. All options are applied to all principals in the argument.

Privileges Required
You must have i (insert) permission to the directory in which the principal is to be created.

Examples
The following command creates an alias called postmaster for the principal with uid 1234:

dcecp> principal create postmaster -uid 1234 -alias yes
dcecp>