rewritten from manual page; add Berkeley specific header
[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.\"
daf1690d 5.\" @(#)chown.8 6.3 (Berkeley) %G%
15102292 6.\"
567e801b 7.TH CHOWN 8 ""
15102292
KM
8.UC 4
9.SH NAME
94785de7 10chown \- change owner
15102292 11.SH SYNOPSIS
daf1690d 12.B chown
94785de7 13[
daf1690d 14.B \-Rf
94785de7 15]
567e801b 16owner[.group] file ...
15102292
KM
17.SH DESCRIPTION
18.I Chown
19changes the owner of the
20.I files
21to
22.IR owner .
23The owner may be either a decimal UID or
24a login name found in the password file.
567e801b
KM
25An optional group may also be specified.
26The group may be either a decimal GID or
27a group name found in the group-ID file.
15102292 28.PP
94785de7
KM
29Only the super-user can change owner,
30in order to simplify accounting procedures.
daf1690d 31No errors, except for usage errors, are reported when the
94785de7
KM
32.B \-f
33(force) option is given.
567e801b
KM
34.PP
35When the
36.B \-R
37option is given,
38.I chown
39recursively descends its directory arguments
40setting the specified owner.
2da69ef2
KM
41When symbolic links are encountered, their ownership is changed,
42but they are not traversed.
15102292 43.SH "SEE ALSO"
daf1690d 44chgrp(1), chown(2)