Debian Codegraph @

upstream/mageia-cauldron/man1/chgrp.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH CHGRP "1" "September 2025" "GNU coreutils 9.8" "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\-\-from\fR=\fI\,CURRENT_OWNER\/\fR:CURRENT_GROUP
36 change the ownership of each file only if
37 its current owner and/or group match those specified
38 here. Either may be omitted, in which case a match
39 is not required for the omitted attribute
40 .TP
41 \fB\-\-no\-preserve\-root\fR
42 do not treat '/' specially (the default)
43 .TP
44 \fB\-\-preserve\-root\fR
45 fail to operate recursively on '/'
46 .TP
47 \fB\-\-reference\fR=\fI\,RFILE\/\fR
48 use RFILE's ownership rather than specifying values.
49 RFILE is always dereferenced if a symbolic link.
50 .TP
51 \fB\-R\fR, \fB\-\-recursive\fR
52 operate on files and directories recursively
53 .PP
54 The following options modify how a hierarchy is traversed when the \fB\-R\fR
55 option is also specified. If more than one is specified, only the final
56 one takes effect. \fB\-P\fR is the default.
57 .TP
58 \fB\-H\fR
59 if a command line argument is a symbolic link
60 to a directory, traverse it
61 .TP
62 \fB\-L\fR
63 traverse every symbolic link to a directory
64 encountered
65 .TP
66 \fB\-P\fR
67 do not traverse any symbolic links
68 .TP
69 \fB\-\-help\fR
70 display this help and exit
71 .TP
72 \fB\-\-version\fR
73 output version information and exit
74 .SH EXAMPLES
75 .TP
76 chgrp staff /u
77 Change the group of /u to "staff".
78 .TP
79 chgrp \-hR staff /u
80 Change the group of /u and subfiles to "staff".
81 .SH AUTHOR
82 Written by David MacKenzie and Jim Meyering.
83 .SH "REPORTING BUGS"
84 Report bugs to: bug\[email protected]
85 .br
86 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
87 .br
88 General help using GNU software: <https://www.gnu.org/gethelp/>
89 .br
90 Report any translation bugs to <https://translationproject.org/team/>
91 .SH COPYRIGHT
92 Copyright \(co 2025 Free Software Foundation, Inc.
93 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
94 .br
95 This is free software: you are free to change and redistribute it.
96 There is NO WARRANTY, to the extent permitted by law.
97 .SH "SEE ALSO"
98 \fBchown\fP(1), \fBchown\fP(2)
99 .PP
100 .br
101 Full documentation <https://www.gnu.org/software/coreutils/chgrp>
102 .br
103 or available locally via: info \(aq(coreutils) chgrp invocation\(aq