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.

             If group is preceded by a + character, (for example,
             +student), the group definition is administered by the Network
             Information Service (NIS).  In this case, the value for group
             ID will be taken from the NIS database.  For such
             specifications, use of the -g or -o options will cause a
             syntax error to be returned.  See group(4) for more
             information.

       FILES
             /etc/group

       REFERENCES
             groupadd(1M), groupdel(1M), logins(1M), useradd(1M),
             userdel(1M), usermod(1M), users(1BSD), group(4)

       DIAGNOSTICS
             The groupmod command exits with 0 on success, or displays
             error messages for the following conditions:


                           Copyright 1994 Novell, Inc.               Page 1

      groupmod(1M)                                            groupmod(1M)


                  Invalid command syntax.

                  An invalid argument was provided to an option.

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

                  group does not exist.

                  name already exists as a group name.

                  Cannot update the /etc/group file.





































                          Copyright 1994 Novell, Inc.               Page 2