diff options
Diffstat (limited to 'man1/chgrp.1')
-rw-r--r-- | man1/chgrp.1 | 121 |
1 files changed, 121 insertions, 0 deletions
diff --git a/man1/chgrp.1 b/man1/chgrp.1 new file mode 100644 index 000000000..131eedb61 --- /dev/null +++ b/man1/chgrp.1 @@ -0,0 +1,121 @@ +.\" 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 +POSIX 1003.1-2001 options: +.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" +POSIX 1003.2 only requires the \-R option. Use of other options +may not be portable. +.SH NOTES +This page describes +.B chgrp +as found in the fileutils-4.0 package; +other versions may differ slightly. |