'\" te
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH CHGRP "1" "March 2012" "GNU coreutils 8.16" "User Commands"
.SH NAME
chgrp \- change group ownership
.SH SYNOPSIS
.B chgrp
[\fIOPTION\fR]... \fIGROUP FILE\fR...
.br
.B chgrp
[\fIOPTION\fR]... \fI--reference=RFILE FILE\fR...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Change the group of each FILE to GROUP.
With \fB\-\-reference\fR, change the group of each FILE to that of RFILE.
.TP
\fB\-c\fR, \fB\-\-changes\fR
like verbose but report only when a change is made
.TP
\fB\-f\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR
suppress most error messages
.TP
\fB\-v\fR, \fB\-\-verbose\fR
output a diagnostic for every file processed
.TP
\fB\-\-dereference\fR
affect the referent of each symbolic link (this is
the default), rather than the symbolic link itself
.TP
\fB\-h\fR, \fB\-\-no\-dereference\fR
affect symbolic links instead of any referenced file
(useful only on systems that can change the
ownership of a symlink)
.TP
\fB\-\-no\-preserve\-root\fR
do not treat '/' specially (the default)
.TP
\fB\-\-preserve\-root\fR
fail to operate recursively on '/'
.TP
\fB\-\-reference\fR=\fIRFILE\fR
use RFILE's group rather than specifying a
GROUP value
.TP
\fB\-R\fR, \fB\-\-recursive\fR
operate on files and directories recursively
.PP
The following options modify how a hierarchy is traversed when the \fB\-R\fR
option is also specified.  If more than one is specified, only the final
one takes effect.
.TP
\fB\-H\fR
if a command line argument is a symbolic link
to a directory, traverse it
.TP
\fB\-L\fR
traverse every symbolic link to a directory
encountered
.TP
\fB\-P\fR
do not traverse any symbolic links (default)
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.SH EXAMPLES
.TP
chgrp staff /u
Change the group of /u to "staff".
.TP
chgrp \fB\-hR\fR staff /u
Change the group of /u and subfiles to "staff".
.SH AUTHOR
Written by David MacKenzie and Jim Meyering.
.SH "REPORTING BUGS"
Report chgrp bugs to bug\-coreutils@gnu.org
.br
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
.br
General help using GNU software: <http://www.gnu.org/gethelp/>
.br
Report chgrp translation bugs to <http://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2012 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	file/gnu-coreutils
=
Stability	Uncommitted
.TE 
.PP
.SH "SEE ALSO"
The full documentation for
.B chgrp
is maintained as a Texinfo manual.  If the
.B info
and
.B chgrp
programs are properly installed at your site, the command
.IP
.B info coreutils \(aqchgrp invocation\(aq
.PP
should give you access to the complete manual.


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz

Further information about this software can be found on the open source community website at http://www.gnu.org/software/coreutils/.