Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 22 Oct 2002 01:22:42 -0400
From:      Craig Rodrigues <rodrigc@attbi.com>
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>

next in thread | raw e-mail | index | archive | help

--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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021022012242.A19773>