[src/trunk]: src/lib/librt Reference only aio(3) in SEE ALSO as it is the cen...

To: source-changes-hg%NetBSD.org@localhost
Subject: [src/trunk]: src/lib/librt Reference only aio(3) in SEE ALSO as it is the cen...
From: jruoho <jruoho%NetBSD.org@localhost>
Date: Mon, 06 Apr 2020 19:00:08 +0000
details:   https://anonhg.NetBSD.org/src/rev/ea9f510f1c93
branches:  trunk
changeset: 754957:ea9f510f1c93
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Mon May 17 19:22:31 2010 +0000

description:
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.

diffstat:

 lib/librt/aio.3         |   7 ++++---
 lib/librt/aio_cancel.3  |  12 ++++--------
 lib/librt/aio_error.3   |  10 +++-------
 lib/librt/aio_fsync.3   |   8 +++-----
 lib/librt/aio_read.3    |  10 +++-------
 lib/librt/aio_return.3  |   9 +++------
 lib/librt/aio_suspend.3 |  28 ++++++++++++++++------------
 lib/librt/aio_write.3   |   9 +++------
 lib/librt/lio_listio.3  |  10 ++++------
 9 files changed, 43 insertions(+), 60 deletions(-)

diffs (truncated from 319 to 300 lines):

diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio.3
--- a/lib/librt/aio.3   Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio.3   Mon May 17 19:22:31 2010 +0000
@@ -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 <jruohonen%iki.fi@localhost>
 .\" 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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_cancel.3
--- a/lib/librt/aio_cancel.3    Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_cancel.3    Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_error.3
--- a/lib/librt/aio_error.3     Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_error.3     Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_fsync.3
--- a/lib/librt/aio_fsync.3     Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_fsync.3     Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_read.3
--- a/lib/librt/aio_read.3      Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_read.3      Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_return.3
--- a/lib/librt/aio_return.3    Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_return.3    Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_suspend.3
--- a/lib/librt/aio_suspend.3   Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_suspend.3   Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/aio_write.3
--- a/lib/librt/aio_write.3     Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/aio_write.3     Mon May 17 19:22:31 2010 +0000
@@ -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
diff -r 23a7ba1ff54c -r ea9f510f1c93 lib/librt/lio_listio.3
--- a/lib/librt/lio_listio.3    Mon May 17 19:04:55 2010 +0000
+++ b/lib/librt/lio_listio.3    Mon May 17 19:22:31 2010 +0000
@@ -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 @@
Prev by Date: [src/trunk]: src/share/man/man9 Xref timeval(3).
Next by Date: [src/trunk]: src/share/man Briefly describe and note also struct bintime.
Previous by Thread: [src/trunk]: src/share/man/man9 Xref timeval(3).
Next by Thread: [src/trunk]: src/share/man Briefly describe and note also struct bintime.
Indexes:
Home | Main Index | Thread Index | Old Index