From owner-freebsd-bugs Mon Oct 21 23: 1:25 2002 Delivered-To: freebsd-bugs@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4339537B401 for ; Mon, 21 Oct 2002 23:01:18 -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 33EF243E42 for ; Mon, 21 Oct 2002 23:01:17 -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 g9M61ORD019967 for ; Tue, 22 Oct 2002 02:01:24 -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 g9M61Nop019966 for freebsd-bugs@freebsd.org; Tue, 22 Oct 2002 02:01:23 -0400 (EDT) Received: from dibbler.ne.client2.attbi.com ([24.61.41.247]) by rwcrgwc51.attbi.com (InterMail vM.4.01.03.37 201-229-121-137-20020806) with ESMTP id <20021022052236.HBJP11969.rwcrgwc51.attbi.com@dibbler.ne.client2.attbi.com> for ; Tue, 22 Oct 2002 05:22:36 +0000 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 g9M5MhRD019807; Tue, 22 Oct 2002 01:22:43 -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 g9M5MgEq019806; Tue, 22 Oct 2002 01:22:42 -0400 (EDT) Date: Tue, 22 Oct 2002 01:22:42 -0400 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) Message-ID: <20021022012242.A19773@attbi.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="0F1p//8PRICkK4MW" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i Sender: owner-freebsd-bugs@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --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-bugs" in the body of the message