~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/chgrp.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH CHGRP "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
chgrp \- change group ownership
5
 
.SH SYNOPSIS
6
 
.B chgrp
7
 
[\fIOPTION\fR]... \fIGROUP FILE\fR...
8
 
.br
9
 
.B chgrp
10
 
[\fIOPTION\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=\fIRFILE\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 \fB\-hR\fR 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
 
Report chgrp bugs to bug\-coreutils@gnu.org
79
 
.br
80
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
81
 
.br
82
 
General help using GNU software: <http://www.gnu.org/gethelp/>
83
 
.br
84
 
Report chgrp translation bugs to <http://translationproject.org/team/>
85
 
.SH COPYRIGHT
86
 
Copyright \(co 2012 Free Software Foundation, Inc.
87
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
88
 
.br
89
 
This is free software: you are free to change and redistribute it.
90
 
There is NO WARRANTY, to the extent permitted by law.
91
 
.SH "SEE ALSO"
92
 
The full documentation for
93
 
.B chgrp
94
 
is maintained as a Texinfo manual.  If the
95
 
.B info
96
 
and
97
 
.B chgrp
98
 
programs are properly installed at your site, the command
99
 
.IP
100
 
.B info coreutils \(aqchgrp invocation\(aq
101
 
.PP
102
 
should give you access to the complete manual.