From owner-cvs-all Thu Oct 24 9:23:54 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6CFFE37B401; Thu, 24 Oct 2002 09:23:48 -0700 (PDT) Received: from dibbler.ne.client2.attbi.com (dibbler.ne.client2.attbi.com [24.61.41.247]) by mx1.FreeBSD.org (Postfix) with ESMTP id A621043E6A; Thu, 24 Oct 2002 09:23:47 -0700 (PDT) (envelope-from rodrigc@attbi.com) Received: from dibbler.ne.client2.attbi.com (localhost.ne.attbi.com [127.0.0.1]) by dibbler.ne.client2.attbi.com (8.12.6/8.12.5) with ESMTP id g9OGNvRD033493; Thu, 24 Oct 2002 12:23:57 -0400 (EDT) (envelope-from rodrigc@dibbler.ne.client2.attbi.com) Received: (from rodrigc@localhost) by dibbler.ne.client2.attbi.com (8.12.6/8.12.6/Submit) id g9OGNvPP033492; Thu, 24 Oct 2002 12:23:57 -0400 (EDT) Date: Thu, 24 Oct 2002 12:23:57 -0400 From: Craig Rodrigues To: cvs-commiters@freebsd.org Cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/lib/libc/sys aio_cancel.2 aio_error.2 aio_read.2 aio_return.2 aio_suspend.2 aio_waitcomplete.2 aio_write.2 Message-ID: <20021024122357.A33457@attbi.com> References: <200210221612.g9MGCR1p012070@repoman.freebsd.org> <20021022161820.GA57732@starjuice.net> <20021022164649.GS91539@elvis.mu.org> <20021022132829.A22126@attbi.com> <20021023110619.A27272@attbi.com> <200210231814.g9NIE3to097645@khavrinen.lcs.mit.edu> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="2fHTh5uZTiUOsy+g" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <200210231814.g9NIE3to097645@khavrinen.lcs.mit.edu>; from wollman@lcs.mit.edu on Wed, Oct 23, 2002 at 02:14:03PM -0400 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --2fHTh5uZTiUOsy+g Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Wed, Oct 23, 2002 at 06:48:19PM +0200, Philippe Charnier wrote: > Salut, > > Craig Rodrigues wrote: > > > .Sh SEE ALSO > >+.Xr aio 4, > > .Xr aio_error 2 , > > .Xr aio_read 2 , > > .Xr aio_return 2 , > > I think Xr references should be ordered by section number first and by > alphabetical order after. OK, here is an updated patch, plus incorporation of the text submitted by Garrett. Is it OK? -- Craig Rodrigues http://www.gis.net/~craigr rodrigc@attbi.com --2fHTh5uZTiUOsy+g Content-Type: text/x-patch; charset=us-ascii Content-Disposition: attachment; filename="aio.diff" --- /dev/null Thu Oct 24 12:11:00 2002 +++ aio.4 Thu Oct 24 12:15:48 2002 @@ -0,0 +1,121 @@ +.\" +.\" $FreeBSD$ +.\" +.Dd October 23, 2002 +.Dt AIO 4 +.Os +.Sh NAME +.Nm aio +.Nd asynchronous I/O +.Sh SYNOPSIS +.Cd "options VFS_AIO" +.Sh DESCRIPTION +The +.Nm +kernel module provides system calls for asynchronous I/O. +.El +.Sh KERNEL OPTIONS +The following kernel configuration option +(see +.Xr config 8 ) +is required: +.Pp +.Dl "options VFS_AIO" +.Pp +If you do not want AIO support included in the kernel, but +want to use it occasionally, do not add the +.Dv VFS_AIO +option. Instead, load the +.Nm aio +module as desired: +.Pp +.Dl kldload aio +.Pp +.Sh APPLICATION USAGE +Asynchronous I/O is specified as an option in +.St -p1003.1-2001 +and earlier standards. +A portable application must be prepared for the possibility that +asynchronous I/O may not be available, +and also that it may not be available at run-time for certain files or +types of file descriptors. +.Pp +The +.Dv _POSIX_ASYNCHRONOUS_IO +macro in +.In unistd.h +describes the compile-time support for +.Nm . +The following conditions are possible: +.Bl -inset -offset indent +.It Dv _POSIX_ASYNCHRONOUS_IO No is not defined . +The implementation provides no information about whether programs using +.Nm +can be compiled. +.It Dv _POSIX_ASYNCHRONOUS_IO No is defined to \-1 . +The implementation does not support the asynchronous I/O +feature; the +.In aio.h +header file and +.Fn aio_* +functions are not provided. +.It Dv _POSIX_ASYNCHRONOUS_IO No is defined to a positive integer . +The implementation supports the asynchronous I/O feature +unconditionally, for all files and all file descriptors. The +.In aio.h +header file and +.Fn aio_* +functions are provided. +.It Dv _POSIX_ASYNCHRONOUS_IO No is defined to zero . +The implementation optionally supports asynchronous I/O. +The +.In aio.h +header file and +.Fn aio_* +functions are provided. +However, the result of calling any +.Fn aio_* +function is undefined unless the application has checked that the +asynchronous I/O option is supported on the files or file descriptors +it plans to use, by calling the +.Xr pathconf 2 +or +.Xr fpathconf 2 +function with a +.Fa name +argument of +.Dv _PC_ASYNC_IO . +If +.Nm +is available for the specified file (or descriptor), +.Xr pathconf 2 +(or +.Xr fpathconf 2 ) +will return a positive integer which is equal to the value specified +for +.Dv _POSIX_VERSION +by the version of the standard the system implements. +.El +.Pp +These configuration parameters can be queried by shell scripts using +the +.Xr getconf 1 +program. + + +.Sh SEE ALSO +.Xr aio_cancel 2 , +.Xr aio_error 2 , +.Xr aio_read 2 , +.Xr aio_return 2 , +.Xr aio_suspend 2 , +.Xr aio_waitcomplete 2 , +.Xr aio_write 2 , +.Xr config 8, +.Xr kld 4 , +.Xr kldload 8 +.Sh HISTORY +The +.Nm +facility appeared in +.Fx 3.0 . --2fHTh5uZTiUOsy+g Content-Type: text/x-patch; charset=us-ascii Content-Disposition: attachment; filename="aio2.diff" --- lib/libc/sys/aio_cancel.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_cancel.2 Thu Oct 24 11:06:08 2002 @@ -104,6 +104,7 @@ .Xr aio_return 2 , .Xr aio_suspend 2 , .Xr aio_write 2 , +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_error.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_error.2 Thu Oct 24 11:07:24 2002 @@ -96,6 +96,7 @@ .Xr fsync 2 , .Xr read 2 , .Xr write 2 +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_read.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_read.2 Thu Oct 24 11:07:04 2002 @@ -203,6 +203,7 @@ .Xr aio_suspend 2 , .Xr aio_waitcomplete 2 , .Xr aio_write 2 , +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_return.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_return.2 Thu Oct 24 11:06:50 2002 @@ -98,6 +98,7 @@ .Xr fsync 2 , .Xr read 2 , .Xr write 2 , +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_suspend.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_suspend.2 Thu Oct 24 11:06:38 2002 @@ -108,6 +108,7 @@ .Xr aio_return 2 , .Xr aio_waitcomplete 2 , .Xr aio_write 2 , +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_waitcomplete.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_waitcomplete.2 Thu Oct 24 11:06:27 2002 @@ -135,6 +135,7 @@ .Xr fsync 2 , .Xr read 2 , .Xr write 2 , +.Xr aio 4, .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --- lib/libc/sys/aio_write.2.orig Wed Oct 23 11:06:25 2002 +++ lib/libc/sys/aio_write.2 Thu Oct 24 11:07:50 2002 @@ -196,6 +196,7 @@ .Xr aio_return 2 , .Xr aio_suspend 2 , .Xr aio_waitcomplete 2 , +.Xr aio 4 , .Xr config 8 , .Xr kldload 8 , .Xr kldunload 8 --2fHTh5uZTiUOsy+g-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message