GROUPADD(8)
<?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (System Management
Commands)

<?><?><?> (NAME)
       groupadd - <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       groupadd [OPTIONS] NEWGROUP

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> groupadd <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (underscore) <?><?>
       <?><?> <?><?><?><?> (dash) <?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
       . <?><?> .. <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> ('-')<?> <?><?><?><?> ('+')
       <?><?> <?><?><?> ('~') <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> (':')<?> <?><?><?><?> (',') <?><?>
       <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?>: ' '<?> <?><?><?><?><?>
       <?><?>: '\n'<?> <?><?>: '\t'<?> <?> <?><?><?><?>) <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       groupadd <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?>:

       -f, --force
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?>. <?><?><?><?><?><?> <?><?> <?><?> -g
           <?><?><?><?><?><?><?> <?><?><?> <?> GID <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> GID <?><?><?><?> (<?><?><?><?>) <?><?><?><?><?><?>
           <?><?><?><?><?><?> (<?><?><?><?> -g <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>).

       -g, --gid GID
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> (ID).
           GID <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> -o <?><?><?><?><?><?><?>
           <?><?><?>. <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> GID_MIN <?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?> -r <?> <?><?><?><?><?><?><?>
           GID_MAX <?><?> <?><?><?><?><?><?>.

       -h, --help
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

       -K, --key KEY=VALUE
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           /etc/login.defs (<?><?><?><?> GID_MIN<?> GID_MAX <?>
           <?><?><?><?><?> <?><?><?><?>). <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> -K <?><?> <?><?><?><?> <?><?><?>.

           <?><?><?><?>: -K GID_MIN=100  -K GID_MAX=499

           <?><?><?><?>: -K GID_MIN=10,GID_MAX=499 <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?>.

       -o, --non-unique
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> GID<?> <?><?><?><?><?> <?><?> <?><?><?><?> NEWGROUP
           <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>.

       -p, --password PASSWORD
           <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?> PASSWORD
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> crypt (3)
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

           <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> /etc/group <?><?>
           /etc/gshadow.

           <?><?><?><?>: <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> (<?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>)
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -r, --system
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           SYS_GID_MIN-SYS_GID_MAX <?><?><?><?><?><?><?><?><?> <?><?>
           login.defs <?><?> <?><?><?> GID_MIN-GID_MAX <?><?><?><?><?><?>
           <?><?><?><?><?><?><?>.

       -R, --root CHROOT_DIR
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           CHROOT_DIR <?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> CHROOT_DIR.  <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       -P, --prefix PREFIX_DIR
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> PREFIX_DIR.  <?><?><?> <?><?><?><?><?> chroot
           <?><?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> (cross-compilation) <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?>:
           <?><?><?><?><?><?><?>/<?><?><?><?><?><?><?><?> NIS <?> LDAP
           <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?>
           <?><?><?><?> PAM <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> SELINUX
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       -U, --users
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> -g<?> -N <?> -U <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?>) <?><?><?><?> <?><?><?><?><?>
           USERGROUPS_ENAB <?><?> /etc/login.defs <?><?><?><?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       /etc/login.defs <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>:

       GID_MAX (number), GID_MIN (number)
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> useradd<?>
           groupadd<?> <?><?> newusers.

           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> GID_MIN (<?><?>
           <?><?><?><?><?> GID_MAX) <?><?><?><?><?> <?><?><?><?> (<?><?>
           <?><?><?><?><?> <?><?><?><?><?>) <?><?><?>.

       MAX_MEMBERS_PER_GROUP (number)
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?>. <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           (<?><?> <?><?><?><?>) <?><?> /etc/group <?><?><?><?>
           <?><?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> <?> <?><?><?><?> GID).

           <?><?><?><?><?> <?><?><?><?><?><?><?> 0 <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> (<?><?><?><?>
           <?><?><?><?><?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> NIS <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?>.

           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> 25 <?><?><?><?><?><?><?>
           <?><?><?><?>.

           <?><?><?><?>: <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> Shadow). <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       SYS_GID_MAX (number), SYS_GID_MIN (number)
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> useradd<?>
           groupadd<?> <?><?> newusers.

           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> SYS_GID_MIN
           (<?><?> <?><?><?><?><?> SYS_GID_MAX) <?><?><?><?><?> <?><?><?>
           (<?><?> <?><?><?><?><?> GID_MIN-1) <?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       /etc/group
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.

       /etc/gshadow
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?>.

       /etc/login.defs
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           Shadow.

<?><?><?><?><?><?><?> (CAVEATS)
       <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> NIS <?><?>
       LDAP <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> NIS <?><?> LDAP <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> groupadd <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?> (EXIT VALUES)
       <?><?><?><?><?> groupadd <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>:

       0
           <?><?><?><?><?><?>

       2
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>

       3
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?>

       4
           <?><?><?><?><?> GID <?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?> (<?><?><?><?><?> <?><?><?><?> <?><?><?><?> -o)

       9
           <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?>

       10
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       chfn(1), chsh(1), passwd(1), gpasswd(8), groupdel(8), groupmod(8),
       login.defs(5), useradd(8), userdel(8), usermod(8).

shadow-utils 4.13                 12/14/2025                       GROUPADD(8)