| #### principal modify Changes attributes of principals. The syntax is: 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> ####