doc: clarify chgrp restrictions

* doc/coreutils.texi (chown invocation): Mention the system dependent
restrictions on setting groups.
(chgrp invocation): Likewise. Reference the 'chown' superset.
* man/chgrp.x: Cross reference chown(1) which is the superset interface,
and also chown(2) which gives details of the platform restrictions.
Fixes http://bugs.gnu.org/17495
This commit is contained in:
Pádraig Brady 2014-06-19 18:49:18 +01:00
parent 4f8d74eb1b
commit fd0a650403
2 changed files with 13 additions and 1 deletions

View File

@ -10525,6 +10525,13 @@ portable, and because it has undesirable results if the entire
@var{owner@samp{.}group} happens to identify a user whose name
contains @samp{.}.
@macro chownGroupRestrictions
It is system dependent whether a user can change the group to an arbitrary one,
or the more portable behavior of being restricted to setting a group of
which the user is a member.
@end macro
@chownGroupRestrictions
The @command{chown} command sometimes clears the set-user-ID or
set-group-ID permission bits. This behavior depends on the policy and
functionality of the underlying @code{chown} system call, which may
@ -10685,7 +10692,8 @@ chown -hR root /u
@command{chgrp} changes the group ownership of each given @var{file}
to @var{group} (which can be either a group name or a numeric group ID)
or to the group of an existing reference file. Synopsis:
or to the group of an existing reference file. @xref{chown invocation}.
Synopsis:
@example
chgrp [@var{option}]@dots{} @{@var{group} | --reference=@var{ref_file}@}@c
@ -10696,6 +10704,8 @@ If @var{group} is intended to represent a
numeric group ID, then you may specify it with a leading @samp{+}.
@xref{Disambiguating names and IDs}.
@chownGroupRestrictions
The program accepts the following options. Also see @ref{Common options}.
@table @samp

View File

@ -2,3 +2,5 @@
chgrp \- change group ownership
[DESCRIPTION]
.\" Add any additional description here
[SEE ALSO]
chown(1), chown(2)