chgrp - Changes the group ownership of a file or directory
chgrp [-fhR] group file
The chgrp command changes the group associated with the
specified file or directory to group.
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
[Tru64 UNIX] Suppresses all error reporting. [Tru64
UNIX] If file is a symbolic link, the command chgrp -h
file changes the group of the symbolic link. The command
chgrp file changes the group of the file referenced by the
symbolic link. Causes chgrp to descend recursively
through its directory arguments, setting the specified
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 file operands. If a numeric group
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
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
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.
Unless the chgrp 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.
If the chgrp command is invoked with the -R 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. If the chgrp
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 proposals now apply to
staff. See chmod for details.
ENVIRONMENT VARIABLES [Toc] [Back]
The following environment variables affect the execution
of chgrp: Provides a default value for the internationalization
variables that are unset or null. If LANG 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 of LC_MESSAGES.
Contains group information.
Commands: chmod(1), chown(1), groups(1)
Functions: chmod(2), chown(2)
[ Back ]