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.

OPTIONS
     -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.

DIAGNOSTICS
     The 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 =  Cannot update the /etc/group file.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed.

     If LCMESSAGES is undefined or is defined as the null string, it
     defaults to the value of LANG. If LANG is likewise undefined or null,
     the system acts as if it were not internationalized.

     If any of the locale variables has an invalid value, the system acts
     as if none of the variables was set.

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.




Page 1                       Reliant UNIX 5.44                Printed 11/98

groupmod(1M)                                                   groupmod(1M)

FILES
     /etc/group

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
















































Page 2                       Reliant UNIX 5.44                Printed 11/98