OS Manuals

/usr/bin/groupadd

PAM login and passwd utilities

From shadow 4.20.3-r3 (os), captured 2026-11-05 by running groupadd --help (exit 0). permalink

Usage: groupadd [options] GROUP

Options:
  -f, --force                   exit successfully if the group already exists,
                                and cancel -g if the GID is already used
  -g, --gid GID                 use GID for the new group
  -h, --help                    display this help message and exit
  -K, --key KEY=VALUE           override /etc/login.defs defaults
  -o, --non-unique              allow to create groups with duplicate
                                (non-unique) GID
  -p, --password PASSWORD       use this encrypted password for the new group
  -r, --system                  create a system group
  -R, --root CHROOT_DIR         directory to chroot into
  -P, --prefix PREFIX_DIR       directory prefix
  -U, --users USERS             comma-separated list of users to add as
	                         members of this group
Options (10)
OptionDescriptionSource
-f, --forceexit successfully if the group already exists, and cancel -g if the GID is already usedhelp
-g, --gid GIDuse GID for the new grouphelp
-h, --helpdisplay this help message and exithelp
-K, --key KEY=VALUEoverride /etc/login.defs defaultshelp
-o, --non-uniqueallow to create groups with duplicate (non-unique) GIDhelp
-p, --password PASSWORDuse this encrypted password for the new grouphelp
-r, --systemcreate a system grouphelp
-R, --root CHROOT_DIRdirectory to chroot intohelp
-P, --prefix PREFIX_DIRdirectory prefixhelp
-U, --users USERScomma-separated list of users to add as members of this grouphelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.