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.  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).
             If group is preceded by a + or - character, (for example,
             +student), the group definition will be administered by the
             Network Information Service (NIS).  Values for the -g and -o
             options will be silently ignored if these options are
             specified.  Instead, the value for group ID will be taken from
             the NIS database.  See group(4) for more information.

       FILES
             /etc/group

       REFERENCES
             groupdel(1M), groupmod(1M), logins(1M), useradd(1M),
             userdel(1M), usermod(1M), users(1BSD), group(4)

       DIAGNOSTICS
             The groupadd command exits with 0 on success, or displays
             error messages under the following conditions:

                   Invalid command syntax.





                           Copyright 1994 Novell, Inc.               Page 1

      groupadd(1M)                                            groupadd(1M)


                  An invalid argument was provided to an option.

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

                  group is not unique.

                  Cannot update the /etc/group file.









































                          Copyright 1994 Novell, Inc.               Page 2