chgrp - Changes the group ownership of a file or directory
chgrp [-fhR] group file
command changes the group associated with
the specified file or directory to
Interfaces documented on this reference page conform to industry standards as follows:
chgrp: XPG4, XPG4-UNIX
Refer to the
reference page for more information
about industry standards and associated tags.
[Compaq] Suppresses all error reporting.
is a symbolic
link, the command
changes the group of the symbolic link. The command
changes the group of the file
referenced by the symbolic link.
to descend recursively through
its directory arguments, setting the specified group ID.
A group name from the group database or a numeric group ID.
Either specifies a group ID to be given to each file named by one of the
operands. If a numeric
operand exists in the group database as a group name, the group ID number
associated with that group name is used as the group ID.
A pathname of a file whose group ID is to be modified.
To change the group ID of a file, you must have superuser privilege or your effective user ID must match the owner ID of the file. If you do not have superuser privilege you can change the group ID of a file only to your effective group ID or to the value of a group of which you are a member.
The group argument must be either a valid group name that already exists in the group database or a valid group ID.
For each file operand, the chgrp command performs actions equivalent to the chown() function called with the following arguments: The file operand is used as the path argument. The user ID of the file is used as the owner argument. The specified group ID is used as the group argument.
command is invoked by a process
with appropriate privileges, the set-user-ID and set-group-ID bits of a file
are cleared upon successful completion.
command is invoked with the
option and 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.
command cannot read or search
a directory within a hierarchy, it continues to process the other parts of
the hierarchy that are accessible.
The following exit values are returned:
Successful completion, all requested changes were made.
An error occurred.
To change the group ownership of the file or directory named proposals to staff, enter: chgrp staff proposals
The group access permissions for
The following environment variables affect the execution of
Provides a default value for the internationalization variables
that are unset or null. If
is unset or null, the corresponding value from the default locale is used.
If any of the internationalization variables contain an invalid setting, the
utility behaves as if none of the variables had been defined.
If set to a non-empty string value, overrides the values of
all the other internationalization variables.
Determines the locale for the interpretation of sequences
of bytes of text data as characters (for example, single-byte as opposed to
multibyte characters in arguments).
Determines the locale for the format and contents of diagnostic
messages written to standard error.
Determines the location of message catalogues for the processing
Contains group information.
Commands: chmod(1), chown(1), groups(1)
Functions: chmod(2), chown(2)