chgrp(1)              UNIX System V(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
      {POSIXCHOWNRESTRICTED}, 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)
      chown(2) in the Programmer's Reference Manual.
      group(4), passwd(4) in the System Administrator'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.












10/89                                                                    Page 1