Maintenance Commands                                 groupadd(1M)

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

SYNOPSIS
     /usr/sbin/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.

OPTIONS
     The following options are supported:

     -g gid    Assigns the group id gid for the new group.   This
               group  id  must  be a non-negative decimal integer
               below       MAXUID       as       defined       in
               /usr/include/sys/param.h. 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 by  SunOS  for  future
               applications.)

     -o        Allows the gid to be duplicated (non-unique).

OPERANDS
     The following operands are supported:

     group     A string consisting of characters from the set  of
               lower case alphabetic characters and numeric char-
               acters. A warning message will be written  if  the
               string  exceeds  MAXGLEN,  which is usually set at
               eight characters. The group field must contain  at
               least  one  character;  it  accepts  lower case or
               numeric characters or a combination of  both,  and
               must not contain a colon  (:) or  NEWLINE.

EXIT STATUS
     The following exit values are returned:

     0         Successful completion.

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

     3         An invalid argument was provided to an option.

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

     9         The group is not unique.

     10        The  /etc/group file cannot be updated.

FILES
     /etc/group

     /usr/include/userdefs.h

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     users(1B),    groupdel(1M),     groupmod(1M),     grpck(1M),
     logins(1M), pwck(1M), useradd(1M), userdel(1M), usermod(1M),
     group(4), attributes(5)

NOTES
     groupadd  only adds a group definition to the local  system.
     If  a network name service such as NIS or NIS+ is being used
     to supplement the  local  /etc/group  file  with  additional
     entries, groupadd  cannot change information supplied by the
     network name service. However,  groupadd   will  verify  the
     uniqueness  of  group name and group ID against the external
     name service.