Module Name: src
Committed By: jruoho
Date: Mon May 17 19:22:31 UTC 2010
Modified Files:
src/lib/librt: aio.3 aio_cancel.3 aio_error.3 aio_fsync.3 aio_read.3
aio_return.3 aio_suspend.3 aio_write.3 lio_listio.3
Log Message:
Reference only aio(3) in SEE ALSO as it is the central placeholder. Note
timespec(3). Markup: -width Er (not -width Dv), .Dv NULL (not null), etc.
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/lib/librt/aio.3 src/lib/librt/aio_cancel.3 \
src/lib/librt/aio_error.3 src/lib/librt/aio_read.3 \
src/lib/librt/aio_return.3 src/lib/librt/aio_suspend.3 \
src/lib/librt/aio_write.3
cvs rdiff -u -r1.5 -r1.6 src/lib/librt/aio_fsync.3
cvs rdiff -u -r1.2 -r1.3 src/lib/librt/lio_listio.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/librt/aio.3
diff -u src/lib/librt/aio.3:1.3 src/lib/librt/aio.3:1.4
--- src/lib/librt/aio.3:1.3 Mon May 17 19:04:55 2010
+++ src/lib/librt/aio.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio.3,v 1.3 2010/05/17 19:04:55 jruoho Exp $ $
+.\" $NetBSD: aio.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $ $
.\"
.\" Copyright (c) 2010 Jukka Ruohonen <jruoho...@iki.fi>
.\" All rights reserved.
@@ -220,9 +220,10 @@
must be used to determine the status of the operation and to determine
any error conditions.
This includes the conditions reported by the standard
-.Xr read 2
+.Xr read 2 ,
+.Xr write 2 ,
and
-.Xr write 2 .
+.Xr fsync 2 .
The request remains enqueued and consumes process and
system resources until
.Fn aio_return
Index: src/lib/librt/aio_cancel.3
diff -u src/lib/librt/aio_cancel.3:1.3 src/lib/librt/aio_cancel.3:1.4
--- src/lib/librt/aio_cancel.3:1.3 Tue Aug 7 20:45:03 2007
+++ src/lib/librt/aio_cancel.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_cancel.3,v 1.3 2007/08/07 20:45:03 wiz Exp $
+.\" $NetBSD: aio_cancel.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1999 Softweyr LLC.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_cancel.2,v 1.22 2003/01/13 10:37:11 tjr Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_CANCEL 3
.Os
.Sh NAME
@@ -64,7 +64,7 @@
The
.Fn aio_cancel
system call returns \-1 to indicate an error, or one of the following:
-.Bl -tag -width Dv
+.Bl -tag -width Er
.It Bq Dv AIO_CANCELED
All outstanding requests meeting the criteria specified were cancelled.
.It Bq Dv AIO_NOTCANCELED
@@ -85,11 +85,7 @@
argument is an invalid file descriptor.
.El
.Sh SEE ALSO
-.Xr aio_error 3 ,
-.Xr aio_read 3 ,
-.Xr aio_return 3 ,
-.Xr aio_suspend 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_cancel
Index: src/lib/librt/aio_error.3
diff -u src/lib/librt/aio_error.3:1.3 src/lib/librt/aio_error.3:1.4
--- src/lib/librt/aio_error.3:1.3 Tue Aug 7 20:45:03 2007
+++ src/lib/librt/aio_error.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_error.3,v 1.3 2007/08/07 20:45:03 wiz Exp $
+.\" $NetBSD: aio_error.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1999 Softweyr LLC.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_error.2,v 1.20 2006/09/26 09:47:46 vd Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_ERROR 3
.Os
.Sh NAME
@@ -77,11 +77,7 @@
.Xr fsync 2 ,
.Xr read 2 ,
.Xr write 2 ,
-.Xr aio_cancel 3 ,
-.Xr aio_read 3 ,
-.Xr aio_return 3 ,
-.Xr aio_suspend 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_error
Index: src/lib/librt/aio_read.3
diff -u src/lib/librt/aio_read.3:1.3 src/lib/librt/aio_read.3:1.4
--- src/lib/librt/aio_read.3:1.3 Tue Aug 7 20:45:04 2007
+++ src/lib/librt/aio_read.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_read.3,v 1.3 2007/08/07 20:45:04 wiz Exp $
+.\" $NetBSD: aio_read.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1998 Terry Lambert
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_read.2,v 1.23 2005/12/13 13:43:35 davidxu Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_READ 3
.Os
.Sh NAME
@@ -187,11 +187,7 @@
.El
.Sh SEE ALSO
.Xr siginfo 2 ,
-.Xr aio_cancel 3 ,
-.Xr aio_error 3 ,
-.Xr aio_return 3 ,
-.Xr aio_suspend 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_read
Index: src/lib/librt/aio_return.3
diff -u src/lib/librt/aio_return.3:1.3 src/lib/librt/aio_return.3:1.4
--- src/lib/librt/aio_return.3:1.3 Tue Aug 7 20:45:04 2007
+++ src/lib/librt/aio_return.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_return.3,v 1.3 2007/08/07 20:45:04 wiz Exp $
+.\" $NetBSD: aio_return.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1999 Softweyr LLC.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_return.2,v 1.19 2006/10/07 10:49:20 trhodes Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_RETURN 3
.Os
.Sh NAME
@@ -80,10 +80,7 @@
.Xr fsync 2 ,
.Xr read 2 ,
.Xr write 2 ,
-.Xr aio_cancel 3 ,
-.Xr aio_error 3 ,
-.Xr aio_suspend 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_return
Index: src/lib/librt/aio_suspend.3
diff -u src/lib/librt/aio_suspend.3:1.3 src/lib/librt/aio_suspend.3:1.4
--- src/lib/librt/aio_suspend.3:1.3 Tue Aug 7 20:45:04 2007
+++ src/lib/librt/aio_suspend.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_suspend.3,v 1.3 2007/08/07 20:45:04 wiz Exp $
+.\" $NetBSD: aio_suspend.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1999 Softweyr LLC.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_suspend.2,v 1.22 2004/12/23 23:45:25 keramida Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_SUSPEND 3
.Os
.Sh NAME
@@ -44,7 +44,9 @@
system call suspends the calling process until at least one of the
specified asynchronous I/O requests have completed, a signal is
delivered, or the
-.Fa timeout
+.Fa struct timeout
+(see
+.Xr timespec 3 )
has passed.
.Pp
The
@@ -54,16 +56,20 @@
.Fa nent
pointers to asynchronous I/O requests.
Array members containing
-null pointers will be silently ignored.
+.Dv NULL
+pointers will be silently ignored.
.Pp
If
.Fa timeout
-is not a null pointer, it specifies a maximum interval to suspend.
+is not a
+.Dv NULL
+pointer, it specifies a maximum interval to suspend.
If
.Fa timeout
-is a null pointer, the suspend blocks indefinitely.
-To effect a
-poll, the
+is a
+.DV NULL
+pointer, the suspend blocks indefinitely.
+To effect a poll, the
.Fa timeout
should point to a zero-value timespec structure.
.Sh RETURN VALUES
@@ -95,10 +101,8 @@
valid.
.El
.Sh SEE ALSO
-.Xr aio_cancel 3 ,
-.Xr aio_error 3 ,
-.Xr aio_return 3 ,
-.Xr aio_write 3
+.Xr aio 3 ,
+.Xr timespec 3
.Sh STANDARDS
The
.Fn aio_suspend
Index: src/lib/librt/aio_write.3
diff -u src/lib/librt/aio_write.3:1.3 src/lib/librt/aio_write.3:1.4
--- src/lib/librt/aio_write.3:1.3 Tue Aug 7 20:45:04 2007
+++ src/lib/librt/aio_write.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_write.3,v 1.3 2007/08/07 20:45:04 wiz Exp $
+.\" $NetBSD: aio_write.3,v 1.4 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 1999 Softweyr LLC.
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/aio_write.2,v 1.20 2005/12/13 13:43:35 davidxu Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt AIO_WRITE 3
.Os
.Sh NAME
@@ -181,10 +181,7 @@
.El
.Sh SEE ALSO
.Xr siginfo 2 ,
-.Xr aio_cancel 3 ,
-.Xr aio_error 3 ,
-.Xr aio_return 3 ,
-.Xr aio_suspend 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_write
Index: src/lib/librt/aio_fsync.3
diff -u src/lib/librt/aio_fsync.3:1.5 src/lib/librt/aio_fsync.3:1.6
--- src/lib/librt/aio_fsync.3:1.5 Wed May 13 12:56:05 2009
+++ src/lib/librt/aio_fsync.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: aio_fsync.3,v 1.5 2009/05/13 12:56:05 wiz Exp $
+.\" $NetBSD: aio_fsync.3,v 1.6 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd June 17, 2007
+.Dd May 17, 2010
.Dt AIO_FSYNC 3
.Os
.Sh NAME
@@ -136,9 +136,7 @@
.Xr fcntl 2 ,
.Xr fdatasync 2 ,
.Xr fsync 2 ,
-.Xr aio_error 3 ,
-.Xr aio_read 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn aio_fsync
Index: src/lib/librt/lio_listio.3
diff -u src/lib/librt/lio_listio.3:1.2 src/lib/librt/lio_listio.3:1.3
--- src/lib/librt/lio_listio.3:1.2 Tue Aug 7 20:45:04 2007
+++ src/lib/librt/lio_listio.3 Mon May 17 19:22:31 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: lio_listio.3,v 1.2 2007/08/07 20:45:04 wiz Exp $
+.\" $NetBSD: lio_listio.3,v 1.3 2010/05/17 19:22:31 jruoho Exp $
.\"
.\" Copyright (c) 2003 Tim J. Robbins
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/sys/lio_listio.2,v 1.6 2006/10/07 05:13:32 trhodes Exp $
.\"
-.Dd May 4, 2007
+.Dd May 17, 2010
.Dt LIO_LISTIO 3
.Os
.Sh NAME
@@ -64,7 +64,7 @@
.Vt aiocb
specifies the operation to be performed.
The following operations are supported:
-.Bl -tag -width ".Dv LIO_WRITE"
+.Bl -tag -width ".Dv LIO_WRITE" -offset indent
.It Dv LIO_READ
Read data as if by a call to
.Xr aio_read 3 .
@@ -164,9 +164,7 @@
.Xr read 2 ,
.Xr siginfo 2 ,
.Xr write 2 ,
-.Xr aio_error 3 ,
-.Xr aio_read 3 ,
-.Xr aio_write 3
+.Xr aio 3
.Sh STANDARDS
The
.Fn lio_listio
