Manual Pages for UNIX Operating System command usage for man groupadd

System Administration 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 is 201. (Group IDs
               from 0-99 are reserved by SunOS for future  appli-
               cations.)


     -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 is written if the  string
              exceeds  MAXGLEN-1,  which is usually eight charac-
              ters. The group field must  contain  at  least  one
              character; it accepts lower case or numeric charac-
              ters 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.




SunOS 5.11          Last change: 22 Feb 2010                    1






System Administration Commands                       groupadd(1M)



     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
         o    /etc/group

         o    /usr/include/userdefs.h

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


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 is being used to sup-
     plement the local /etc/group file with  additional  entries,
     groupadd  cannot  change information supplied by the network
     name service. However, groupadd verifies the  uniqueness  of
     group name and group ID against the external name service.


     If the number of characters in a group entry  exceeds  2047,
     group   maintenance   commands,  such  as  groupdel(1M)  and
     groupmod(1M), fail.








SunOS 5.11          Last change: 22 Feb 2010                    2