groupadd(8)

NAME
groupadd - create a new group entry

SYNOPSIS

groupadd [-D binddn] [-P path] [-g gid [-o]] [-p password]
    [-r] [--service service] [--help] [--usage] [-v] group

DESCRIPTION
groupadd 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 choosen can be specified in /etc/login.defs.

-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 authentication.

-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 ALSO
login.defs(5), group(5), groupdel(8), groupmod(8)

AUTHOR
Thorsten Kukuk <kukuk@suse.de>