groupadd(8)groupadd(8)NAMEgroupadd - create a new group entry
SYNOPSISgroupadd [-D binddn] [-P path] [-g gid [-o]] [-p password] [--pre‐
ferred-gid gid]
[-r] [--service service] [--help] [--usage] [-v] group
DESCRIPTIONgroupadd creates a new group entry using the values specified on the
command line. Depending on the command line options the new entry will
be added to the system files or LDAP database.
The group name must begin with an alphabetic character and the rest of
the string should be from the POSIX portable character class ([A-Za-
z_][A-Za-z0-9_-.]*).
OPTIONS-g, --gid gid
Force the new group ID to be the given number. This value must
be positive and unique. The default is to use the first free ID
after the greatest used one. The range from which the group ID
is chosen can be specified in /etc/login.defs.
--preferred-gid gid
Set the new group ID to the specified value if possible. If that
value is already in use the first free ID will be chosen as
described above.
-o, --non-unique
Allow duplicate (non-unique) group IDs.
-p, --password password
Encrypted password as returned by crypt(3) for the new account.
The default is to disable the account.
-r, --system
Create a system group. A system group is an entry with an GID
between SYSTEM_GID_MIN and SYSTEM_GID_MAX as defined in
/etc/login.defs, if no GID is specified.
--service service
Add the group to a special directory. The default is files, but
ldap is also valid.
-D, --binddn binddn
Use the Distinguished Name binddn to bind to the LDAP directory.
The user will be prompted for a password for simple authentica‐
tion.
-P, --path path
The group file is located below the specified directory path.
groupadd will use this files, not /etc/group.
--help Print a list of valid options with a short description.
--usage
Print a short list of valid options.
-v, --version
Print the version number and exit.
FILES
/etc/group - group account information
SEE ALSOlogin.defs(5), group(5), groupdel(8), groupmod(8)AUTHOR
Thorsten Kukuk <kukuk@suse.de>
pwdutils December 2003 groupadd(8)