Module Name: src
Committed By: wiz
Date: Sat Dec 1 20:53:10 UTC 2012
Modified Files:
src/lib/libc/sys: chown.2
Log Message:
Bump date. New sentence, new line. Wording/articles.
Sort errors while here.
To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/lib/libc/sys/chown.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/chown.2
diff -u src/lib/libc/sys/chown.2:1.33 src/lib/libc/sys/chown.2:1.34
--- src/lib/libc/sys/chown.2:1.33 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/chown.2 Sat Dec 1 20:53:10 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: chown.2,v 1.33 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: chown.2,v 1.34 2012/12/01 20:53:10 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)chown.2 8.4 (Berkeley) 4/19/94
.\"
-.Dd April 19, 1994
+.Dd November 18, 2012
.Dt CHOWN 2
.Os
.Sh NAME
@@ -115,18 +115,19 @@ is set in
.Fa flag )
except if
.Fa path
-is relative. In that case, it is looked up from a directory whose file
+is relative.
+In that case, it is looked up from a directory whose file
descriptor was passed as
.Fa fd .
Search permission is required on
.Fa fd
-except if that file descriptor was open with
+except if that file descriptor was opened with the
.Dv O_SEARCH
-option.
+flag.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
One of the owner or group id's
may be left unchanged by specifying it as (uid_t)\-1 or (gid_t)\-1 respectively.
@@ -141,8 +142,15 @@ and
.Fn lchown
will fail and the file will be unchanged if:
.Bl -tag -width Er
-.It Bq Er ENOTDIR
-A component of the path prefix is not a directory.
+.It Bq Er EACCES
+Search permission is denied for a component of the path prefix.
+.It Bq Er EFAULT
+.Fa path
+points outside the process's allocated address space.
+.It Bq Er EIO
+An I/O error occurred while reading from or writing to the file system.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the pathname.
.It Bq Er ENAMETOOLONG
A component of a pathname exceeded
.Brq Dv NAME_MAX
@@ -151,19 +159,12 @@ characters, or an entire path name excee
characters.
.It Bq Er ENOENT
The named file does not exist.
-.It Bq Er EACCES
-Search permission is denied for a component of the path prefix.
-.It Bq Er ELOOP
-Too many symbolic links were encountered in translating the pathname.
+.It Bq Er ENOTDIR
+A component of the path prefix is not a directory.
.It Bq Er EPERM
The effective user ID is not the super-user.
.It Bq Er EROFS
The named file resides on a read-only file system.
-.It Bq Er EFAULT
-.Fa path
-points outside the process's allocated address space.
-.It Bq Er EIO
-An I/O error occurred while reading from or writing to the file system.
.El
.Pp
.Fn fchown
@@ -175,12 +176,12 @@ does not refer to a valid descriptor.
.It Bq Er EINVAL
.Fa fd
refers to a socket, not a file.
+.It Bq Er EIO
+An I/O error occurred while reading from or writing to the file system.
.It Bq Er EPERM
The effective user ID is not the super-user.
.It Bq Er EROFS
The named file resides on a read-only file system.
-.It Bq Er EIO
-An I/O error occurred while reading from or writing to the file system.
.El
.Sh SEE ALSO
.Xr chgrp 1 ,
