V6/usr/man/man2/chown.2
.th CHOWN II 12/15/74
.sh NAME
chown \*- change owner and group of a file
.sh SYNOPSIS
(chmod = 16.)
.br
.ft B
sys chown; name; owner
.s3
chown(name, owner)
.br
char *name;
.ft R
.sh DESCRIPTION
The file
whose name is given by the null-terminated string pointed
to by
.it name
has its owner and group changed to
the low and high bytes of
.it owner
respectively.
Only the super-user may
execute this call,
because if users were able to give files away,
they could defeat the (nonexistent)
file-space accounting procedures.
.sh "SEE ALSO"
chown (VIII), chgrp (VIII), passwd (V)
.sh DIAGNOSTICS
The error bit (c-bit) is set
on illegal owner changes.
From C a \*-1 returned value indicates error,
0 indicates success.