chgrp
sets the group ID of the specified files.
The options are as follows:
-f
The force option ignores errors, except for usage errors.
-H
If the
-R
option is specified, symbolic links on the command line are followed.
(Symbolic links encountered in the tree traversal are not followed.)
-h
Change the group ID of the specified symbolic link.
The
-h
and
-R
options are mutually exclusive.
-L
If the
-R
option is specified, all symbolic links are followed.
-P
If the
-R
option is specified, no symbolic links are followed.
-R
Change the group ID for the file hierarchies rooted
in the files instead of just the files themselves.
The
-H,
-L,
and
-P
options are ignored unless the
-R
option is specified.
In addition, these options override each other and the
command's actions are determined by the last one specified.
The
group
operand can be either a group name from the group database,
or a numeric group ID.
If a group name is also a numeric group ID, the operand is used as a
group name.
The user invoking
chgrp
must belong to the specified group and be the owner of the file,
or be the superuser.
The
chgrp
utility exits 0 on success or >0 if an error occurred.