utility sets the group ID of the
file named by each file
operand to the
ID specified by the group operand.
The following options are available:
- If the
-R option is specified, symbolic
links on the command line are followed and hence unaffected by the
command. (Symbolic links encountered during traversal are not
- If the
-R option is specified, all
symbolic links are followed.
- If the
-R option is specified, no
symbolic links are followed. This is the default.
- Change the group ID of the file hierarchies rooted in the files, instead
of just the files themselves. Beware of unintentionally matching the
“..” hard link to the
parent directory when using wildcards like
- The force option ignores errors, except for usage errors and does not
query about strange modes (unless the user does not have proper
- If the file is a symbolic link, the group ID of the link itself is changed
rather than the file that is pointed to.
chgrp to be verbose, showing
files as the group is modified. If the
-v flag is specified more than once,
chgrp will print the filename, followed
by the old and new numeric group ID.
- File system mount points are not traversed.
options are ignored unless the
option is specified. In addition, these
options override each other and the command's actions are determined by the
last one specified.
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
must belong to the
specified group and be the owner of the file, or be the super-user.
signal (see the
then the current filename as well as the old and new group names are
- group ID file
utility exits 0 on success,
and >0 if an error occurs.
In previous versions of this system, symbolic links did not have groups.
options are non-standard and their use
in scripts is not recommended.
utility is expected to be
IEEE Std 1003.2 (“POSIX.2”)