-
Notifications
You must be signed in to change notification settings - Fork 0
/
chown.1.html
154 lines (154 loc) · 7.12 KB
/
chown.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
<!DOCTYPE html>
<html>
<!-- This is an automatically generated file. Do not edit.
DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
-->
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
<title>CHOWN(1)</title>
</head>
<body>
<table class="head">
<tr>
<td class="head-ltitle">CHOWN(1)</td>
<td class="head-vol">User Commands</td>
<td class="head-rtitle">CHOWN(1)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp">chown - change file owner and group</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><b>chown</b> [<i>OPTION</i>]...
[<i>OWNER</i>][<i>:</i>[<i>GROUP</i>]] <i>FILE</i>...
<br/>
<b>chown</b> [<i>OPTION</i>]... <i>--reference=RFILE FILE</i>...</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This manual page documents the GNU version of <b>chown</b>.
<b>chown</b> changes the user and/or group ownership of each given file. If
only an owner (a user name or numeric user ID) is given, that user is made
the owner of each given file, and the files' group is not changed. If the
owner is followed by a colon and a group name (or numeric group ID), with no
spaces between them, the group ownership of the files is changed as well. If
a colon but no group name follows the user name, that user is made the owner
of the files and the group of the files is changed to that user's login
group. If the colon and group are given, but the owner is omitted, only the
group of the files is changed; in this case, <b>chown</b> performs the same
function as <b>chgrp</b>. If only a colon is given, or if the entire operand
is empty, neither the owner nor the group is changed.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="OPTIONS"><a class="permalink" href="#OPTIONS">OPTIONS</a></h1>
<p class="Pp">Change the owner and/or group of each FILE to OWNER and/or GROUP.
With <b>--reference</b>, change the owner and group of each FILE to those of
RFILE.</p>
<dl class="Bl-tag">
<dt id="c"><a class="permalink" href="#c"><b>-c</b>, <b>--changes</b></a></dt>
<dd>like verbose but report only when a change is made</dd>
<dt id="f"><a class="permalink" href="#f"><b>-f</b>, <b>--silent</b>,
<b>--quiet</b></a></dt>
<dd>suppress most error messages</dd>
<dt id="v"><a class="permalink" href="#v"><b>-v</b>, <b>--verbose</b></a></dt>
<dd>output a diagnostic for every file processed</dd>
<dt id="dereference"><a class="permalink" href="#dereference"><b>--dereference</b></a></dt>
<dd>affect the referent of each symbolic link (this is the default), rather
than the symbolic link itself</dd>
<dt id="h"><a class="permalink" href="#h"><b>-h</b>,
<b>--no-dereference</b></a></dt>
<dd>affect symbolic links instead of any referenced file (useful only on
systems that can change the ownership of a symlink)</dd>
<dt id="from"><a class="permalink" href="#from"><b>--from</b>=<i>CURRENT_OWNER</i>:CURRENT_GROUP</a></dt>
<dd>change the ownership of each file only if its current owner and/or group
match those specified here. Either may be omitted, in which case a match
is not required for the omitted attribute</dd>
<dt id="no"><a class="permalink" href="#no"><b>--no-preserve-root</b></a></dt>
<dd>do not treat '/' specially (the default)</dd>
<dt id="preserve"><a class="permalink" href="#preserve"><b>--preserve-root</b></a></dt>
<dd>fail to operate recursively on '/'</dd>
<dt id="reference"><a class="permalink" href="#reference"><b>--reference</b>=<i>RFILE</i></a></dt>
<dd>use RFILE's ownership rather than specifying values RFILE is always
dereferenced if a symbolic link.</dd>
<dt id="R"><a class="permalink" href="#R"><b>-R</b>,
<b>--recursive</b></a></dt>
<dd>operate on files and directories recursively</dd>
</dl>
<p class="Pp">The following options modify how a hierarchy is traversed when the
<b>-R</b> option is also specified. If more than one is specified, only the
final one takes effect. '-P' is the default.</p>
<dl class="Bl-tag">
<dt id="H"><a class="permalink" href="#H"><b>-H</b></a></dt>
<dd>if a command line argument is a symbolic link to a directory, traverse
it</dd>
<dt id="L"><a class="permalink" href="#L"><b>-L</b></a></dt>
<dd>traverse every symbolic link to a directory encountered</dd>
<dt id="P"><a class="permalink" href="#P"><b>-P</b></a></dt>
<dd>do not traverse any symbolic links</dd>
<dt id="help"><a class="permalink" href="#help"><b>--help</b></a></dt>
<dd>display this help and exit</dd>
<dt id="version"><a class="permalink" href="#version"><b>--version</b></a></dt>
<dd>output version information and exit</dd>
</dl>
<p class="Pp">Owner is unchanged if missing. Group is unchanged if missing, but
changed to login group if implied by a ':' following a symbolic OWNER. OWNER
and GROUP may be numeric as well as symbolic.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<dl class="Bl-tag">
<dt id="chown"><a class="permalink" href="#chown">chown root /u</a></dt>
<dd>Change the owner of /u to "root".</dd>
<dt id="chown~2"><a class="permalink" href="#chown~2">chown root:staff
/u</a></dt>
<dd>Likewise, but also change its group to "staff".</dd>
<dt id="chown~3"><a class="permalink" href="#chown~3">chown -hR root
/u</a></dt>
<dd>Change the owner of /u and subfiles to "root".</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHOR"><a class="permalink" href="#AUTHOR">AUTHOR</a></h1>
<p class="Pp">Written by David MacKenzie and Jim Meyering.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="REPORTING_BUGS"><a class="permalink" href="#REPORTING_BUGS">REPORTING
BUGS</a></h1>
<p class="Pp">GNU coreutils online help:
<https://www.gnu.org/software/coreutils/>
<br/>
Report any translation bugs to
<https://translationproject.org/team/></p>
</section>
<section class="Sh">
<h1 class="Sh" id="COPYRIGHT"><a class="permalink" href="#COPYRIGHT">COPYRIGHT</a></h1>
<p class="Pp">Copyright © 2024 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
<br/>
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><b>chown</b>(2)</p>
<p class="Pp">Full documentation
<https://www.gnu.org/software/coreutils/chown>
<br/>
or available locally via: info '(coreutils) chown invocation'</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">March 2024</td>
<td class="foot-os">GNU coreutils 9.5</td>
</tr>
</table>
</body>
</html>