ROLEMOD(8) Maintenance Procedures ROLEMOD(8)


rolemod - modify a role's login information on the system


rolemod [-u uid [-o]] [-g group] [-G group[,group]...]
[-d dir [-m [-z|-Z]]] [-s shell] [-c comment] [-l new_name]
[-f inactive] [-e expire]
[-A authorization[,authorization]...]
[-P profile[,profile]...] [-K key=value] role


The rolemod utility modifies a role's login information on the system. It
changes the definition of the specified login and makes the appropriate
login-related system file and file system changes.

The system file entries created with this command have a limit of 512
characters per line. Specifying long arguments to several options can
exceed this limit.


The following options are supported:

-A authorization

One or more comma separated authorizations as defined in
auth_attr(5). Only a user or role who has grant rights to the
authorization can assign it to an account. This replaces any existing
authorization setting. If an empty authorization list is specified,
the existing setting is removed.

-c comment

Specify a comment string. comment can be any text string. It is
generally a short description of the login, and is currently used as
the field for the role's full name. This information is stored in the
role's /etc/passwd entry.

-d dir

Specify the new home directory of the role. It defaults to
base_dir/login, where base_dir is the base directory for new login
home directories, and login is the new login.

-e expire

Specify the expiration date for a role. After this date, no role will
be able to access this login. The expire option argument is a date
entered using one of the date formats included in the template file
/etc/datemsk. See getdate(3C).

For example, you may enter 10/6/90 or October 6, 1990. A value of ``
'' defeats the status of the expired date.

-f inactive

Specify the maximum number of days allowed between uses of a login ID
before that login ID is declared invalid. Normal values are positive
integers. A value of 0 defeats the status.

-g group

Specify an existing group's integer ID or character-string name. It
redefines the role's primary group membership.

-G group

One or more comma-separated existing groups, specified by integer ID
or character-string name. It redefines the role's supplementary group
membership. Any duplicate groups between the -g and -G options are
ignored. No more than NGROUPS_UMAX groups may be specified as
defined in <sys/param.h>.

-K key=value

Replace existing or add to a role's key=value pair attributes.
Multiple -K options can be used to replace or add multiple key=value
pairs. However, keys must not be repeated. The generic -K option
with the appropriate key may be used instead of the specific implied
key options (-A and -P). See user_attr(5) for a list of valid
key=value pairs.

The keyword type can be specified with the value role or the value
normal. When using the value normal, the account changes from a role
user to a normal user; using the value role keeps the account a role

-l new_logname

Specify the new login name for the role. The new_logname argument is
a string of no more than eight bytes consisting of characters from
the set of alphabetic characters, numeric characters, period (.),
underline (_), and hyphen (-). The first character should be
alphabetic and the field should contain at least one lower case
alphabetic character. A warning message will be written if these
restrictions are not met. A future release may refuse to accept login
fields that do not meet these requirements. The new_logname argument
must contain at least one character and must not contain a colon (:)
or NEWLINE (\n).

-m [-z|-Z]

Move the role's home directory to the new directory specified with
the -d option. If the directory already exists, it must have
permissions read/write/execute by group, where group is the role's
primary group.

If the role's old home directory was located on a separate ZFS file
system and the /etc/default/useradd file contains the parameter
MANAGE_ZFS set to the value YES, the file system will be destroyed
after the home directory is moved. If the parent directory of the
role's new home directory is located on a separate ZFS filesystem and
the /etc/default/useradd file contains the parameter MANAGE_ZFS set
to the value YES, a new ZFS file system will be created.

If the -z option is specified, rolemod will always try to create a
new file system for the home directory and destroy the old one.

If the -Z option is specified, a new file system will never be
created, and the old one will never be destroyed.


This option allows the specified UID to be duplicated (non-unique).

-P profile

One or more comma-separated execution profiles defined in
prof_attr(5). This replaces any existing profile setting. If an
empty profile list is specified, the existing setting is removed.

-s shell

Specify the full pathname of the program that is used as the role's
shell on login. The value of shell must be a valid executable file.

-u uid

Specify a new UID for the role. It must be a non-negative decimal
integer less than MAXUID as defined in <sys/param.h>. The UID
associated with the role's home directory is not modified with this
option; a role will not have access to their home directory until the
UID is manually reassigned using chown(1).


The following operands are supported:


An existing login name to be modified.


In case of an error, rolemod prints an error message and exits with one
of the following values:


The command syntax was invalid. A usage message for the rolemod
command is displayed.


An invalid argument was provided to an option.


The uid given with the -u option is already in use.


The password files contain an error. pwconv(8) can be used to correct
possible errors. See passwd(5).


The login to be modified does not exist, the group does not exist, or
the login shell does not exist.


The login to be modified is in use.


The new_logname is already in use.


Cannot update the /etc/group or /etc/user_attr file. Other update
requests will be implemented.


Insufficient space to move the home directory (-m option). Other
update requests will be implemented.


Unable to complete the move of the home directory to the new home



configuration file for user and role administrative commands


system file containing group definitions


system file of date formats


system password file


system file containing users' and roles' encrypted passwords and
related information


system file containing additional user and role attributes


See attributes(7) for descriptions of the following attributes:

|Interface Stability | Evolving |


chown(1), passwd(1), getdate(3C), auth_attr(5), passwd(5), prof_attr(5),
user_attr(5), attributes(7), groupadd(8), groupdel(8), groupmod(8),
logins(8), pwconv(8), roleadd(8), roledel(8), useradd(8), userdel(8),
usermod(8), zfs(8)

January 7, 2018 ROLEMOD(8)