principal modify

principal modify principal_name_list
{-add extended_rgy_attr_list | -remove extended_rgy_attr_list [-types] |
-change extended_rgy_attr_list | attribute value}

Options

-attribute value
As an alternative to using options 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.

-add extended_rgy_attribute_list
Allows you to specify attributes, including ERAs, by using an attribute list rather than using individual attribute options. The format of an attribute list is:

{{extended_rgy_attribute_list value}…{extended_rgy_attribute_list value}}

-change extended_rgy_attr_list
Allows you to modify attributes, including ERAs, by using an attribute list rather than individual attribute options. See the -add option for the attribute list format.

-remove extended_rgy_attr_list
Allows you to modify attributes, including ERAs, by using an attribute list rather than individual attribute options such as -alias, -fullname, and so on. See the -add option for the attribute list format.

Without the -types option, -remove deletes individual attribute instances attached to the group. In this case, extended_rgy_attr_list is a list of attribute-value pairs. With the -types option, -remove deletes attributes types (and all instances of that type) attached to the group. In this case, extended_rgy_attr_list is a list of attribute types.

-types
Used with the -remove option to remove attribute types (and all instances of that type) attached to the group.

See the OSF DCE Administration Guide - Core Components for more information about ERAs.

Description
The principal modify operation changes attributes of principals. The argument is a list of names of principals to be operated on. All modifications are applied to all principals named in the argument. Principals are modified in the order they are listed and all modifications to an individual principal are atomic. Modifications to multiple principals are not atomic. A failure for any one principal in a list causes an error to be generated and the rest of the operation to be aborted. Returns an empty string on success.

The -change option can be used to modify the value of any one of the attributes except for uid and uuid. The value of the -change option is an attribute list describing the new values for the specified attributes. Also supports the following attribute options: -alias, -quota, and -fullname. Specify only ERA attributes by using the -add and -remove options.

Privileges Required
You must have r (read), f (full name), m (mgmt_info), and u (user_info) permissions to the principal to be modified.

Examples

dcecp> principal modify /.:/joe -fullname "Joe Long"
dcecp> principal show /.:/joe
{fullname {Joe Long}}
{uid 30014}
{uuid 0000753e-f51f-2e0e-b000-0000c08adf56}
{alias no}
{quota unlimited}
dcecp>

dcecp> principal modify joe -add {test_era 101}
dcecp>

dcecp> principal show joe -all
{fullname {Joe Long}}
{uid 30014}
{uuid 0000753e-f51f-2e0e-b000-0000c08adf56}
{alias no}
{quota unlimited}
{test_era 101}
dcecp>