groupadd(1M)     SYSTEM ADMINISTRATION COMMANDS      groupadd(1M)



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.  The group ID defaults to
          the  next  available  (unique) number above the highest
          number currently assigned.  For example, if groups 100,
          105,  and  200 are assigned as groups, the next default
          group number will be 201.  (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 -o option is not used).

     9    group is not unique.

     10   Cannot update the /etc/group file.




                                                                1

groupadd(1M)     SYSTEM ADMINISTRATION COMMANDS      groupadd(1M)























































                                                                2