CHGRP(1)                        User Commands                       CHGRP(1)

NAME         top

       chgrp - change group ownership

SYNOPSIS         top

       chgrp [OPTION]... GROUP FILE...
       chgrp [OPTION]... --reference=RFILE FILE...

DESCRIPTION         top

       Change the group of each FILE to GROUP.  With --reference, change the
       group of each FILE to that of RFILE.

       -c, --changes
              like verbose but report only when a change is made

       -f, --silent, --quiet
              suppress most error messages

       -v, --verbose
              output a diagnostic for every file processed

              affect the referent of each symbolic link (this is the
              default), rather than the symbolic link itself

       -h, --no-dereference
              affect symbolic links instead of any referenced file (useful
              only on systems that can change the ownership of a symlink)

              do not treat '/' specially (the default)

              fail to operate recursively on '/'

              use RFILE's group rather than specifying a GROUP value

       -R, --recursive
              operate on files and directories recursively

       The following options modify how a hierarchy is traversed when the -R
       option is also specified.  If more than one is specified, only the
       final one takes effect.

       -H     if a command line argument is a symbolic link to a directory,
              traverse it

       -L     traverse every symbolic link to a directory encountered

       -P     do not traverse any symbolic links (default)

       --help display this help and exit

              output version information and exit

EXAMPLES         top

       chgrp staff /u
              Change the group of /u to "staff".

       chgrp -hR staff /u
              Change the group of /u and subfiles to "staff".

AUTHOR         top

       Written by David MacKenzie and Jim Meyering.

REPORTING BUGS         top

       GNU coreutils online help: <>
       Report chgrp translation bugs to

COPYRIGHT         top

       Copyright © 2016 Free Software Foundation, Inc.  License GPLv3+: GNU
       GPL version 3 or later <>.
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO         top

       chown(1), chown(2)

       Full documentation at: <>
       or available locally via: info '(coreutils) chgrp invocation'

COLOPHON         top

       This page is part of the coreutils (basic file, shell and text
       manipulation utilities) project.  Information about the project can
       be found at ⟨⟩.  If you have a
       bug report for this manual page, see 
       ⟨⟩.  This page was obtained from
       the tarball coreutils-8.25.tar.xz fetched from 
       ⟨⟩ on 2016-10-04.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

GNU coreutils 8.25              January 2016                        CHGRP(1)