手册页部分 1：用户命令

chgrp(1)

名称

chgrp - 更改文件组所有权

用法概要

chgrp
 [-c | -changes] [--dereference
] [ -h | --no-dereference]
	[-f | --silent | --quiet] [
--help] [-R | --recursive]
	[--no-preserve-root] [--preserve-root] [
-v | --verbose] group file...

chgrp -R | --recursive
 [-c | -changes] [--dereference
]
	[ -h | --no-dereference] [-f | 
--silent | --quiet]
	[--help] [-H | -L | 
-P] [--no-preserve-root] [--preserve-root]
	[-v | --verbose] group file...

chgrp [-c | -changes
] [--dereference] [ -h | 
--no-dereference]
	[-f | --silent | --quiet] [
--help] [-R | --recursive] [
--preserve-root]
	[--no-preserve-root] [-v | --verbose
] 
	--reference=RFILE | -s groupsid file
...

chgrp -R | 
--recursive [-c | -changes] [
--dereference]
	[ -h | --no-dereference] [-f | 
--silent | --quiet]
	[--help] [-H | -L | 
-P] [--no-preserve-root] [--preserve-root]
	[-v | --verbose] --reference=RFILE
 | -s groupsid file...

描述

chgrp 实用程序可将由每个 file 操作数指定的文件的组 ID 设置为由 group 操作数指定的组 ID。

对于每个 file 操作数，它执行的操作等效于使用以下参数调用 chown(2) 函数：

• file 操作数将用作 path 参数。

• 文件的用户 ID 将用作 owner 参数。

• 指定的组 ID 将用作 group 参数。

除非 chgrp 由具有相应特权的进程调用，否则将在成功完成后清除正规文件的 set-user-ID 和 set-group-ID 位；可能会清除其他文件类型的 set-user-ID 和 set-group-ID 位。

操作系统带有一个配置选项 _POSIX_CHOWN_RESTRICTED ，用于限制所有权更改。如果启用了该选项，则文件的所有者只能将文件的组更改为所有者所属的组。只有超级用户可以任意更改所有者 ID，而不受是否启用该选项的限制。要设置该配置选项，请在 /etc/system 中添加以下行：

set rstchown = 1

要禁用该选项，请在 /etc/system 中添加以下行：

set rstchown = 0

缺省情况下，_POSIX_CHOWN_RESTRICTED 处于启用状态。请参见 system(5) 和 fpathconf(2)。

选项

usr/bin/chgrp 支持以下选项：

–c, –-changes

与 verbose (–v | –-verbose) 一样。仅在发生了更改时报告。

–f, –-silent, –-quiet

强制。不报告错误。

–h, –-no-dereference

如果文件是符号链接，该选项将更改符号链接的组。如果不使用该选项，将更改符号链接引用的文件的组。

–-help

显示用法消息然后退出。

–H

如果在命令行中指定的文件是符号链接且符号链接引用的文件类型是目录，则该选项将更改符号链接引用的目录的组，以及文件分层结构中该目录下方所有文件的组。如果遍历文件分层结构时遇到符号链接，则将更改目标文件的组，但是不执行递归。

–L

如果文件是符号链接，该选项将更改符号链接引用的文件的组。如果在命令行中指定的文件或者遍历文件分层结构时遇到的文件是符号链接且符号链接引用的文件类型是目录，则该选项将更改符号链接引用的目录的组，以及文件分层结构中该目录下方所有文件的组。

–-no-preserve-root

不会对 `/' 进行特殊处理。这是缺省值。

–-preserve-root

不以递归方式对 `/' 进行操作。

–P

如果在命令行中指定的文件或者遍历文件分层结构时遇到的文件是符号链接，该选项将更改符号链接的组。该选项不会跟随符号链接转至文件分层结构的其他任何部分。

–-reference=RFILE

使用 RFILE 的组名。如果 RFILE 不存在，则显示一条错误消息并返回非零退出代码。此选项与 –s 选项互斥。

–R, –-recursive

递归。chgrp 将在目录和所有子目录中向下延伸，在此过程中设置指定的组 ID。如果遇到符号链接，除非指定 –h 或 –P 选项，否则将更改目标文件的组。但是，除非指定 –H 或 –L 选项，否则不执行递归。

–s

指定的组为 Windows SID。该选项要求使用支持存储 SID 的文件系统，例如 ZFS。此选项与 –-reference 选项互斥。

–v, –-verbose

针对每个处理的文件提供诊断。

指定多个互斥选项 – H、–L 或 –P 不会视为错误。指定的最后一个选项将决定 chgrp 的行为。

/usr/xpg4/bin/chgrp 支持以下选项：

–f

强制。不报告错误。

–R

递归。chgrp 将在目录和所有子目录中向下延伸，在此过程中设置指定的组 ID。如果遇到符号链接，除非指定 –h 或 –P 选项，否则将更改目标文件的组。除非指定 –H、–L 或 –P 选项，否则 –L 选项将用作缺省模式。

–H

如果在命令行中指定的文件是符号链接且符号链接引用的文件类型是目录，则该选项将更改符号链接引用的目录的组，以及文件分层结构中该目录下方所有文件的组。如果遍历文件分层结构时遇到符号链接，则将更改目标文件的组，但是不执行递归。

–L

如果文件是符号链接，该选项将更改符号链接引用的文件的组。如果在命令行中指定的文件或者遍历文件分层结构时遇到的文件是符号链接且符号链接引用的文件类型是目录，则该选项将更改符号链接引用的目录的组，以及文件分层结构中该目录下方所有文件的组。

–P

如果在命令行中指定的文件或者遍历文件分层结构时遇到的文件是符号链接，该选项将更改符号链接的组。该选项不会跟随符号链接转至文件分层结构的其他任何部分。

–s

指定的组为 Windows SID。该选项要求使用支持存储 SID 的文件系统，例如 ZFS。

指定多个互斥选项 – H、–L 或 –P 不会视为错误。指定的最后一个选项将决定 chgrp 的行为。

操作数

支持下列操作数：

group

组数据库中的组名称或数字组 ID。两者均可指定要提供给由 file 操作数之一指定的每个文件的组 ID。如果组数据库中存在数字 group 操作数作为一个组名称，则与该组名称关联的组 ID 号将用作组 ID。

file

要修改其组 ID 的文件的路径名。

环境变量

有关影响 chgrp 执行的以下环境变量的说明，请参见 environ(7)：LANG、LC_ALL、LC_CTYPE、LC_MESSAGES 和 NLSPATH。

退出状态

将返回以下退出值：

0

实用程序成功执行，请求的所有更改都已执行。

>0

出现错误。

文件

/etc/group

组文件

属性

有关下列属性的说明，请参见 attributes(7)：

/usr/bin/chgrp

/usr/xpg4/bin/chgrp

另请参见

chmod(1)、chown(1)、chown(2)、fpathconf(2)、group(5)、passwd(5)、system(5)、attributes(7)、environ(7)、standards(7)、id(8)

附注

chgrp 已启用 CSI，但 group 名称除外。