d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* Modernize aio(4), providing instructions for static and dynamic kernel

Browse Source 
linking.

* Fix disorder in the SEE ALSO sections of aio_*(2).

* Remove unnecessary cross-references from the SEE ALSO sections of
  aio_*(2); config(8), kldload(8) and kldunload(8) are cross-referenced
  from aio(4).

* Remove the KERNEL OPTIONS sections from aio_*(2), now that these
  pages cross-reference aio(4), which contains suitable kernel linking
  reference material.
This commit is contained in:
Sheldon Hearn 2002-10-24 12:57:05 +00:00
parent 3047fefe49
commit a7af55af93
8 changed files with 16 additions and 148 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
lib/libc/sys/aio_cancel.2
View File

@ -81,33 +81,13 @@ indicates:
.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 4 ,
.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
.Xr aio 4
.Sh STANDARDS
The
.Fn aio_cancel

24
lib/libc/sys/aio_error.2
View File

@ -70,25 +70,7 @@ function will fail if:
.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 4 ,
.Xr aio_cancel 2 ,
.Xr aio_read 2 ,
.Xr aio_return 2 ,
@ -96,10 +78,8 @@ module as desired:
.Xr aio_write 2 ,
.Xr fsync 2 ,
.Xr read 2 ,
.Xr write 2
.Xr config 8 ,
.Xr kldload 8 ,
.Xr kldunload 8
.Xr write 2 ,
.Xr aio 4
.Sh STANDARDS
.Fn aio_error
is expected to conform to the

22
lib/libc/sys/aio_read.2
View File

@ -179,34 +179,14 @@ The offset
.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 4 ,
.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
.Xr aio 4
.Sh STANDARDS
The
.Fn aio_read

22
lib/libc/sys/aio_return.2
View File

@ -72,25 +72,7 @@ function will fail if:
.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 4 ,
.Xr aio_cancel 2 ,
.Xr aio_error 2 ,
.Xr aio_suspend 2 ,
@ -99,9 +81,7 @@ module as desired:
.Xr fsync 2 ,
.Xr read 2 ,
.Xr write 2 ,
.Xr config 8 ,
.Xr kldload 8 ,
.Xr kldunload 8
.Xr aio 4
.Sh STANDARDS
.Fn aio_return
is expected to conform to the

22
lib/libc/sys/aio_suspend.2
View File

@ -85,33 +85,13 @@ valid.
.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 4 ,
.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
.Xr aio 4
.Sh STANDARDS
.Fn aio_suspend
is expected to conform to the

22
lib/libc/sys/aio_waitcomplete.2
View File

@ -108,25 +108,7 @@ asynchronous I/O requests completed.
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 4 ,
.Xr aio_cancel 2 ,
.Xr aio_error 2 ,
.Xr aio_read 2 ,
@ -136,9 +118,7 @@ module as desired:
.Xr fsync 2 ,
.Xr read 2 ,
.Xr write 2 ,
.Xr config 8 ,
.Xr kldload 8 ,
.Xr kldunload 8
.Xr aio 4
.Sh STANDARDS
The
.Fn aio_waitcomplete

21
lib/libc/sys/aio_write.2
View File

@ -173,32 +173,13 @@ The offset
.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
.Xr aio 4
.Sh STANDARDS
.Fn aio_write
is expected to conform to the

9
share/man/man4/aio.4
View File

@ -34,7 +34,11 @@
.Nm aio
.Nd asynchronous I/O
.Sh SYNOPSIS
To link into the kernel:
.Cd "options VFS_AIO"
.Pp
To load as a kernel loadable module:
.Dl kldload aio
.Sh DESCRIPTION
The
.Nm
@ -49,7 +53,10 @@ dynamic kernel module.
.Xr aio_return 2 ,
.Xr aio_suspend 2 ,
.Xr aio_waitcomplete 2 ,
.Xr aio_write 2
.Xr aio_write 2 ,
.Xr config 8 ,
.Xr kldload 8 ,
.Xr kldunload 8
.Sh HISTORY
The
.Nm