usr/src/man/man1/chgrp.1

.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"     @(#)chgrp.1     6.3 (Berkeley) 4/21/88
.\"
.TH CHGRP 1 "April 21, 1988"
.UC 5
.SH NAME
chgrp \- change group
.SH SYNOPSIS
.B chgrp
[
.B -Rf
]
group file ...
.SH DESCRIPTION
.I Chgrp
changes the group-ID of the
.I files
to
.IR group .
The group may be either a decimal GID or
a group name found in the group-ID file.
.PP
The user invoking
.I chgrp
must belong
to the specified group and be the owner of the file, or be the super-user.
.PP
No errors, except for usage errors, are reported when the
.B \-f
(force) option is given.
.PP
When the
.B \-R
option is given,
.I chgrp
recursively descends its directory arguments
setting the specified group-ID.
When symbolic links are encountered, their group is changed,
but they are not traversed.
.SH "SEE ALSO"
chown(1), chown(2), passwd(5), group(5)