groupmod
modify a group definition on the system
TLDR
Change the group name
Change the group id
SYNOPSIS
' groupmod 'u groupmod [ options ] GROUP
DESCRIPTION
The groupmod command modifies the definition of the specified GROUP by modifying the appropriate entry in the group database .
OPTIONS
The options which apply to the groupmod command are:
-g , --gid GID The group ID of the given GROUP will be changed to GID .
-h , --help Display help message and exit .
-n , --new -name NEW_GROUP The name of the group will be changed from GROUP to NEW_GROUP name .
-o , --non -unique When used with the -g option, allow to change the group GID to a non -unique value .
-p , --password PASSWORD The encrypted password, as returned by crypt (3). Note: This option is not recommended because the password (or encrypted password) will be visible by users listing the processes . You should make sure the password respects the system (Aqs password policy .
-R , --root CHROOT_DIR Apply changes in the CHROOT_DIR directory and use the configuration files from the CHROOT_DIR directory .
-P , --prefix PREFIX_DIR Apply changes in the PREFIX_DIR directory and use the configuration files from the PREFIX_DIR directory . This option does not chroot and is intended for preparing a cross -compilation target . Some limitations: NIS and LDAP users/groups are not verified . PAM authentication is using the host files . No SELINUX support .
CONFIGURATION
The following configuration variables in /etc/login .defs change the behavior of this tool:
MAX_MEMBERS_PER_GROUP (number) Maximum members per group entry . When the maximum is reached, a new group entry (line) is started in /etc/group (with the same name, same password, and same GID) .
FILES
/etc/group Group account information .
/etc/gshadow Secure group account information .
/etc/login .defs Shadow password suite configuration .
/etc/passwd User account information .
EXIT VALUES
The groupmod command exits with the following values:
0 E_SUCCESS: success
2 E_USAGE: invalid command syntax
3 E_BAD_ARG: invalid argument to option
4 E_GID_IN_USE: specified group doesn (Aqt exist
6 E_NOTFOUND: specified group doesn (Aqt exist
9 E_NAME_IN_USE: group name already in use
10 E_GRP_UPDATE: can (Aqt update group file
11 E_CLEANUP_SERVICE: can (Aqt setup cleanup service
12 E_PAM_USERNAME: can (Aqt determine your username for use with pam
13 E_PAM_ERROR: pam returned an error, see syslog facility id groupmod for the PAM error message