From owner-freebsd-doc Mon Oct 21 22:30:22 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 16D2A37B401 for ; Mon, 21 Oct 2002 22:30:08 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9C00B43E65 for ; Mon, 21 Oct 2002 22:30:07 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g9M5U7x3058159 for ; Mon, 21 Oct 2002 22:30:07 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g9M5U7Tr058158; Mon, 21 Oct 2002 22:30:07 -0700 (PDT) Date: Mon, 21 Oct 2002 22:30:07 -0700 (PDT) Message-Id: <200210220530.g9M5U7Tr058158@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Craig Rodrigues Subject: Re: docs/39748: [PATCH] Some changes to aio_*(2) Reply-To: Craig Rodrigues Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/39748; it has been noted by GNATS. From: Craig Rodrigues To: freebsd-gnats-submit@freebsd.org Cc: philipp.mergenthaler@stud.uni-karlsruhe.de Subject: Re: docs/39748: [PATCH] Some changes to aio_*(2) Date: Tue, 22 Oct 2002 01:22:42 -0400 --0F1p//8PRICkK4MW Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi, I would like to submit another patch, it is similar to docs/39748, but includes wording to instruct the user to kldload aio if the VFS_AIO is not specified in the kernel config file. -- Craig Rodrigues http://www.gis.net/~craigr rodrigc@attbi.com --0F1p//8PRICkK4MW Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="aio-patch.txt" --- lib/libc/sys/aio_cancel.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_cancel.2 Tue Oct 22 00:50:32 2002 @@ -72,12 +72,6 @@ .It Bq Dv AIO_ALLDONE All of the requests meeting the criteria have finished. .El -.Sh SEE ALSO -.Xr aio_error 2 , -.Xr aio_read 2 , -.Xr aio_return 2 , -.Xr aio_suspend 2 , -.Xr aio_write 2 .Sh ERRORS An error return from .Fn aio_cancel @@ -87,6 +81,32 @@ .Fa fildes is an invalid file descriptor. .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 SEE ALSO +.Xr aio_error 2 , +.Xr aio_read 2 , +.Xr aio_return 2 , +.Xr aio_suspend 2 , +.Xr aio_write 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS The .Fn aio_cancel --- lib/libc/sys/aio_error.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_error.2 Tue Oct 22 00:41:27 2002 @@ -70,6 +70,23 @@ .Fa iocb does not reference an outstanding asynchronous I/O request. .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 SEE ALSO .Xr aio_cancel 2 , .Xr aio_read 2 , @@ -79,6 +96,9 @@ .Xr fsync 2 , .Xr read 2 , .Xr write 2 +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS .Fn aio_error is expected to conform to the --- lib/libc/sys/aio_read.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_read.2 Tue Oct 22 00:41:47 2002 @@ -179,6 +179,33 @@ .Fa iocb->aio_offset would be invalid. .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 SEE ALSO +.Xr aio_cancel 2 , +.Xr aio_error 2 , +.Xr aio_return 2 , +.Xr aio_suspend 2 , +.Xr aio_waitcomplete 2 , +.Xr aio_write 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS The .Fn aio_read --- lib/libc/sys/aio_return.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_return.2 Tue Oct 22 00:46:52 2002 @@ -63,15 +63,6 @@ and sets .Dv errno to indicate the error condition. -.Sh SEE ALSO -.Xr aio_cancel 2 , -.Xr aio_error 2 , -.Xr aio_read 2 , -.Xr aio_suspend 2 , -.Xr aio_write 2 , -.Xr fsync 2 , -.Xr read 2 , -.Xr write 2 .Sh ERRORS The .Fn aio_return @@ -81,6 +72,35 @@ .Fa iocb does not reference an outstanding asynchronous I/O request. .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 SEE ALSO +.Xr aio_cancel 2 , +.Xr aio_error 2 , +.Xr aio_suspend 2 , +.Xr aio_waitcomplete 2 , +.Xr aio_write 2 , +.Xr fsync 2 , +.Xr read 2 , +.Xr write 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS .Fn aio_return is expected to conform to the --- lib/libc/sys/aio_suspend.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_suspend.2 Tue Oct 22 01:06:28 2002 @@ -67,12 +67,6 @@ returns 0. Otherwise it returns -1 and sets .Va errno to indicate the error, as enumerated below. -.Sh SEE ALSO -.Xr aio_cancel 2 , -.Xr aio_error 2 , -.Xr aio_read 2 , -.Xr aio_suspend 2 , -.Xr aio_write 2 .Sh ERRORS The .Fn aio_suspend @@ -91,6 +85,32 @@ .It Bq Er EINTR the suspend was interrupted by a signal. .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 SEE ALSO +.Xr aio_cancel 2 , +.Xr aio_error 2 , +.Xr aio_return 2 , +.Xr aio_waitcomplete 2 , +.Xr aio_write 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS .Fn aio_suspend is expected to conform to the --- lib/libc/sys/aio_waitcomplete.2 Mon Oct 1 12:09:01 2001 +++ /tmp/orig/sys/aio_waitcomplete.2 Tue Oct 22 00:43:06 2002 @@ -108,6 +108,23 @@ The specified time limit expired before any asynchronous I/O requests completed. .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 SEE ALSO .Xr aio_cancel 2 , .Xr aio_error 2 , @@ -117,7 +134,10 @@ .Xr aio_write 2 , .Xr fsync 2 , .Xr read 2 , -.Xr write 2 +.Xr write 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS The .Fn aio_waitcomplete --- lib/libc/sys/aio_write.2 Mon Oct 15 20:49:19 2001 +++ /tmp/orig/sys/aio_write.2 Tue Oct 22 00:42:39 2002 @@ -173,6 +173,32 @@ .Fa iocb->aio_offset would be invalid. .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 SEE ALSO +.Xr aio_cancel 2 , +.Xr aio_error 2 , +.Xr aio_return 2 , +.Xr aio_suspend 2 , +.Xr aio_waitcomplete 2 , +.Xr config 8 , +.Xr kldload 8 , +.Xr kldunload 8 .Sh STANDARDS .Fn aio_write is expected to conform to the --0F1p//8PRICkK4MW-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message