Module Name: src
Committed By: wiz
Date: Sat Dec 1 21:07:01 UTC 2012
Modified Files:
src/lib/libc/sys: chmod.2 mkfifo.2 mknod.2 open.2 rename.2 stat.2
symlink.2 unlink.2 utimes.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.43 -r1.44 src/lib/libc/sys/chmod.2
cvs rdiff -u -r1.23 -r1.24 src/lib/libc/sys/mkfifo.2 \
src/lib/libc/sys/symlink.2
cvs rdiff -u -r1.24 -r1.25 src/lib/libc/sys/mknod.2
cvs rdiff -u -r1.53 -r1.54 src/lib/libc/sys/open.2
cvs rdiff -u -r1.25 -r1.26 src/lib/libc/sys/rename.2 \
src/lib/libc/sys/unlink.2
cvs rdiff -u -r1.52 -r1.53 src/lib/libc/sys/stat.2
cvs rdiff -u -r1.34 -r1.35 src/lib/libc/sys/utimes.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/chmod.2
diff -u src/lib/libc/sys/chmod.2:1.43 src/lib/libc/sys/chmod.2:1.44
--- src/lib/libc/sys/chmod.2:1.43 Sat Dec 1 20:51:29 2012
+++ src/lib/libc/sys/chmod.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: chmod.2,v 1.43 2012/12/01 20:51:29 wiz Exp $
+.\" $NetBSD: chmod.2,v 1.44 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -98,7 +98,7 @@ flag.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
.Fn chmod
verifies that the process owner (user) either owns
Index: src/lib/libc/sys/mkfifo.2
diff -u src/lib/libc/sys/mkfifo.2:1.23 src/lib/libc/sys/mkfifo.2:1.24
--- src/lib/libc/sys/mkfifo.2:1.23 Sat Dec 1 20:57:41 2012
+++ src/lib/libc/sys/mkfifo.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: mkfifo.2,v 1.23 2012/12/01 20:57:41 wiz Exp $
+.\" $NetBSD: mkfifo.2,v 1.24 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -72,7 +72,7 @@ flag.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
The fifo's owner ID is set to the process's effective user ID.
The fifo's group ID is set to that of the parent directory in
Index: src/lib/libc/sys/symlink.2
diff -u src/lib/libc/sys/symlink.2:1.23 src/lib/libc/sys/symlink.2:1.24
--- src/lib/libc/sys/symlink.2:1.23 Sat Dec 1 21:00:18 2012
+++ src/lib/libc/sys/symlink.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: symlink.2,v 1.23 2012/12/01 21:00:18 wiz Exp $
+.\" $NetBSD: symlink.2,v 1.24 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -75,7 +75,7 @@ flag.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Sh RETURN VALUES
Upon successful completion, a zero value is returned.
If an error occurs, the error code is stored in
Index: src/lib/libc/sys/mknod.2
diff -u src/lib/libc/sys/mknod.2:1.24 src/lib/libc/sys/mknod.2:1.25
--- src/lib/libc/sys/mknod.2:1.24 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/mknod.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: mknod.2,v 1.24 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: mknod.2,v 1.25 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)mknod.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd July 3, 2011
+.Dd November 18, 2012
.Dt MKNOD 2
.Os
.Sh NAME
@@ -63,18 +63,19 @@ works the same way as
.Fn mknod
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.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
.Fn mknod
requires super-user privileges.
Index: src/lib/libc/sys/open.2
diff -u src/lib/libc/sys/open.2:1.53 src/lib/libc/sys/open.2:1.54
--- src/lib/libc/sys/open.2:1.53 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/open.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: open.2,v 1.53 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: open.2,v 1.54 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)open.2 8.2 (Berkeley) 11/16/93
.\"
-.Dd January 23, 2012
+.Dd November 18, 2012
.Dt OPEN 2
.Os
.Sh NAME
@@ -58,18 +58,19 @@ works the same way as
.Fn open
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.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
The
.Fa flags
@@ -187,7 +188,7 @@ signal to be sent to the process group
when I/O is possible, e.g.,
upon availability of data to be read.
.It Dv O_SEARCH
-If opening a directory, search permission check will not be performed on
+If opening a directory, search permission checks will not be performed on
subsequent usage of the file descriptor for looking up relative paths by
.Xr faccessat 2 ,
.Xr fchmodat 2 ,
@@ -438,7 +439,7 @@ are extensions defined in
.St -p1003.1b-93 .
.Dv O_SEARCH
is defined in
-.St -p1003.1-2008
+.St -p1003.1-2008 .
.Pp
The
.Dv O_SHLOCK
Index: src/lib/libc/sys/rename.2
diff -u src/lib/libc/sys/rename.2:1.25 src/lib/libc/sys/rename.2:1.26
--- src/lib/libc/sys/rename.2:1.25 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/rename.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: rename.2,v 1.25 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: rename.2,v 1.26 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)rename.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd December 27, 2005
+.Dd November 18, 2012
.Dt RENAME 2
.Os
.Sh NAME
@@ -87,14 +87,15 @@ except if
.Fa from
(resp.
.Fa to )
-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 fromfd
(resp.
.Fa tofd ).
Search permission is required on
passed directory file descriptors
-except if they were open with the
+except if they were opened with the
.Dv O_SEARCH
option.
.Fa fromfd
@@ -102,7 +103,7 @@ or
.Fa tofd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Sh RETURN VALUES
A 0 value is returned if the operation succeeds, otherwise
.Fn rename
Index: src/lib/libc/sys/unlink.2
diff -u src/lib/libc/sys/unlink.2:1.25 src/lib/libc/sys/unlink.2:1.26
--- src/lib/libc/sys/unlink.2:1.25 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/unlink.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: unlink.2,v 1.25 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: unlink.2,v 1.26 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)unlink.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd April 3, 2010
+.Dd November 18, 2012
.Dt UNLINK 2
.Os
.Sh NAME
@@ -66,18 +66,19 @@ works the same way as
.Fn unlink
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.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
.Fn unlinkat
will remove directories just like
Index: src/lib/libc/sys/stat.2
diff -u src/lib/libc/sys/stat.2:1.52 src/lib/libc/sys/stat.2:1.53
--- src/lib/libc/sys/stat.2:1.52 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/stat.2 Sat Dec 1 21:07:00 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: stat.2,v 1.52 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: stat.2,v 1.53 2012/12/01 21:07:00 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)stat.2 8.4 (Berkeley) 5/1/95
.\"
-.Dd September 14, 2011
+.Dd November 18, 2012
.Dt STAT 2
.Os
.Sh NAME
@@ -87,18 +87,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.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
The
.Fa sb
@@ -376,7 +377,6 @@ conform to
.Fn fstatat
conforms to
.St -p1003.1-2008 .
-
.Sh HISTORY
A
.Fn stat
Index: src/lib/libc/sys/utimes.2
diff -u src/lib/libc/sys/utimes.2:1.34 src/lib/libc/sys/utimes.2:1.35
--- src/lib/libc/sys/utimes.2:1.34 Sat Dec 1 20:45:01 2012
+++ src/lib/libc/sys/utimes.2 Sat Dec 1 21:07:01 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: utimes.2,v 1.34 2012/12/01 20:45:01 wiz Exp $
+.\" $NetBSD: utimes.2,v 1.35 2012/12/01 21:07:01 wiz Exp $
.\"
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" @(#)utimes.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd November 3, 2012
+.Dd November 18, 2012
.Dt UTIMES 2
.Os
.Sh NAME
@@ -57,7 +57,7 @@
.Fn futimes "int fd" "const struct timeval times[2]"
.Ft int
.Fn futimens "int fd" "const struct timespec times[2]"
-.In fcntl
+.In fcntl.h
.Ft int
.Fn utimensat "int fd" "const char *path" "const struct timespec times[2]" \
"int flag"
@@ -125,18 +125,19 @@ works the same way as
.Fn utimens
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.
.Fa fd
can be set to
.Dv AT_FDCWD
-in order to specify current directory.
+in order to specify the current directory.
.Pp
When it operates on a symbolic link,
.Fn utimensat
