summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/chown.2
diff options
context:
space:
mode:
authorkeramida <keramida@FreeBSD.org>2002-07-15 20:59:12 +0000
committerkeramida <keramida@FreeBSD.org>2002-07-15 20:59:12 +0000
commit5bd8884c66002f4da091ba3fdf9309e79aae1d86 (patch)
tree0740bbdd50b4e24e3b8d60b613944f1de59b7db7 /lib/libc/sys/chown.2
parent5777e081fa3c49e12058a541a71c4950aa3e5d21 (diff)
downloadFreeBSD-src-5bd8884c66002f4da091ba3fdf9309e79aae1d86.zip
FreeBSD-src-5bd8884c66002f4da091ba3fdf9309e79aae1d86.tar.gz
The .Fn function.
Diffstat (limited to 'lib/libc/sys/chown.2')
-rw-r--r--lib/libc/sys/chown.221
1 files changed, 14 insertions, 7 deletions
diff --git a/lib/libc/sys/chown.2 b/lib/libc/sys/chown.2
index dc1d067..7ea3449 100644
--- a/lib/libc/sys/chown.2
+++ b/lib/libc/sys/chown.2
@@ -68,7 +68,9 @@ but the change
.Fa owner
capability is restricted to the super-user.
.Pp
-.Fn Chown
+The
+.Fn chown
+function
clears the set-user-id and set-group-id bits
on the file
to prevent accidental or mischievous creation of
@@ -78,13 +80,16 @@ by the super-user.
follows symbolic links to operate on the target of the link
rather than the link itself.
.Pp
-.Fn Fchown
+The
+.Fn fchown
+function
is particularly useful when used in conjunction
with the file locking primitives (see
.Xr flock 2 ) .
.Pp
-.Fn Lchown
-is similar to
+The
+.Fn lchown
+function is similar to
.Fn chown
but does not follow symbolic links.
.Pp
@@ -93,7 +98,8 @@ may be left unchanged by specifying it as -1.
.Sh RETURN VALUES
.Rv -std
.Sh ERRORS
-.Fn Chown
+The
+.Fn chown
and
.Fn lchown
will fail and the file will be unchanged if:
@@ -120,8 +126,9 @@ points outside the process's allocated address space.
An I/O error occurred while reading from or writing to the file system.
.El
.Pp
-.Fn Fchown
-will fail if:
+The
+.Fn fchown
+function will fail if:
.Bl -tag -width Er
.It Bq Er EBADF
.Fa fd
OpenPOWER on IntegriCloud