chgrp(1)                   (Essential Utilities)                   chgrp(1)


   NAME
         chgrp - change the group ownership of a file

   SYNOPSIS
         chgrp [-R] [-h] group file ...

   DESCRIPTION
         chgrp changes the group ID of the files given as arguments to group.
         The group may be either a decimal group ID or a group name found in
         the group ID file, /etc/group.

         You must be the owner of the file, or be the super-user to use this
         command.

         The operating system has a configuration option
         {_POSIX_CHOWN_RESTRICTED}, to restrict ownership changes.  When this
         option is in effect, the owner of the file may change the group of
         the file only to a group to which the owner belongs.  Only the
         super-user can arbitrarily change owner IDs whether this option is in
         effect or not.

         chgrp has one option:

         -R    Recursive.  chgrp descends through the directory, and any
               subdirectories, setting the specified group ID as it proceeds.
               When symbolic links are encountered, they are traversed.

         -h    If the file is a symbolic link, change the group of the
               symbolic link.  Without this option, the group of the file
               referenced by the symbolic link is changed.

   FILES
         /etc/group

   SEE ALSO
         chmod(1), chown(1).
         id(1M) in the Sytem Administrator's Reference Manual.
         chown(2) group(4), passwd(4) in the Programmer's Reference Manual.

   NOTES
         In a Remote File Sharing environment, you may not have the
         permissions that the output of the ls -l command leads you to
         believe.  For more information see the Network User's and
         Administrator's Guide.









   7/91                                                                 Page 1