groupadd(1M)                                                   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.





   7/91                                                                 Page 1