date and time created 87/02/15 16:03:31 by lepreau
[unix-history] / usr / src / usr.sbin / chown / chown.8
CommitLineData
15102292
KM
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
2da69ef2 5.\" @(#)chown.8 6.2 (Berkeley) %G%
15102292 6.\"
567e801b 7.TH CHOWN 8 ""
15102292
KM
8.UC 4
9.SH NAME
94785de7 10chown \- change owner
15102292
KM
11.SH SYNOPSIS
12.B /etc/chown
94785de7
KM
13[
14.B \-f
567e801b 15.B \-R
94785de7 16]
567e801b 17owner[.group] file ...
15102292
KM
18.SH DESCRIPTION
19.I Chown
20changes the owner of the
21.I files
22to
23.IR owner .
24The owner may be either a decimal UID or
25a login name found in the password file.
567e801b
KM
26An optional group may also be specified.
27The group may be either a decimal GID or
28a group name found in the group-ID file.
15102292 29.PP
94785de7
KM
30Only the super-user can change owner,
31in order to simplify accounting procedures.
32No errors are reported when the
33.B \-f
34(force) option is given.
567e801b
KM
35.PP
36When the
37.B \-R
38option is given,
39.I chown
40recursively descends its directory arguments
41setting the specified owner.
2da69ef2
KM
42When symbolic links are encountered, their ownership is changed,
43but they are not traversed.
15102292
KM
44.SH FILES
45/etc/passwd
15102292 46.SH "SEE ALSO"
94785de7 47chgrp(1),
15102292
KM
48chown(2),
49passwd(5), group(5)