chgrp(1)						      General Commands Manual							  chgrp(1)

NAME

       chgrp - Changes the group ownership of a file or directory

SYNOPSIS

       chgrp [-fhR] group file

       The chgrp command changes the group associated with the specified file or directory to group.

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       chgrp:  XCU5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

OPTIONS

       [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 group ID.

OPERANDS

       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 be modified.

DESCRIPTION

       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.

       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.

NOTES

       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.

EXIT STATUS

       The following exit values are returned: Successful completion, all requested changes were made.	An error occurred.

EXAMPLES

       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

       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 vari-
       ables 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  for-
       mat  and  contents  of  diagnostic messages written to standard error.  Determines the location of message catalogues for the processing of
       LC_MESSAGES.

FILES

       Contains group information.

SEE ALSO

       Commands:  chmod(1), chown(1), groups(1)

       Functions:  chmod(2), chown(2)

       Files:  group(4)

       Standards:  standards(5)

																	  chgrp(1)