NAME

groupadd − add (create) a new group definition on the system

SYNOPSIS

groupadd [-g gid [-o]] group

DESCRIPTION

The groupadd command creates a new group definition on the system by adding the appropriate entry to the /etc/group file. 

The following options are available:

-g gid The group ID for the new group.  This group ID must be a non-negative decimal integer below MAXUID as defined in the <param.h> header file.  By default, a unique group ID is allocated in the valid range.  Group IDs from 0-99 are reserved. 

-o This option allows the gid to be duplicated (non-unique). 

group A string of printable characters that specifies the name of the new group.  It may not include a colon (:) or newline (\\n). 

FILES

/etc/group

SEE ALSO

groupdel(1M), groupmod(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), users(1)

DIAGNOSTICS

The groupadd command exits with one of the following values:

0 Success. 

2 Invalid command syntax; a usage message for the groupadd command is displayed. 

3 An invalid argument was provided to an option. 

4 gid is not unique (when the -o option is not used). 

9 group is not unique. 

10 Cannot update the /etc/group file. 
 
 

  —  Essential Utilities