original/man1/chgrp.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH CHGRP "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 chgrp \- change group ownership
   5 .SH SYNOPSIS
   6 .B chgrp
   7 [\fI\,OPTION\/\fR]... \fI\,GROUP FILE\/\fR...
   8 .br
   9 .B chgrp
  10 [\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\fR...
  11 .SH DESCRIPTION
  12 .\" Add any additional description here
  13 .PP
  14 Change the group of each FILE to GROUP.
  15 With \fB\-\-reference\fR, change the group of each FILE to that of RFILE.
  16 .TP
  17 \fB\-c\fR, \fB\-\-changes\fR
  18 like verbose but report only when a change is made
  19 .TP
  20 \fB\-f\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR
  21 suppress most error messages
  22 .TP
  23 \fB\-v\fR, \fB\-\-verbose\fR
  24 output a diagnostic for every file processed
  25 .TP
  26 \fB\-\-dereference\fR
  27 affect the referent of each symbolic link (this is
  28 the default), rather than the symbolic link itself
  29 .TP
  30 \fB\-h\fR, \fB\-\-no\-dereference\fR
  31 affect symbolic links instead of any referenced file
  32 (useful only on systems that can change the
  33 ownership of a symlink)
  34 .TP
  35 \fB\-\-no\-preserve\-root\fR
  36 do not treat '/' specially (the default)
  37 .TP
  38 \fB\-\-preserve\-root\fR
  39 fail to operate recursively on '/'
  40 .TP
  41 \fB\-\-reference\fR=\fI\,RFILE\/\fR
  42 use RFILE's group rather than specifying a
  43 GROUP value
  44 .TP
  45 \fB\-R\fR, \fB\-\-recursive\fR
  46 operate on files and directories recursively
  47 .PP
  48 The following options modify how a hierarchy is traversed when the \fB\-R\fR
  49 option is also specified.  If more than one is specified, only the final
  50 one takes effect.
  51 .TP
  52 \fB\-H\fR
  53 if a command line argument is a symbolic link
  54 to a directory, traverse it
  55 .TP
  56 \fB\-L\fR
  57 traverse every symbolic link to a directory
  58 encountered
  59 .TP
  60 \fB\-P\fR
  61 do not traverse any symbolic links (default)
  62 .TP
  63 \fB\-\-help\fR
  64 display this help and exit
  65 .TP
  66 \fB\-\-version\fR
  67 output version information and exit
  68 .SH EXAMPLES
  69 .TP
  70 chgrp staff /u
  71 Change the group of /u to "staff".
  72 .TP
  73 chgrp \-hR staff /u
  74 Change the group of /u and subfiles to "staff".
  75 .SH AUTHOR
  76 Written by David MacKenzie and Jim Meyering.
  77 .SH "REPORTING BUGS"
  78 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  79 .br
  80 Report chgrp translation bugs to <http://translationproject.org/team/>
  81 .SH COPYRIGHT
  82 Copyright \(co 2016 Free Software Foundation, Inc.
  83 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  84 .br
  85 This is free software: you are free to change and redistribute it.
  86 There is NO WARRANTY, to the extent permitted by law.
  87 .SH "SEE ALSO"
  88 chown(1), chown(2)
  89 .PP
  90 .br
  91 Full documentation at: <http://www.gnu.org/software/coreutils/chgrp>
  92 .br
  93 or available locally via: info \(aq(coreutils) chgrp invocation\(aq