groupadd(1M)          UNIX System V(Essential Utilities)           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).

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 the -o option is not used).

      9     group is not unique.

      10    Cannot update the /etc/group file.









10/89                                                                    Page 1