CHGRP(1) CHGRP(1)
NAME
chgrp - change group ownership of files
SYNOPSIS
chgrp [options] group file...
POSIX options: [-R] [--]
Austin draft options: [-hHLPR]
GNU group denotation: [--reference=rfile]
GNU options (shortest form): [-cfvR] [--help] [--version]
[--]
DESCRIPTION
chgrp changes the group ownership of each given file to
group, which can be either a group name or a numeric group
ID.
POSIX OPTIONS
-R Recursively change the group ownership of directo-
ries and their contents. (And continue even when
errors are encountered.)
-- Terminate option list.
AUSTIN DRAFT OPTIONS
-h For each file operand given that is a symlink,
change the group ownership of the symlink itself,
rather than the object it points to. If the system
does not support a group ownership for symlinks, do
nothing for a symlink.
-H (half-logical)
(When given together with -R.) For each file
operand given that is a symlink to a directory,
change the group ownership of the directory and all
files in the file hierarchy below it.
-L (logical)
(When given together with -R.) For each file,
either command line operand or encountered during
the tree walk, that is a symlink to a directory,
change the group ownership of the directory and all
files in the file hierarchy below it.
-P (physical)
(When given together with -R.) For each file,
either command line operand or encountered during
the tree walk, that is a symlink, change the group
ownership of the symlink itself, rather than the
object it points to. If the system does not sup-
port a group ownership for symlinks, do nothing for
GNU fileutils 4.0 August 2000 1
CHGRP(1) CHGRP(1)
a symlink. This is the default.
-R Recursively change the group ownership of directo-
ries and their contents.
ADDITIONAL GNU DESCRIPTION
A GNU extension (new in fileutils 4.0) allows one to use
--reference=rfile as a group description: the same group
as that of rfile.
GNU OPTIONS
-c, --changes
Verbosely describe the action for each file whose
group actually changes.
-f, --silent, --quiet
Do not print error messages about files whose group
cannot be changed.
-h, --no-dereference
Act on symbolic links themselves instead of what
they point to. Only available if the lchown system
call is provided.
-v, --verbose
Verbosely describe the action or non-action taken
for every file.
-R, --recursive
Recursively change the group ownership of directo-
ries and their contents.
GNU STANDARD OPTIONS
--help Print a usage message on standard output and exit
successfully.
--version
Print version information on standard output, then
exit successfully.
-- Terminate option list.
ENVIRONMENT
The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have
the usual meaning. For an XSI-conforming system: NLSPATH
has the usual meaning.
CONFORMING TO
POSIX 1003.2 only requires the -R option. Use of other
options may not be portable.
NOTES
This page describes chgrp as found in the fileutils-4.0
package; other versions may differ slightly. Mail
GNU fileutils 4.0 August 2000 2
CHGRP(1) CHGRP(1)
corrections and additions to aeb@cwi.nl. Report bugs in
the program to fileutils-bugs@gnu.ai.mit.edu.
GNU fileutils 4.0 August 2000 3