2004-11-03 13:51:07 +00:00
|
|
|
.\" Copyright Andries Brouwer, 2000
|
|
|
|
.\"
|
|
|
|
.\" This file may be copied under the conditions described
|
|
|
|
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
|
|
|
|
.\" that should have been distributed together with this file.
|
|
|
|
.\"
|
|
|
|
.TH CHGRP 1 2000-08 "GNU fileutils 4.0"
|
|
|
|
.SH NAME
|
|
|
|
chgrp \- change group ownership of files
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.BI "chgrp [" options "] " "group file..."
|
|
|
|
.sp
|
|
|
|
POSIX options:
|
|
|
|
.B "[\-R] [\-\-]"
|
|
|
|
.sp
|
2006-08-03 13:57:13 +00:00
|
|
|
POSIX.1-2001 options:
|
2004-11-03 13:51:07 +00:00
|
|
|
.B [\-hHLPR]
|
|
|
|
.sp
|
|
|
|
GNU group denotation:
|
|
|
|
.BI [\-\-reference= rfile ]
|
|
|
|
.sp
|
|
|
|
GNU options (shortest form):
|
|
|
|
.B [\-cfvR]
|
|
|
|
.B "[\-\-help] [\-\-version] [\-\-]"
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B chgrp
|
|
|
|
changes the group ownership of each given
|
|
|
|
.I file
|
|
|
|
to
|
|
|
|
.IR group ,
|
|
|
|
which can be either a group name or a numeric group ID.
|
|
|
|
.SH "POSIX OPTIONS"
|
|
|
|
.TP
|
|
|
|
.B \-R
|
|
|
|
Recursively change the group ownership of directories and their contents.
|
|
|
|
(And continue even when errors are encountered.)
|
|
|
|
.TP
|
|
|
|
.B "\-\-"
|
|
|
|
Terminate option list.
|
|
|
|
.SH "AUSTIN DRAFT OPTIONS"
|
|
|
|
.TP
|
|
|
|
.B \-h
|
|
|
|
For each file operand given that is a symlink, change the group ownership
|
|
|
|
of the symlink itself, rather than the object it points to. If the system
|
|
|
|
does not support a group ownership for symlinks, do nothing for a symlink.
|
|
|
|
.TP
|
|
|
|
.BR \-H " (half-logical)"
|
|
|
|
(When given together with
|
|
|
|
.BR \-R .)
|
|
|
|
For each file operand given that is a symlink to a directory,
|
|
|
|
change the group ownership of the directory and all files in the
|
|
|
|
file hierarchy below it.
|
|
|
|
.TP
|
|
|
|
.BR \-L " (logical)"
|
|
|
|
(When given together with
|
|
|
|
.BR \-R .)
|
|
|
|
For each file, either command line operand or encountered during
|
|
|
|
the tree walk, that is a symlink to a directory,
|
|
|
|
change the group ownership of the directory and all files in the
|
|
|
|
file hierarchy below it.
|
|
|
|
.TP
|
|
|
|
.BR \-P " (physical)"
|
|
|
|
(When given together with
|
|
|
|
.BR \-R .)
|
|
|
|
For each file, either command line operand or encountered during
|
|
|
|
the tree walk, that is a symlink, change the group ownership
|
|
|
|
of the symlink itself, rather than the object it points to.
|
|
|
|
If the system does not support a group ownership for symlinks,
|
|
|
|
do nothing for a symlink. This is the default.
|
|
|
|
.TP
|
|
|
|
.BR \-R
|
|
|
|
Recursively change the group ownership of directories and their contents.
|
|
|
|
.SH "ADDITIONAL GNU DESCRIPTION"
|
|
|
|
A GNU extension (new in fileutils 4.0) allows one to use
|
|
|
|
.BI "\-\-reference=" "rfile"
|
|
|
|
as a group description: the same group as that of
|
|
|
|
.IR rfile .
|
|
|
|
.SH "GNU OPTIONS"
|
|
|
|
.TP
|
|
|
|
.B "\-c, \-\-changes"
|
|
|
|
Verbosely describe the action for each
|
|
|
|
.I file
|
|
|
|
whose group actually changes.
|
|
|
|
.TP
|
|
|
|
.B "\-f, \-\-silent, \-\-quiet"
|
|
|
|
Do not print error messages about files whose group cannot be changed.
|
|
|
|
.TP
|
|
|
|
.B "\-h, \-\-no\-dereference"
|
|
|
|
Act on symbolic links themselves instead of what they point to.
|
|
|
|
Only available if the
|
|
|
|
.B lchown
|
|
|
|
system call is provided.
|
|
|
|
.TP
|
|
|
|
.B "\-v, \-\-verbose"
|
|
|
|
Verbosely describe the action or non-action taken for every
|
|
|
|
.IR file .
|
|
|
|
.TP
|
|
|
|
.B "\-R, \-\-recursive"
|
|
|
|
Recursively change the group ownership of directories and their contents.
|
|
|
|
.SH "GNU STANDARD OPTIONS"
|
|
|
|
.TP
|
|
|
|
.B "\-\-help"
|
|
|
|
Print a usage message on standard output and exit successfully.
|
|
|
|
.TP
|
|
|
|
.B "\-\-version"
|
|
|
|
Print version information on standard output, then exit successfully.
|
|
|
|
.TP
|
|
|
|
.B "\-\-"
|
|
|
|
Terminate option list.
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
|
|
|
|
usual meaning. For an XSI-conforming system: NLSPATH has the
|
|
|
|
usual meaning.
|
|
|
|
.SH "CONFORMING TO"
|
2006-08-03 13:57:13 +00:00
|
|
|
POSIX.2 only requires the \-R option. Use of other options
|
2004-11-03 13:51:07 +00:00
|
|
|
may not be portable.
|
|
|
|
.SH NOTES
|
|
|
|
This page describes
|
|
|
|
.B chgrp
|
|
|
|
as found in the fileutils-4.0 package;
|
|
|
|
other versions may differ slightly.
|