groupmod(1M)      MISC. REFERENCE MANUAL PAGES       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  speci-
     fied  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 avail-
          able  (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 group-
          mod 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.




                Last change: Essential Utilities                1

groupmod(1M)      MISC. REFERENCE MANUAL PAGES       groupmod(1M)



     10   Cannot update the /etc/group file.






















































                Last change: Essential Utilities                2