groupmod(1M)          UNIX System V(Essential Utilities)           groupmod(1M)


NAME
      groupmod - modify a group definition on the system

SYNOPSIS
      groupmod [-g gid [-o]] [-n name] group

DESCRIPTION
      The groupmod command modifies the definition of the specified group by
      modifying the appropriate entry in 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 <param.h>.  The
           group ID defaults to the next available (unique) number above 6000.
           (Group IDs from 0-60000 are reserved.)

      -o   This option allows the gid to be duplicated (non-unique).

      -n name
           A string of printable characters that specifies a new name for the
           group.  It may not include a colon (:) or newline (\\n).

      group
           The current name of the group to be modified.

FILES
      /etc/group

SEE ALSO
      groupadd(1M), groupdel(1M), logins(1M), useradd(1M), userdel(1M),
      usermod(1M), users(1).

DIAGNOSTICS
      The groupmod command exits with one of the following values:

      0     Success.

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

      3     An invalid argument was provided to an option.

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

      6     group does not exist.

      9     name already exists as a group name.





10/89                                                                    Page 1

groupmod(1M)          UNIX System V(Essential Utilities)           groupmod(1M)


      10    Cannot update the /etc/group file.





















































Page 2                                                                    10/89