unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



chgrp(1)							     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 indus-
  try standards	and associated tags.

OPTIONS

  -f  [Tru64 UNIX]  Suppresses all error reporting.

  -h  [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.

  -R  Causes chgrp to descend recursively through its directory	arguments,
      setting the specified group ID.

OPERANDS

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

  file
      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

   1.  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 hierar-
       chy.

   2.  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:

  0   Successful completion, all requested changes were	made.

  >>0  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:

  LANG
      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.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.



FILES

  /etc/group
      Contains group information.

SEE ALSO

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

  Functions:  chmod(2),	chown(2)

  Files:  group(4)

  Standards:  standards(5)