Debian Codegraph @

upstream/fedora-44/man1/chgrp.1

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