.\" Copyright Andries Brouwer, 2000
.\"
.\" This file may be copied under the conditions described
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
.\" that should have been distributed together with this file.
.\"
.TH CHGRP 1 2000-08 "GNU fileutils 4.0"
.SH NAME
chgrp \- change group ownership of files
.SH SYNOPSIS
.BI "chgrp [" options "] " "group file..."
.sp
POSIX options:
.B "[\-R] [\-\-]"
.sp
POSIX 1003.1-2001 options:
.B [\-hHLPR]
.sp
GNU group denotation:
.BI [\-\-reference= rfile ]
.sp
GNU options (shortest form):
.B [\-cfvR]
.B "[\-\-help] [\-\-version] [\-\-]"
.SH DESCRIPTION
.B chgrp
changes the group ownership of each given
.I file
to
.IR group ,
which can be either a group name or a numeric group ID.
.SH "POSIX OPTIONS"
.TP
.B \-R
Recursively change the group ownership of directories and their contents.
(And continue even when errors are encountered.)
.TP
.B "\-\-"
Terminate option list.
.SH "AUSTIN DRAFT OPTIONS"
.TP
.B \-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.
.TP
.BR \-H " (half-logical)"
(When given together with
.BR \-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.
.TP
.BR \-L " (logical)"
(When given together with
.BR \-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.
.TP
.BR \-P " (physical)"
(When given together with
.BR \-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 support a group ownership for symlinks,
do nothing for a symlink. This is the default.
.TP
.BR \-R
Recursively change the group ownership of directories and their contents.
.SH "ADDITIONAL GNU DESCRIPTION"
A GNU extension (new in fileutils 4.0) allows one to use
.BI "\-\-reference=" "rfile"
as a group description: the same group as that of
.IR rfile .
.SH "GNU OPTIONS"
.TP
.B "\-c, \-\-changes"
Verbosely describe the action for each
.I file
whose group actually changes.
.TP
.B "\-f, \-\-silent, \-\-quiet"
Do not print error messages about files whose group cannot be changed.
.TP
.B "\-h, \-\-no\-dereference"
Act on symbolic links themselves instead of what they point to.
Only available if the
.B lchown
system call is provided.
.TP
.B "\-v, \-\-verbose"
Verbosely describe the action or non-action taken for every
.IR file .
.TP
.B "\-R, \-\-recursive"
Recursively change the group ownership of directories and their contents.
.SH "GNU STANDARD OPTIONS"
.TP
.B "\-\-help"
Print a usage message on standard output and exit successfully.
.TP
.B "\-\-version"
Print version information on standard output, then exit successfully.
.TP
.B "\-\-"
Terminate option list.
.SH 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.
.SH "CONFORMING TO"
POSIX 1003.2 only requires the \-R option. Use of other options
may not be portable.
.SH NOTES
This page describes
.B chgrp
as found in the fileutils-4.0 package;
other versions may differ slightly.