groupmod(1M)                                                   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 99.  (Group IDs from 0-99 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.





   7/91                                                                 Page 1

   groupmod(1M)                                                   groupmod(1M)


         10    Cannot update the /etc/group file.




















































   Page 2                                                                 7/91