Change file group ownership (POSIX)
Syntax:
chgrp [-hRv] group file...
Options:
- -h
- Modify the symbolic link instead of the referenced file.
- -R
- Recursively change group ownership of files.
For each file that names a directory, chgrp changes the group of the
directory and of all files in the file hierarchy below it.
- -v
- Be verbose; display to stdout all the operations being performed.
- group
- A group name from the group database, or a numeric group ID.
- file
- The pathname of a file whose group ID is to be modified.
Description:
The chgrp utility lets you change the group ownership of one or more files.
For each file you name, chgrp sets the file's group ID to that specified by the
group argument.
If you invoke chgrp with the -R option,
and chgrp attempts but fails to change the group ID
of a particular file in a specified file hierarchy, it continues to
process the remaining files in the hierarchy.
Note:
You must be
root or the owner of the file in order to change its group ownership.
The underlying filesystem might impose further restrictions.
For example, it might set the
_PC_CHOWN_RESTRICTED configuration variable; for more information, see
pathconf()
in the
QNX Neutrino C Library Reference.
Examples:
Change the group of myfile to 27:
chgrp 27 myfile
Change the group of myfile to technical:
chgrp technical myfile
Files:
- /etc/group
- This file defines the known group IDs for the system.
It associates group names with a numerical ID and a list of users who are members of the group.
Entries in this file appear in the following format:
groupname:unused:groupid:user[,user]...
Exit status:
- 0
- The utility executed successfully and all requested changes were made.
- >0
- An error occurred.