summaryrefslogtreecommitdiffstats
path: root/man1/chgrp.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/chgrp.1')
-rw-r--r--man1/chgrp.1121
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.