manual/gnumaniak/original/man1/chgrp.1

   1 .\" Copyright Andries Brouwer, A. Wik 1998, Ragnar Hojland Espinosa 1998-2002
   2 .\"
   3 .\" This file may be copied under the conditions described
   4 .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
   5 .\" that should have been distributed together with this file.
   6 .\"
   7 .TH CHGRP 1 "18 June 2002" "GNU fileutils 4.1"
   8 .SH NAME
   9 chgrp \- change group ownership of files
  10 .SH SYNOPSIS
  11 .BI "chgrp [" options "] " "group file..."
  12 .sp
  13 POSIX options:
  14 .B [\-R]
  15 .sp
  16 GNU options (shortest form):
  17 .B [\-cfvR] [\-\-dereference] [\-\-reference=\fIfile\fB]
  18 .B "[\-\-help] [\-\-version] [\-\-]"
  19 .SH DESCRIPTION
  20 .B chgrp
  21 changes the group ownership of each given
  22 .I file
  23 to
  24 .I group,
  25 which can be either a group name, a numeric group ID, or an existing
  26 referenced file.
  27 .SH "POSIX OPTIONS"
  28 .TP
  29 .B \-R
  30 Recursively change the group ownership of directories and their contents.
  31 (And continue even when errors are encountered.)
  32 .SH "GNU OPTIONS"
  33 .TP
  34 .B "\-c, \-\-changes"
  35 Verbosely describe the action for each
  36 .I file
  37 whose group actually changes.
  38 .TP
  39 .B "\-\-dereference"
  40 Do not act on symlinks themselves but rather on what they point to.
  41 .TP
  42 .B "\-f, \-\-silent, \-\-quiet"
  43 Do not print error messages about files whose group cannot be changed.
  44 .TP
  45 .B "\-h, \-\-no\-dereference"
  46 Act on symlinks themselves instead of what they point to.  This is the
  47 default. If
  48 .B lchown(2)
  49 isn't available \fBchown\fR will fail.  If any symlinks
  50 are found during a recursive transversal and \fB\-\-verbose\fR hasn't
  51 been specified, no error message will be printed.
  52 .TP
  53 .B "\-v, \-\-verbose"
  54 Verbosely describe the action (or non-action) taken for every
  55 .IR file .
  56 .TP
  57 .B "\-R, \-\-recursive"
  58 Recursively change the group ownership of directories and their contents.
  59 .TP
  60 .B \-\-reference=\fIfile
  61 Change specified files and directories to the same group as \fIfile\fR.
  62 .SH "GNU STANDARD OPTIONS"
  63 .TP
  64 .B "\-\-help"
  65 Print a usage message on standard output and exit successfully.
  66 .TP
  67 .B "\-\-version"
  68 Print version information on standard output, then exit successfully.
  69 .TP
  70 .B "\-\-"
  71 Terminate option list.
  72 .SH ENVIRONMENT
  73 The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
  74 usual meaning.
  75 .SH "CONFORMING TO"
  76 POSIX 1003.2 only requires the \-R option. Use of other options
  77 may not be portable.
  78 .SH NOTES
  79 set-uid and set-gid is preserved even on systems where
  80 .BR chown(2)
  81 resets these bits.
  82
  83 This page describes
  84 .B chgrp
  85 as found in the fileutils-4.1 package;
  86 other versions may differ slightly. Mail corrections and additions to
  87 aeb@cwi.nl, aw@mail1.bet1.puv.fi and ragnar@ragnar-hojland.com
  88 Report bugs in the program to bug-fileutils@gnu.org.