pool/libaio
SHA256
2
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
0f2c58c4e5
libaio/03_man_errors.patch
Stephan Kulow 5d3eab6cee Accepting request 32436 from home:jengelh:sparc 
Copy from home:jengelh:sparc/libaio via accept of submit request 32436 revision 2.
Request was accepted with message:
Reviewed ok

OBS-URL: https://build.opensuse.org/request/show/32436
OBS-URL: https://build.opensuse.org/package/show/devel:libraries:c_c++/libaio?expand=0&rev=6
2010-02-18 16:06:37 +00:00

2672 lines
72 KiB
Diff
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
man/aio.3 | 180 ++++++++++++++++++++++---------------------------
man/aio_cancel.3 | 72 +++++++++----------
man/aio_cancel64.3 | 50 ++++++-------
man/aio_error64.3 | 54 +++++++-------
man/aio_fsync64.3 | 46 ++++++------
man/aio_init.3 | 50 ++++++-------
man/aio_read64.3 | 56 +++++++--------
man/aio_return64.3 | 46 ++++++------
man/aio_suspend64.3 | 46 ++++++------
man/aio_write64.3 | 52 +++++++-------
man/io.3 | 73 +++++++++----------
man/io_cancel.3 | 36 ++++-----
man/io_fsync.3 | 42 +++++------
man/io_getevents.1 | 38 +++++-----
man/io_getevents.3 | 76 ++++++++++----------
man/io_prep_fsync.3 | 69 +++++++++---------
man/io_prep_pread.3 | 70 ++++++++-----------
man/io_prep_pwrite.3 | 68 ++++++++----------
man/io_queue_init.3 | 38 +++++-----
man/io_queue_release.3 | 38 +++++-----
man/io_queue_run.3 | 46 ++++++------
man/io_queue_wait.3 | 50 ++++++-------
man/io_set_callback.3 | 36 +++++----
man/io_setup.1 | 30 ++++----
man/io_submit.1 | 6 -
man/io_submit.3 | 60 ++++++++--------
man/lio_listio.3 | 115 ++++++++++++++-----------------
man/lio_listio64.3 | 20 ++---
28 files changed, 764 insertions(+), 799 deletions(-)
--- a/man/aio.3
+++ b/man/aio.3
@@ -1,11 +1,11 @@
-.TH aio 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio 3 2009-06-09 "Linux 2.4" "Linux AIO"
.SH NAME
aio \- Asynchronous IO
.SH SYNOPSIS
.nf
.B #include <errno.h>
.sp
-.br
+.br
.B #include <aio.h>
.sp
.fi
@@ -16,25 +16,23 @@ new functions allow a program to initiat
then immediately resume normal work while the I/O operations are
executed in parallel. This functionality is available if the
.IR "unistd.h"
-file defines the symbol
-.B "_POSIX_ASYNCHRONOUS_IO"
-.
+file defines the symbol
+.BR "_POSIX_ASYNCHRONOUS_IO" .
These functions are part of the library with realtime functions named
-.IR "librt"
-. They are not actually part of the
-.IR "libc"
+.IR "librt" .
+They are not actually part of the
+.IR "libc"
binary.
The implementation of these functions can be done using support in the
kernel (if available) or using an implementation based on threads at
userlevel. In the latter case it might be necessary to link applications
-with the thread library
+with the thread library
.IR "libpthread"
-in addition to
+in addition to
.IR "librt"
and
-.IR "libaio"
-.
+.IR "libaio" .
All AIO operations operate on files which were opened previously. There
might be arbitrarily many operations running for one file. The
@@ -42,7 +40,7 @@ asynchronous I/O operations are controll
.IR "struct aiocb"
It is defined in
.IR "aio.h"
- as follows.
+as follows.
.nf
struct aiocb
@@ -71,8 +69,8 @@ struct aiocb
};
.fi
-The POSIX.1b standard mandates that the
-.IR "struct aiocb"
+The POSIX.1b standard mandates that the
+.IR "struct aiocb"
structure
contains at least the members described in the following table. There
might be more elements which are used by the implementation, but
@@ -86,9 +84,9 @@ fail.
The device on which the file is opened must allow the seek operation.
I.e., it is not possible to use any of the AIO operations on devices
-like terminals where an
+like terminals where an
.IR "lseek"
- call would lead to an error.
+call would lead to an error.
.TP
.IR "off_t aio_offset"
This element specifies the offset in the file at which the operation (input
@@ -102,16 +100,15 @@ This is a pointer to the buffer with the
where the read data is stored.
.TP
.IR "size_t aio_nbytes"
-This element specifies the length of the buffer pointed to by
-.IR "aio_buf"
-.
+This element specifies the length of the buffer pointed to by
+.IR "aio_buf" .
.TP
.IR "int aio_reqprio"
-If the platform has defined
+If the platform has defined
.B "_POSIX_PRIORITIZED_IO"
and
-.B "_POSIX_PRIORITY_SCHEDULING"
-, the AIO requests are
+.BR "_POSIX_PRIORITY_SCHEDULING" ,
+the AIO requests are
processed based on the current scheduling priority. The
.IR "aio_reqprio"
element can then be used to lower the priority of the
@@ -119,30 +116,28 @@ AIO operation.
.TP
.IR "struct sigevent aio_sigevent"
This element specifies how the calling process is notified once the
-operation terminates. If the
+operation terminates. If the
.IR "sigev_notify"
element is
-.B "SIGEV_NONE"
-, no notification is sent. If it is
-.B "SIGEV_SIGNAL"
-,
-the signal determined by
+.BR "SIGEV_NONE" ,
+no notification is sent. If it is
+.BR "SIGEV_SIGNAL" ,
+the signal determined by
.IR "sigev_signo"
is sent. Otherwise,
.IR "sigev_notify"
-must be
-.B "SIGEV_THREAD"
-. In this case, a thread
+must be
+.BR "SIGEV_THREAD" .
+In this case, a thread
is created which starts executing the function pointed to by
-.IR "sigev_notify_function"
-.
+.IR "sigev_notify_function" .
.TP
.IR "int aio_lio_opcode"
-This element is only used by the
+This element is only used by the
.IR "lio_listio"
- and
+and
.IR "lio_listio64"
- functions. Since these functions allow an
+functions. Since these functions allow an
arbitrary number of operations to start at once, and each operation can be
input or output (or nothing), the information must be stored in the
control block. The possible values are:
@@ -150,47 +145,42 @@ control block. The possible values are:
.B "LIO_READ"
Start a read operation. Read from the file at position
.IR "aio_offset"
- and store the next
+and store the next
.IR "aio_nbytes"
- bytes in the
-buffer pointed to by
-.IR "aio_buf"
-.
+bytes in the
+buffer pointed to by
+.IR "aio_buf" .
.TP
.B "LIO_WRITE"
-Start a write operation. Write
-.IR "aio_nbytes"
+Start a write operation. Write
+.IR "aio_nbytes"
bytes starting at
.IR "aio_buf"
-into the file starting at position
-.IR "aio_offset"
-.
+into the file starting at position
+.IR "aio_offset" .
.TP
.B "LIO_NOP"
Do nothing for this control block. This value is useful sometimes when
-an array of
+an array of
.IR "struct aiocb"
values contains holes, i.e., some of the
values must not be handled although the whole array is presented to the
.IR "lio_listio"
function.
-When the sources are compiled using
+When the sources are compiled using
.B "_FILE_OFFSET_BITS == 64"
-on a
-32 bit machine, this type is in fact
-.IR "struct aiocb64"
-, since the LFS
-interface transparently replaces the
+on a 32 bit machine, this type is in fact
+.IR "struct aiocb64" ,
+since the LFS interface transparently replaces the
.IR "struct aiocb"
definition.
.PP
For use with the AIO functions defined in the LFS, there is a similar type
defined which replaces the types of the appropriate members with larger
-types but otherwise is equivalent to
-.IR "struct aiocb"
-. Particularly,
-all member names are the same.
+types but otherwise is equivalent to
+.IR "struct aiocb" ,
+Particularly, all member names are the same.
.nf
/* The same for the 64bit offsets. Please note that the members aio_fildes
@@ -224,9 +214,9 @@ operation. It must be a legal descripto
fails for obvious reasons.
The device on which the file is opened must allow the seek operation.
I.e., it is not possible to use any of the AIO operations on devices
-like terminals where an
+like terminals where an
.IR "lseek"
- call would lead to an error.
+call would lead to an error.
.TP
.IR "off64_t aio_offset"
This element specifies at which offset in the file the operation (input
@@ -240,12 +230,11 @@ This is a pointer to the buffer with the
where the read data is stored.
.TP
.IR "size_t aio_nbytes"
-This element specifies the length of the buffer pointed to by
-.IR "aio_buf"
-.
+This element specifies the length of the buffer pointed to by
+.IR "aio_buf" .
.TP
.IR "int aio_reqprio"
-If for the platform
+If for the platform
.B "_POSIX_PRIORITIZED_IO"
and
.B "_POSIX_PRIORITY_SCHEDULING"
@@ -257,59 +246,56 @@ AIO operation.
.TP
.IR "struct sigevent aio_sigevent"
This element specifies how the calling process is notified once the
-operation terminates. If the
-.IR "sigev_notify"
-, element is
+operation terminates. If the
+.IR "sigev_notify" ,
+element is
.B "SIGEV_NONE"
-no notification is sent. If it is
-.B "SIGEV_SIGNAL"
-,
-the signal determined by
+no notification is sent. If it is
+.BR "SIGEV_SIGNAL" ,
+the signal determined by
.IR "sigev_signo"
is sent. Otherwise,
.IR "sigev_notify"
- must be
+must be
.B "SIGEV_THREAD"
in which case a thread
which starts executing the function pointed to by
-.IR "sigev_notify_function"
-.
+.IR "sigev_notify_function" .
.TP
.IR "int aio_lio_opcode"
-This element is only used by the
+This element is only used by the
.IR "lio_listio"
and
.IR "lio_listio64"
functions. Since these functions allow an
arbitrary number of operations to start at once, and since each operation can be
input or output (or nothing), the information must be stored in the
-control block. See the description of
+control block. See the description of
.IR "struct aiocb"
for a description
of the possible values.
.PP
-When the sources are compiled using
+When the sources are compiled using
.B "_FILE_OFFSET_BITS == 64"
-on a
-32 bit machine, this type is available under the name
-.IR "struct aiocb64"
-, since the LFS transparently replaces the old interface.
+on a 32 bit machine, this type is available under the name
+.IR "struct aiocb64" ,
+since the LFS transparently replaces the old interface.
.SH "RETURN VALUES"
.SH ERRORS
.SH "SEE ALSO"
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_cancel.3
+++ b/man/aio_cancel.3
@@ -1,4 +1,4 @@
-.TH aio_cancel 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_cancel 3 2009-06-09 "Linux 2.4" "Linux AIO"
.SH NAME
aio_cancel - Cancel asynchronous I/O requests
.SH SYNOPSYS
@@ -9,7 +9,7 @@ aio_cancel - Cancel asynchronous I/O req
.B #include <aio.h>
.sp
.br
-.BI "int aio_cancel (int fildes " , struct aiocb *aiocbp " )"
+.BI "int aio_cancel (int " fildes ", struct aiocb *" aiocbp ")"
.fi
.SH DESCRIPTION
When one or more requests are asynchronously processed, it might be
@@ -23,7 +23,7 @@ is not capable of forcing the cancellati
implementation to decide whether it is possible to cancel the operation
or not. Therefore using this function is merely a hint.
.B "The libaio implementation does not implement the cancel operation in the"
-.B "POSIX libraries".
+.B "POSIX libraries."
.PP
The
.IR aio_cancel
@@ -31,8 +31,8 @@ function can be used to cancel one or mo
outstanding requests. If the
.IR aiocbp
parameter is
-.IR NULL
-, the
+.IR NULL ,
+the
function tries to cancel all of the outstanding requests which would process
the file descriptor
.IR fildes
@@ -40,11 +40,11 @@ the file descriptor
.IR aio_fildes
member
is
-.IR fildes
-). If
-.IR aiocbp is not
-.IR NULL
-,
+.IR fildes ).
+If
+.IR aiocbp
+is not
+.IR NULL ,
.IR aio_cancel
attempts to cancel the specific request pointed to by
.IR aiocbp.
@@ -64,13 +64,13 @@ a reference to this request as the param
and a call to
.IR aio_return
will return
-.IR -1.
+.IR -1 .
If the request wasn't canceled and is still running the error status is
still
-.B EINPROGRESS.
+.BR EINPROGRESS .
When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
+.IR "_FILE_OFFSET_BITS == 64" ,
+this
function is in fact
.IR aio_cancel64
since the LFS interface
@@ -83,22 +83,20 @@ If there were
requests which haven't terminated and which were successfully canceled.
.TP
.B AIO_NOTCANCELED
-If there is one or more requests left which couldn't be canceled,
-. In this case
+If there is one or more requests left which couldn't be canceled.
+In this case
.IR aio_error
must be used to find out which of the, perhaps multiple, requests (in
.IR aiocbp
is
-.IR NULL
-) weren't successfully canceled.
+.IR NULL )
+weren't successfully canceled.
.TP
.B AIO_ALLDONE
If all
requests already terminated at the time
.IR aio_cancel
-is called the
-return value is
-.
+is called.
.SH ERRORS
If an error occurred during the execution of
.IR aio_cancel
@@ -119,19 +117,19 @@ is not valid.
.IR aio_cancel
is not implemented.
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_cancel64.3
+++ b/man/aio_cancel64.3
@@ -1,4 +1,4 @@
-.TH aio_cancel64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_cancel64 3 2002-09-12 "Linux 2.4" "Linux AIO"
.SH NAME
aio_cancel64 \- Cancel asynchronous I/O requests
.SH SYNOPSYS
@@ -9,42 +9,42 @@ aio_cancel64 \- Cancel asynchronous I/O
.B #include <aio.h>
.sp
.br
-.BI "int aio_cancel64 (int fildes, struct aiocb64 *aiocbp)"
+.BI "int aio_cancel64(int " fildes ", struct aiocb64 *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to
.IR aio_cancel
with the only difference
that the argument is a reference to a variable of type
-.IR struct aiocb64
-.
-
+.IR "struct aiocb64" .
When the sources are compiled with
-.IR _FILE_OFFSET_BITS == 64
-, this
+.IR "_FILE_OFFSET_BITS == 64" ,
+this
function is available under the name
.IR aio_cancel
and so
transparently replaces the interface for small files on 32 bit
machines.
.SH "RETURN VALUES"
-See aio_cancel(3).
+See
+.BR aio_cancel (3).
.SH ERRORS
-See aio_cancel(3).
+See
+.BR aio_cancel (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_error64.3
+++ b/man/aio_error64.3
@@ -1,4 +1,4 @@
-.TH aio_error64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_error64 3 2009-06-09 "Linux 2.4" "Linux AIO"
.SH NAME
aio_error64 \- Return errors
.SH SYNOPSYS
@@ -9,14 +9,14 @@ aio_error64 \- Return errors
.B #include <aio.h>
.sp
.br
-.BI "int aio_error64 (const struct aiocb64 *aiocbp)"
+.BI "int aio_error64(const struct aiocb64 *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to
.IR aio_error
with the only difference
that the argument is a reference to a variable of type
-.IR "struct aiocb64".
+.IR "struct aiocb64" .
.PP
When the sources are compiled with
.IR "_FILE_OFFSET_BITS == 64"
@@ -28,37 +28,35 @@ transparently replaces the interface for
machines.
.SH "RETURN VALUES"
If the request has not yet terminated the value returned is always
-.IR "EINPROGRESS"
-. Once the request has terminated the value
+.IR "EINPROGRESS" .
+Once the request has terminated the value
.IR "aio_error"
returns is either
.I 0
if the request completed successfully or it returns the value which would be stored in the
.IR "errno"
variable if the request would have been done using
-.IR "read"
-,
-.IR "write"
-, or
-.IR "fsync"
-.
+.IR "read" ,
+.IR "write" ,
+or
+.IR "fsync" .
.SH ERRORS
See
-.IR aio_error(3).
+.IR aio_error (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_fsync64.3
+++ b/man/aio_fsync64.3
@@ -1,4 +1,4 @@
-.TH aio_fsync64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_fsync64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
aio_fsync64 \- Synchronize a file's complete in-core state with that on disk
.SH SYNOPSYS
@@ -9,43 +9,43 @@ aio_fsync64 \- Synchronize a file's comp
.B #include <aio.h>
.sp
.br
-.BI "int aio_fsync64 (int op, struct aiocb64 *aiocbp)"
+.BI "int aio_fsync64(int " op ", struct aiocb64 *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to
-.IR aio_fsync
+.BR aio_fsync
with the only difference
that the argument is a reference to a variable of type
-.IR "struct aiocb64".
+.IR "struct aiocb64" .
When the sources are compiled with
.IR "_FILE_OFFSET_BITS == 64"
this
function is available under the name
-.IR aio_fsync
+.BR aio_fsync
and so
transparently replaces the interface for small files on 32 bit
machines.
.SH "RETURN VALUES"
See
-.IR aio_fsync.
+.BR aio_fsync (3).
.SH ERRORS
See
-.IR aio_fsync.
+.BR aio_fsync (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_init.3
+++ b/man/aio_init.3
@@ -1,4 +1,4 @@
-.TH aio_init 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_init 3 2009-06-09 "Linux 2.4" "Linux AIO"
.SH NAME
aio_init \- How to optimize the AIO implementation
.SH SYNOPSYS
@@ -9,7 +9,7 @@ aio_init \- How to optimize the AIO imp
.B #include <aio.h>
.sp
.br
-.BI "void aio_init (const struct aioinit *init)"
+.BI "void aio_init (const struct aioinit *" init )
.fi
.SH DESCRIPTION
@@ -29,7 +29,7 @@ for tuning the AIO implementation accord
This data type is used to pass the configuration or tunable parameters
to the implementation. The program has to initialize the members of
this struct and pass it to the implementation using the
-.IR aio_init
+.BR aio_init
function.
.TP
.B "int aio_threads"
@@ -60,37 +60,37 @@ is completely voluntary, as it is only m
implementation perform better.
Before calling the
-.IR aio_init
-, function the members of a variable of
+.BR aio_init ,
+function the members of a variable of
type
-.IR "struct aioinit"
+.BR "struct aioinit"
must be initialized. Then a reference to
this variable is passed as the parameter to
-.IR aio_init
+.BR aio_init
which itself
may or may not pay attention to the hints.
It is a extension which follows a proposal from the SGI implementation in
-.IR Irix 6
-. It is not covered by POSIX.1b or Unix98.
+.IR "Irix 6" .
+It is not covered by POSIX.1b or Unix98.
.SH "RETURN VALUES"
The function has no return value.
.SH ERRORS
The function has no error cases defined.
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_read64.3
+++ b/man/aio_read64.3
@@ -1,4 +1,4 @@
-.TH aio_read64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_read64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
aio_read64 \- Initiate an asynchronous read operation
.SH SYNOPSYS
@@ -8,53 +8,53 @@ aio_read64 \- Initiate an asynchronous r
.B #include <aio.h>
.sp
.br
-.BI "int aio_read64 (struct aiocb *aiocbp)"
+.BI "int aio_read64(struct aiocb *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to the
-.IR "aio_read"
+.BR "aio_read"
function. The only
difference is that on
.IR "32 bit"
machines, the file descriptor should
be opened in the large file mode. Internally,
-.IR "aio_read64"
+.BR "aio_read64"
uses
functionality equivalent to
-.IR "lseek64"
+.BR "lseek64"
to position the file descriptor correctly for the reading,
as opposed to
-.IR "lseek"
+.BR "lseek"
functionality used in
-.IR "aio_read".
+.BR "aio_read" .
When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
+.IR "_FILE_OFFSET_BITS == 64" ,
+this
function is available under the name
-.IR "aio_read"
+.BR "aio_read"
and so transparently
replaces the interface for small files on 32 bit machines.
.SH "RETURN VALUES"
See
-.IR aio_read.
+.BR aio_read (3).
.SH ERRORS
See
-.IR aio_read.
+.BR aio_read (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_return64.3
+++ b/man/aio_return64.3
@@ -1,4 +1,4 @@
-.TH aio_read64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_read64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
aio_read64 \- Retrieve status of asynchronous I/O operation
.SH SYNOPSYS
@@ -9,43 +9,43 @@ aio_read64 \- Retrieve status of asynchr
.B #include <aio.h>
.sp
.br
-.BI "int aio_return64 (const struct aiocb64 *aiocbp)"
+.BI "int aio_return64(const struct aiocb64 *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to
-.IR "aio_return"
+.BR "aio_return"
with the only difference
that the argument is a reference to a variable of type
-.IR "struct aiocb64".
+.BR "struct aiocb64" .
When the sources are compiled with
.IR "_FILE_OFFSET_BITS == 64"
this
function is available under the name
-.IR "aio_return"
+.BR "aio_return"
and so
transparently replaces the interface for small files on 32 bit
machines.
.SH "RETURN VALUES"
See
-.IR aio_return.
+.BR aio_return (3).
.SH ERRORS
See
-.IR aio_return.
+.BR aio_return (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_suspend64.3
+++ b/man/aio_suspend64.3
@@ -1,4 +1,4 @@
-.TH aio_suspend64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_suspend64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
aio_suspend64 \- Wait until one or more requests of a specific set terminates
.SH SYNOPSYS
@@ -9,43 +9,43 @@ aio_suspend64 \- Wait until one or more
.B #include <aio.h>
.sp
.br
-.BI "int aio_suspend64 (const struct aiocb64 *const list[], int nent, const struct timespec *timeout)"
+.BI "int aio_suspend64(const struct aiocb64 *const " list "[], int " nent ", const struct timespec *" timeout ");"
.fi
.SH DESCRIPTION
This function is similar to
-.IR "aio_suspend"
+.BR "aio_suspend"
with the only difference
that the argument is a reference to a variable of type
-.IR "struct aiocb64".
+.BR "struct aiocb64" .
When the sources are compiled with
.IR "_FILE_OFFSET_BITS == 64"
this
function is available under the name
-.IR "aio_suspend"
+.BR "aio_suspend"
and so
transparently replaces the interface for small files on 32 bit
machines.
.SH "RETURN VALUES"
See
-.IR aio_suspend.
+.BR aio_suspend (3).
.SH ERRORS
See
-.IR aio_suspend.
+.BR aio_suspend (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_write (3),
+.BR aio_write64 (3),
+.BR errno (3).
--- a/man/aio_write64.3
+++ b/man/aio_write64.3
@@ -1,4 +1,4 @@
-.TH aio_write64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH aio_write64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
aio_write64 \- Initiate an asynchronous write operation
.SH SYNOPSYS
@@ -9,53 +9,53 @@ aio_write64 \- Initiate an asynchronous
.B #include <aio.h>
.sp
.br
-.BI "int aio_write64 (struct aiocb *aiocbp)"
+.BI "int aio_write64(struct aiocb *" aiocbp ");"
.fi
.SH DESCRIPTION
This function is similar to the
-.IR "aio_write"
+.BR "aio_write"
function. The only
difference is that on
.IR "32 bit"
machines the file descriptor should
be opened in the large file mode. Internally
-.IR "aio_write64"
+.BR "aio_write64"
uses
functionality equivalent to
-.IR "lseek64"
+.BR "lseek64"
to position the file descriptor correctly for the writing,
as opposed to
-.IR "lseek"
+.BR "lseek"
functionality used in
-.IR "aio_write".
+.BR "aio_write" .
When the sources are compiled with
.IR "_FILE_OFFSET_BITS == 64"
, this
function is available under the name
-.IR "aio_write"
+.BR "aio_write"
and so transparently
replaces the interface for small files on 32 bit machines.
.SH "RETURN VALUES"
See
-.IR aio_write.
+.BR aio_write (3).
.SH ERRORS
See
-.IR aio_write.
+.BR aio_write (3).
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR errno(3),
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR errno (3).
--- a/man/lio_listio.3
+++ b/man/lio_listio.3
@@ -1,4 +1,4 @@
-.TH lio_listio 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH lio_listio 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
lio_listio - List directed I/O
.SH SYNOPSYS
@@ -6,7 +6,7 @@ lio_listio - List directed I/O
.br
.B #include <libaio.h>
.LP
-.BI "int lio_listio (int mode, struct aiocb *const list[], int nent, struct sigevent *sig)"
+.BI "int lio_listio(int " mode ", struct aiocb *const " list "[], int " nent ", struct sigevent *" sig ");"
.nf
.SH DESCRIPTION
@@ -14,34 +14,33 @@ Besides these functions with the more or
POSIX.1b also defines a function which can initiate more than one
operation at a time, and which can handle freely mixed read and write
operations. It is therefore similar to a combination of
-.IR readv
+.BR readv (2)
and
-.IR "writev"
-.
+.BR writev (2).
The
-.IR "lio_listio"
+.BR "lio_listio"
function can be used to enqueue an arbitrary
number of read and write requests at one time. The requests can all be
meant for the same file, all for different files or every solution in
between.
-.IR "lio_listio"
+.BR "lio_listio"
gets the
.IR "nent"
requests from the array pointed to
by
-.IR "list"
-. The operation to be performed is determined by the
+.IR "list" .
+The operation to be performed is determined by the
.IR "aio_lio_opcode"
member in each element of
-.IR "list"
-. If this
+.IR "list" .
+If this
field is
.B "LIO_READ"
a read operation is enqueued, similar to a call
of
-.IR "aio_read"
+.BR "aio_read"
for this element of the array (except that the way
the termination is signalled is different, as we will see below). If
the
@@ -57,10 +56,10 @@ in which case this element of
.IR "list"
is simply ignored. This
``operation'' is useful in situations where one has a fixed array of
-.IR "struct aiocb"
+.BR "struct aiocb"
elements from which only a few need to be handled at
a time. Another situation is where the
-.IR "lio_listio"
+.BR "lio_listio"
call was
canceled before all requests are processed and the remaining requests have to be reissued.
@@ -68,15 +67,15 @@ The other members of each element of the
.IR "list"
must have values suitable for the operation as described in
the documentation for
-.IR "aio_read"
+.BR "aio_read"
and
-.IR "aio_write"
+.BR "aio_write"
above.
The
.IR "mode"
argument determines how
-.IR "lio_listio"
+.BR "lio_listio"
behaves after
having enqueued all the requests. If
.IR "mode"
@@ -98,25 +97,24 @@ is
no notification is
send. Otherwise a signal is sent or a thread is started, just as
described in the description for
-.IR "aio_read"
+.BR "aio_read"
or
-.IR "aio_write"
-.
+.BR "aio_write" .
When the sources are compiled with
-.B "_FILE_OFFSET_BITS == 64"
-, this
+.IR "_FILE_OFFSET_BITS == 64" ,
+this
function is in fact
-.IR "lio_listio64"
+.BR "lio_listio64"
since the LFS interface
transparently replaces the normal implementation.
.SH "RETURN VALUES"
If
.IR "mode"
is
-.B "LIO_WAIT"
-, the return value of
-.IR "lio_listio"
+.BR "LIO_WAIT" ,
+the return value of
+.BR "lio_listio"
is
.IR 0
when all requests completed successfully. Otherwise the
@@ -126,10 +124,9 @@ and
.IR "errno"
is set accordingly. To find
out which request or requests failed one has to use the
-.IR "aio_error"
+.BR "aio_error"
function on all the elements of the array
-.IR "list"
-.
+.IR "list" .
In case
.IR "mode"
@@ -140,12 +137,12 @@ is
if
all requests were enqueued correctly. The current state of the requests
can be found using
-.IR "aio_error"
+.BR "aio_error"
and
-.IR "aio_return"
+.BR "aio_return"
as described
above. If
-.IR "lio_listio"
+.BR "lio_listio"
returns
.IR -1
in this mode, the
@@ -153,16 +150,15 @@ global variable
.IR "errno"
is set accordingly. If a request did not
yet terminate, a call to
-.IR "aio_error"
+.BR "aio_error"
returns
-.B "EINPROGRESS"
-. If
+.BR "EINPROGRESS" .
+If
the value is different, the request is finished and the error value (or
-
-.IR 0
-) is returned and the result of the operation can be retrieved
+.IR 0 )
+is returned and the result of the operation can be retrieved
using
-.IR "aio_return"
+.BR "aio_return" .
.
.SH ERRORS
Possible values for
@@ -187,8 +183,7 @@ The
parameter is invalid or
.IR "nent"
is larger than
-.B "AIO_LISTIO_MAX"
-.
+.BR "AIO_LISTIO_MAX" .
.TP
.B EIO
One or more of the request's I/O operations failed. The error status of
@@ -196,7 +191,7 @@ each request should be checked to determ
.TP
.B ENOSYS
The
-.IR "lio_listio"
+.BR "lio_listio"
function is not supported.
.PP
@@ -206,24 +201,24 @@ parameter is
.B "LIO_NOWAIT"
and the caller cancels
a request, the error status for this request returned by
-.IR "aio_error"
+.BR "aio_error"
is
-.B "ECANCELED"
+.BR "ECANCELED" .
.
.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(3),
-.BR aio_fsync(3),
-.BR aio_fsync64(3),
-.BR aio_init(3),
-.BR aio_read(3),
-.BR aio_read64(3),
-.BR aio_return(3),
-.BR aio_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3)
+.BR aio (3),
+.BR aio_cancel (3),
+.BR aio_cancel64 (3),
+.BR aio_error (3),
+.BR aio_error64 (3),
+.BR aio_fsync (3),
+.BR aio_fsync64 (3),
+.BR aio_init (3),
+.BR aio_read (3),
+.BR aio_read64 (3),
+.BR aio_return (3),
+.BR aio_return64 (3),
+.BR aio_suspend (3),
+.BR aio_suspend64 (3),
+.BR aio_write (3),
+.BR aio_write64 (3).
--- a/man/io.3
+++ b/man/io.3
@@ -1,4 +1,4 @@
-.TH io 3 2002-09-12 "Linux 2.4" Linux IO"
+.TH io 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io \- Asynchronous IO
.SH SYNOPSYS
@@ -6,7 +6,7 @@ io \- Asynchronous IO
.B #include <errno.h>
.sp
.br
-.B #include <libio.h>
+.B #include <libaio.h>
.sp
.fi
.SH DESCRIPTION
@@ -17,9 +17,9 @@ then immediately resume normal work whil
executed in parallel.
These functions are part of the library with realtime functions named
-.IR "libaio"
-. They are not actually part of the
-.IR "libc"
+.IR libaio .
+They are not actually part of the
+.I "libc"
binary.
The implementation of these functions can be done using support in the
kernel.
@@ -27,9 +27,9 @@ kernel.
All IO operations operate on files which were opened previously. There
might be arbitrarily many operations running for one file. The
asynchronous I/O operations are controlled using a data structure named
-.IR "struct iocb"
+.B "struct iocb"
It is defined in
-.IR "libio.h"
+.I "libaio.h"
as follows.
.nf
@@ -74,7 +74,7 @@ struct iocb {
.fi
.TP
-.IR "int aio_fildes"
+.BI int " aio_fildes"
This element specifies the file descriptor to be used for the
operation. It must be a legal descriptor, otherwise the operation will
fail.
@@ -82,54 +82,51 @@ fail.
The device on which the file is opened must allow the seek operation.
I.e., it is not possible to use any of the IO operations on devices
like terminals where an
-.IR "lseek"
+.BR lseek (2)
call would lead to an error.
.TP
-.IR "long u.c.offset"
+.BI long " u.c.offset"
This element specifies the offset in the file at which the operation (input
or output) is performed. Since the operations are carried out in arbitrary
order and more than one operation for one file descriptor can be
started, one cannot expect a current read/write position of the file
descriptor.
.TP
-.IR "void *buf"
+.BI "void *" buf
This is a pointer to the buffer with the data to be written or the place
where the read data is stored.
.TP
-.IR "long u.c.nbytes"
+.BI long " u.c.nbytes"
This element specifies the length of the buffer pointed to by
-.IR "io_buf"
-.
+.IR io_buf .
.TP
-.IR "int aio_reqprio"
+.BI int " aio_reqprio"
Is not currently used.
.TP
.B "IO_CMD_PREAD"
Start a read operation. Read from the file at position
-.IR "u.c.offset"
+.I u.c.offset
and store the next
-.IR "u.c.nbytes"
+.I u.c.nbytes
bytes in the
buffer pointed to by
-.IR "buf"
-.
+.IR buf .
.TP
.B "IO_CMD_PWRITE"
Start a write operation. Write
-.IR "u.c.nbytes"
+.I u.c.nbytes
bytes starting at
-.IR "buf"
+.I buf
into the file starting at position
-.IR "u.c.offset"
-.
+.IR u.c.offset .
.TP
.B "IO_CMD_NOP"
Do nothing for this control block. This value is useful sometimes when
an array of
-.IR "struct iocb"
+.I struct iocb
values contains holes, i.e., some of the
values must not be handled although the whole array is presented to the
-.IR "io_submit"
+.I io_submit
function.
.TP
.B "IO_CMD_FSYNC"
@@ -336,16 +333,16 @@ int main(int argc, char *const *argv)
*/
.fi
.SH "SEE ALSO"
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_cancel.3
+++ b/man/io_cancel.3
@@ -1,4 +1,4 @@
-.TH io_cancel 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.TH io_cancel 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_cancel \- Cancel io requests
.SH SYNOPSIS
@@ -9,7 +9,7 @@ io_cancel \- Cancel io requests
.B #include <libaio.h>
.sp
.br
-.BI "int io_cancel(io_context_t ctx, struct iocb *iocb)"
+.BI "int io_cancel(io_context_t " ctx ", struct iocb *" iocb ");"
.br
.sp
struct iocb {
@@ -33,7 +33,7 @@ have to be overwritten soon. As an exam
writes data in files in a situation where new incoming data would have
to be written in a file which will be updated by an enqueued request.
.SH "RETURN VALUES"
-0 is returned on success , otherwise returns Errno.
+\fI0\fP is returned on success, otherwise returns \fIerrno\fP.
.SH ERRORS
.TP
.B EFAULT
@@ -44,22 +44,22 @@ If aio_context specified by ctx_id is
invalid.
.TP
.B EAGAIN
-If the iocb specified was not
+If the \fIiocb\fP specified was not
cancelled.
.TP
.B ENOSYS
-if not implemented.
+If not implemented.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_fsync.3
+++ b/man/io_fsync.3
@@ -1,10 +1,10 @@
-./" static inline int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)
-./" {
-./" io_prep_fsync(iocb, fd);
-./" io_set_callback(iocb, cb);
-./" return io_submit(ctx, 1, &iocb);
-./" }
-.TH io_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
+.\" static inline int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)
+.\" {
+.\" io_prep_fsync(iocb, fd);
+.\" io_set_callback(iocb, cb);
+.\" return io_submit(ctx, 1, &iocb);
+.\" }
+.TH io_fsync 3 2009-06-10 "Linux 2.4" Linux AIO"
.SH NAME
io_fsync \- Synchronize a file's complete in-core state with that on disk
.SH SYNOPSYS
@@ -15,7 +15,7 @@ io_fsync \- Synchronize a file's complet
.B #include <libaio.h>
.sp
.br
-.BI "int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)"
+.BI "int io_fsync(io_context_t " ctx ", struct iocb *" iocb ", io_callback_t " cb ", int " fd ");"
.sp
struct iocb {
void *data;
@@ -49,7 +49,7 @@ file descriptor have terminated and the
means that requests for this very same file descriptor which are queued
after the synchronization request are not affected.
.SH "RETURN VALUES"
-Returns 0, otherwise returns errno.
+Returns \fI0\fP, otherwise returns \fIerrno\fP.
.SH ERRORS
.TP
.B EFAULT
@@ -68,15 +68,15 @@ The iocb contains a file descriptor that
.B EINVAL
The file specified in the iocb does not support the given io operation.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_getevents(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_getevents (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_getevents.1
+++ b/man/io_getevents.1
@@ -1,22 +1,22 @@
-./"/* io_getevents:
-./" * Attempts to read at least min_nr events and up to nr events from
-./" * the completion queue for the aio_context specified by ctx_id. May
-./" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
-./" * if nr is out of range, if when is out of range. May fail with
-./" * -EFAULT if any of the memory specified to is invalid. May return
-./" * 0 or < min_nr if no events are available and the timeout specified
-./" * by when has elapsed, where when == NULL specifies an infinite
-./" * timeout. Note that the timeout pointed to by when is relative and
-./" * will be updated if not NULL and the operation blocks. Will fail
-./" * with -ENOSYS if not implemented.
-./" */
-./"asmlinkage long sys_io_getevents(io_context_t ctx_id,
-./" long min_nr,
-./" long nr,
-./" struct io_event *events,
-./" struct timespec *timeout)
-./"
-.TH io_getevents 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.\"/* io_getevents:
+.\" * Attempts to read at least min_nr events and up to nr events from
+.\" * the completion queue for the aio_context specified by ctx_id. May
+.\" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
+.\" * if nr is out of range, if when is out of range. May fail with
+.\" * -EFAULT if any of the memory specified to is invalid. May return
+.\" * 0 or < min_nr if no events are available and the timeout specified
+.\" * by when has elapsed, where when == NULL specifies an infinite
+.\" * timeout. Note that the timeout pointed to by when is relative and
+.\" * will be updated if not NULL and the operation blocks. Will fail
+.\" * with -ENOSYS if not implemented.
+.\" */
+.\"asmlinkage long sys_io_getevents(io_context_t ctx_id,
+.\" long min_nr,
+.\" long nr,
+.\" struct io_event *events,
+.\" struct timespec *timeout)
+.\"
+.TH io_getevents 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_getevents \- read resulting events from io requests
.SH SYNOPSIS
--- a/man/io_getevents.3
+++ b/man/io_getevents.3
@@ -1,22 +1,22 @@
-./"/* io_getevents:
-./" * Attempts to read at least min_nr events and up to nr events from
-./" * the completion queue for the aio_context specified by ctx_id. May
-./" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
-./" * if nr is out of range, if when is out of range. May fail with
-./" * -EFAULT if any of the memory specified to is invalid. May return
-./" * 0 or < min_nr if no events are available and the timeout specified
-./" * by when has elapsed, where when == NULL specifies an infinite
-./" * timeout. Note that the timeout pointed to by when is relative and
-./" * will be updated if not NULL and the operation blocks. Will fail
-./" * with -ENOSYS if not implemented.
-./" */
-./"asmlinkage long sys_io_getevents(io_context_t ctx_id,
-./" long min_nr,
-./" long nr,
-./" struct io_event *events,
-./" struct timespec *timeout)
-./"
-.TH io_getevents 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.\"/* io_getevents:
+.\" * Attempts to read at least min_nr events and up to nr events from
+.\" * the completion queue for the aio_context specified by ctx_id. May
+.\" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
+.\" * if nr is out of range, if when is out of range. May fail with
+.\" * -EFAULT if any of the memory specified to is invalid. May return
+.\" * 0 or < min_nr if no events are available and the timeout specified
+.\" * by when has elapsed, where when == NULL specifies an infinite
+.\" * timeout. Note that the timeout pointed to by when is relative and
+.\" * will be updated if not NULL and the operation blocks. Will fail
+.\" * with -ENOSYS if not implemented.
+.\" */
+.\"asmlinkage long sys_io_getevents(io_context_t ctx_id,
+.\" long min_nr,
+.\" long nr,
+.\" struct io_event *events,
+.\" struct timespec *timeout)
+.\"
+.TH io_getevents 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_getevents \- Read resulting events from io requests
.SH SYNOPSIS
@@ -42,38 +42,38 @@ struct io_event {
unsigned PADDED(res2, __pad4);
};
.sp
-.BI "int io_getevents(io_context_t " ctx ", long " nr ", struct io_event *" events "[], struct timespec *" timeout ");"
+.BI "int io_getevents(io_context_t " ctx ", long " nr ", struct io_event *" events "[], struct timespec *" timeout ");"
.fi
.SH DESCRIPTION
Attempts to read up to nr events from
-the completion queue for the aio_context specified by ctx.
+the completion queue for the aio_context specified by \fIctx\fP.
.SH "RETURN VALUES"
May return
-0 if no events are available and the timeout specified
+\fI0\fP if no events are available and the timeout specified
by when has elapsed, where when == NULL specifies an infinite
timeout. Note that the timeout pointed to by when is relative and
will be updated if not NULL and the operation blocks. Will fail
-with ENOSYS if not implemented.
+with \fBENOSYS\fP if not implemented.
.SH ERRORS
.TP
.B EINVAL
-if ctx_id is invalid, if min_nr is out of range,
+If ctx_id is invalid, if min_nr is out of range,
if nr is out of range, if when is out of range.
.TP
.B EFAULT
-if any of the memory specified to is invalid.
+If any of the memory specified to is invalid.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_prep_fsync.3
+++ b/man/io_prep_fsync.3
@@ -1,11 +1,11 @@
-./" static inline void io_prep_fsync(struct iocb *iocb, int fd)
-./" {
-./" memset(iocb, 0, sizeof(*iocb));
-./" iocb->aio_fildes = fd;
-./" iocb->aio_lio_opcode = IO_CMD_FSYNC;
-./" iocb->aio_reqprio = 0;
-./" }
-.TH io_prep_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
+.\" static inline void io_prep_fsync(struct iocb *iocb, int fd)
+.\" {
+.\" memset(iocb, 0, sizeof(*iocb));
+.\" iocb->aio_fildes = fd;
+.\" iocb->aio_lio_opcode = IO_CMD_FSYNC;
+.\" iocb->aio_reqprio = 0;
+.\" }
+.TH io_prep_fsync 3 2009-06-10 "Linux 2.4" Linux AIO"
.SH NAME
io_prep_fsync \- Synchronize a file's complete in-core state with that on disk
.SH SYNOPSYS
@@ -16,7 +16,7 @@ io_prep_fsync \- Synchronize a file's co
.B #include <libaio.h>
.br
.sp
-.BI "static inline void io_prep_fsync(struct iocb *iocb, int fd)"
+.BI "static inline void io_prep_fsync(struct iocb *" iocb ", int " fd ");"
.sp
struct iocb {
void *data;
@@ -28,7 +28,8 @@ struct iocb {
.sp
.fi
.SH DESCRIPTION
-This is an inline convenience function for setting up an iocbv for a FSYNC request.
+This is an inline convenience function for setting up an \fIiocbv\fP for a
+\fBFSYNC\fP request.
.br
The file for which
.TP
@@ -36,33 +37,33 @@ The file for which
is a descriptor is set up with
the command
.TP
-.IR "iocb->aio_lio_opcode = IO_CMD_FSYNC:
+.IR "iocb->aio_lio_opcode = IO_CMD_FSYNC"
.
.PP
-The io_prep_fsync() function shall set up an IO_CMD_FSYNC operation
+The \fBio_prep_fsync\fP() function shall set up an \fBIO_CMD_FSYNC\fP operation
to asynchronously force all I/O
operations associated with the file indicated by the file
-descriptor aio_fildes member of the iocb structure referenced by
+descriptor \fIaio_fildes\fP member of the \fIiocb\fP structure referenced by
the iocb argument and queued at the time of the call to
-io_submit() to the synchronized I/O completion state. The function
+\fBio_submit\fP() to the synchronized I/O completion state. The function
call shall return when the synchronization request has been
initiated or queued to the file or device (even when the data
cannot be synchronized immediately).
All currently queued I/O operations shall be completed as if by a call
-to fsync(); that is, as defined for synchronized I/O file
+to \fBfsync\fP(); that is, as defined for synchronized I/O file
integrity completion. If the
-operation queued by io_prep_fsync() fails, then, as for fsync(),
+operation queued by \fBio_prep_fsync\fP() fails, then, as for \fBfsync\fP(),
outstanding I/O operations are not guaranteed to have
been completed.
-If io_prep_fsync() succeeds, then it is only the I/O that was queued
-at the time of the call to io_submit() that is guaranteed to be
+If \fBio_prep_fsync\fP() succeeds, then it is only the I/O that was queued
+at the time of the call to \fBio_submit\fP() that is guaranteed to be
forced to the relevant completion state. The completion of
subsequent I/O on the file descriptor is not guaranteed to be
completed in a synchronized fashion.
.PP
-This function returns immediately . To schedule the operation, the
+This function returns immediately. To schedule the operation, the
function
.IR io_submit
must be called.
@@ -70,20 +71,20 @@ must be called.
Simultaneous asynchronous operations using the same iocb produce
undefined results.
.SH "RETURN VALUES"
-None
+None.
.SH ERRORS
-None
+None.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_prep_pread.3
+++ b/man/io_prep_pread.3
@@ -1,14 +1,14 @@
-./" static inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
-./" {
-./" memset(iocb, 0, sizeof(*iocb));
-./" iocb->aio_fildes = fd;
-./" iocb->aio_lio_opcode = IO_CMD_PREAD;
-./" iocb->aio_reqprio = 0;
-./" iocb->u.c.buf = buf;
-./" iocb->u.c.nbytes = count;
-./" iocb->u.c.offset = offset;
-./" }
-.TH io_prep_pread 3 2002-09-12 "Linux 2.4" Linux AIO"
+.\" static inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
+.\" {
+.\" memset(iocb, 0, sizeof(*iocb));
+.\" iocb->aio_fildes = fd;
+.\" iocb->aio_lio_opcode = IO_CMD_PREAD;
+.\" iocb->aio_reqprio = 0;
+.\" iocb->u.c.buf = buf;
+.\" iocb->u.c.nbytes = count;
+.\" iocb->u.c.offset = offset;
+.\" }
+.TH io_prep_pread 3 2009-06-10 "Linux 2.4" Linux AIO"
.SH NAME
io_prep_pread \- Set up asynchronous read
.SH SYNOPSYS
@@ -19,7 +19,7 @@ io_prep_pread \- Set up asynchronous rea
.B #include <libaio.h>
.br
.sp
-.BI "inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
+.BI "inline void io_prep_pread(struct iocb *" iocb ", int " fd ", void *" buf ", size_t " count ", long long " offset ");"
"
.sp
struct iocb {
@@ -31,49 +31,43 @@ struct iocb {
};
.fi
.SH DESCRIPTION
-.IR io_prep_pread
+.B io_prep_pread
is an inline convenience function designed to facilitate the initialization of
the iocb for an asynchronous read operation.
The first
-.TP
.IR "iocb->u.c.nbytes = count"
bytes of the file for which
-.TP
.IR "iocb->aio_fildes = fd"
is a descriptor are written to the buffer
starting at
-.TP
-.IR "iocb->u.c.buf = buf"
-.
-.br
+.IR "iocb->u.c.buf = buf" .
Reading starts at the absolute position
-.TP
.IR "ioc->u.c.offset = offset"
in the file.
.PP
-This function returns immediately . To schedule the operation, the
+This function returns immediately. To schedule the operation, the
function
-.IR io_submit
+.B io_submit
must be called.
.PP
-Simultaneous asynchronous operations using the same iocb produce
+Simultaneous asynchronous operations using the same \fIiocb\fP produce
undefined results.
.SH "RETURN VALUES"
-None
+None.
.SH ERRORS
-None
+None.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_prep_pwrite.3
+++ b/man/io_prep_pwrite.3
@@ -1,14 +1,14 @@
-./" static inline void io_prep_pwrite(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
-./" {
-./" memset(iocb, 0, sizeof(*iocb));
-./" iocb->aio_fildes = fd;
-./" iocb->aio_lio_opcode = IO_CMD_PWRITE;
-./" iocb->aio_reqprio = 0;
-./" iocb->u.c.buf = buf;
-./" iocb->u.c.nbytes = count;
-./" iocb->u.c.offset = offset;
-./" }
-.TH io_prep_pwrite 3 2002-09-12 "Linux 2.4" Linux AIO"
+.\" static inline void io_prep_pwrite(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
+.\" {
+.\" memset(iocb, 0, sizeof(*iocb));
+.\" iocb->aio_fildes = fd;
+.\" iocb->aio_lio_opcode = IO_CMD_PWRITE;
+.\" iocb->aio_reqprio = 0;
+.\" iocb->u.c.buf = buf;
+.\" iocb->u.c.nbytes = count;
+.\" iocb->u.c.offset = offset;
+.\" }
+.TH io_prep_pwrite 3 2009-06-10 "Linux 2.4" Linux AIO"
.SH NAME
io_prep_pwrite \- Set up iocb for asynchronous writes
.SH SYNOPSYS
@@ -19,8 +19,8 @@ io_prep_pwrite \- Set up iocb for asynch
.B #include <libaio.h>
.br
.sp
-.BI "inline void io_prep_pwrite(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
-"
+.BI "inline void io_prep_pwrite(struct iocb *" iocb ", int " fd ", void *" buf ", size_t " count ", long long " offset ");"
+.
.sp
struct iocb {
void *data;
@@ -31,26 +31,20 @@ struct iocb {
};
.fi
.SH DESCRIPTION
-io_prep_write is a convenicence function for setting up parallel writes.
+\fBio_prep_write\fP is a convenicence function for setting up parallel writes.
The first
-.TP
.IR "iocb->u.c.nbytes = count"
bytes of the file for which
-.TP
.IR "iocb->aio_fildes = fd"
is a descriptor are written from the buffer
starting at
-.TP
-.IR "iocb->u.c.buf = buf"
-.
-.br
+.IR "iocb->u.c.buf = buf" .
Writing starts at the absolute position
-.TP
.IR "ioc->u.c.offset = offset"
in the file.
.PP
-This function returns immediately . To schedule the operation, the
+This function returns immediately. To schedule the operation, the
function
.IR io_submit
must be called.
@@ -58,20 +52,20 @@ must be called.
Simultaneous asynchronous operations using the same iocb produce
undefined results.
.SH "RETURN VALUES"
-None
+None.
.SH ERRORS
-None
+None.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_queue_init.3
+++ b/man/io_queue_init.3
@@ -1,4 +1,4 @@
-.TH io_queue_init 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.TH io_queue_init 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_queue_init \- Initialize asynchronous io state machine
@@ -10,7 +10,7 @@ io_queue_init \- Initialize asynchronous
.B #include <libaio.h>
.br
.sp
-.BI "int io_queue_init(int maxevents, io_context_t *ctx );"
+.BI "int io_queue_init(int " maxevents ", io_context_t *" ctx ");"
.sp
.fi
.SH DESCRIPTION
@@ -27,7 +27,7 @@ If the operation is successful, *cxtp is
.SH "RETURN VALUES"
On success,
.B io_queue_init
-returns 0. Otherwise, -error is return, where
+returns \fI0\fP. Otherwise, -error is return, where
error is one of the Exxx values defined in the Errors section.
.SH ERRORS
.TP
@@ -37,27 +37,27 @@ referenced data outside of the program's
.TP
.B EINVAL
.I maxevents
-is <= 0 or
+is <= \fI0\fP or
.IR ctx
-is an invalid memory locattion.
+is an invalid memory location.
.TP
.B ENOSYS
-Not implemented
+Not implemented.
.TP
.B EAGAIN
.IR "maxevents > max_aio_reqs"
where max_aio_reqs is a tunable value.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_queue_release.3
+++ b/man/io_queue_release.3
@@ -1,4 +1,4 @@
-.TH io_queue_release 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.TH io_queue_release 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_queue_release \- Release the context associated with the userspace handle
.SH SYNOPSIS
@@ -8,41 +8,41 @@ io_queue_release \- Release the context
.B #include <libaio.h>
.br
.sp
-.BI "int io_queue_release(io_context_t ctx)"
+.BI "int io_queue_release(io_context_t " ctx ");"
.sp
.SH DESCRIPTION
.B io_queue_release
-destroys the context associated with the userspace handle. May cancel any outstanding
+destroys the context associated with the userspace handle. May cancel any outstanding
AIOs and block on completion.
.B cts.
.SH "RETURN VALUES"
On success,
.B io_queue_release
-returns 0. Otherwise, -error is return, where
+returns \fI0\fP. Otherwise, -error is return, where
error is one of the Exxx values defined in the Errors section.
.SH ERRORS
.TP
.B EINVAL
.I ctx
-refers to an unitialized aio context, the iocb pointed to by
+refers to an unitialized aio context, the \fIiocb\fP pointed to by
.I iocbs
-contains an improperly initialized iocb,
+contains an improperly initialized \fIiocb\fP.
.TP
.B ENOSYS
-Not implemented
+Not implemented.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_run(3),
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_run (3),
.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_queue_run.3
+++ b/man/io_queue_run.3
@@ -1,4 +1,4 @@
-.TH io_queue_run 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.TH io_queue_run 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_queue_run \- Handle completed io requests
.SH SYNOPSIS
@@ -9,17 +9,17 @@ io_queue_run \- Handle completed io requ
.B #include <libaio.h>
.br
.sp
-.BI "int io_queue_run(io_context_t ctx );"
+.BI "int io_queue_run(io_context_t " ctx_id ");"
.sp
.fi
.SH DESCRIPTION
.B io_queue_run
-Attempts to read all the events events from
-the completion queue for the aio_context specified by ctx_id.
+Attempts to read all the events events from
+the completion queue for the aio_context specified by \fIctx_id\fP.
.SH "RETURN VALUES"
May return
-0 if no events are available.
-Will fail with -ENOSYS if not implemented.
+\fI0\fP if no events are available.
+Will fail with -\fBENOSYS\fP if not implemented.
.SH ERRORS
.TP
.B EFAULT
@@ -27,24 +27,24 @@ Will fail with -ENOSYS if not implemente
referenced data outside of the program's accessible address space.
.TP
.B EINVAL
-.I ctx
-refers to an unitialized aio context, the iocb pointed to by
+.I ctx_id
+refers to an unitialized aio context, the \fIiocb\fP pointed to by
.I iocbs
-contains an improperly initialized iocb,
+contains an improperly initialized iocb.
.TP
.B ENOSYS
-Not implemented
+Not implemented.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_queue_wait.3
+++ b/man/io_queue_wait.3
@@ -1,4 +1,4 @@
-.TH io_queue_wait 2 2002-09-03 "Linux 2.4" "Linux AIO"
+.TH io_queue_wait 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_queue_wait \- Wait for io requests to complete
.SH SYNOPSIS
@@ -9,22 +9,22 @@ io_queue_wait \- Wait for io requests to
.B #include <libaio.h>
.br
.sp
-.BI "int io_queue_wait(io_context_t ctx, const struct timespec *timeout);"
+.BI "int io_queue_wait(io_context_t " ctx_id ", const struct timespec *" timeout ");"
.fi
.SH DESCRIPTION
-Attempts to read an event from
-the completion queue for the aio_context specified by ctx_id.
+Attempts to read an event from
+the completion queue for the aio_context specified by \fIctx_id\fP.
.SH "RETURN VALUES"
May return
-0 if no events are available and the timeout specified
+\fI0\fP if no events are available and the timeout specified
by when has elapsed, where when == NULL specifies an infinite
-timeout. Note that the timeout pointed to by when is relative and
+\fItimeout\fP. Note that the \fItimeout\fP pointed to by when is relative and
will be updated if not NULL and the operation blocks. Will fail
-with -ENOSYS if not implemented.
+with -\fBENOSYS\fP if not implemented.
.SH "RETURN VALUES"
On success,
.B io_queue_wait
-returns 0. Otherwise, -error is return, where
+returns \fI0\fP. Otherwise, -error is return, where
error is one of the Exxx values defined in the Errors section.
.SH ERRORS
.TP
@@ -33,24 +33,24 @@ error is one of the Exxx values defined
referenced data outside of the program's accessible address space.
.TP
.B EINVAL
-.I ctx
-refers to an unitialized aio context, the iocb pointed to by
+.I ctx_id
+refers to an unitialized aio context, the \fIiocb\fP pointed to by
.I iocbs
-contains an improperly initialized iocb,
+contains an improperly initialized iocb.
.TP
.B ENOSYS
-Not implemented
+Not implemented.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_set_callback (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_set_callback.3
+++ b/man/io_set_callback.3
@@ -1,5 +1,5 @@
-./"static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)
-.TH io_set_callback 3 2002-09-12 "Linux 2.4" Linux AIO"
+.\"static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)
+.TH io_set_callback 3 2009-06-10 "Linux 2.4" Linux AIO"
.SH NAME
io_set_callback \- Set up io completion callback function
.SH SYNOPSYS
@@ -10,7 +10,7 @@ io_set_callback \- Set up io completion
.B #include <libaio.h>
.br
.sp
-.BI "static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)"
+.BI "static inline void io_set_callback(struct iocb *" iocb ", io_callback_t " cb ");"
.sp
struct iocb {
void *data;
@@ -25,20 +25,22 @@ typedef void (*io_callback_t)(io_context
.fi
.SH DESCRIPTION
The callback is not done if the caller uses raw events from
-io_getevents, only with the library helpers
+\fBio_getevents\fP, only with the library helpers.
.SH "RETURN VALUES"
+None.
.SH ERRORS
+None.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_submit(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_submit (3),
+.BR errno (3).
--- a/man/io_setup.1
+++ b/man/io_setup.1
@@ -1,15 +1,15 @@
-./"/* sys_io_setup:
-./" * Create an aio_context capable of receiving at least nr_events.
-./" * ctxp must not point to an aio_context that already exists, and
-./" * must be initialized to 0 prior to the call. On successful
-./" * creation of the aio_context, *ctxp is filled in with the resulting
-./" * handle. May fail with -EINVAL if *ctxp is not initialized,
-./" * if the specified nr_events exceeds internal limits. May fail
-./" * with -EAGAIN if the specified nr_events exceeds the user's limit
-./" * of available events. May fail with -ENOMEM if insufficient kernel
-./" * resources are available. May fail with -EFAULT if an invalid
-./" * pointer is passed for ctxp. Will fail with -ENOSYS if not
-./" * implemented.
-./" */
-./" -- note: libaio is actually providing io_queue_init and io_queue_grow
-./" as separate functions. For now io_setup is the same as io_queue_grow.
+.\"/* sys_io_setup:
+.\" * Create an aio_context capable of receiving at least nr_events.
+.\" * ctxp must not point to an aio_context that already exists, and
+.\" * must be initialized to 0 prior to the call. On successful
+.\" * creation of the aio_context, *ctxp is filled in with the resulting
+.\" * handle. May fail with -EINVAL if *ctxp is not initialized,
+.\" * if the specified nr_events exceeds internal limits. May fail
+.\" * with -EAGAIN if the specified nr_events exceeds the user's limit
+.\" * of available events. May fail with -ENOMEM if insufficient kernel
+.\" * resources are available. May fail with -EFAULT if an invalid
+.\" * pointer is passed for ctxp. Will fail with -ENOSYS if not
+.\" * implemented.
+.\" */
+.\" -- note: libaio is actually providing io_queue_init and io_queue_grow
+.\" as separate functions. For now io_setup is the same as io_queue_grow.
--- a/man/io_submit.1
+++ b/man/io_submit.1
@@ -1,4 +1,4 @@
-.TH io_submit 2 2002-09-02 "Linux 2.4" "Linux AIO"
+.TH io_submit 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_submit \- submit io requests
.SH SYNOPSIS
@@ -44,7 +44,7 @@ callback function.
.I aio_lio_opcode
is the I/O operation requested. Callers will typically set this and the
arguments to the I/O operation calling the
-.BR io_prep_ (3)
+.BR io_prep_ *(3)
function corresponding to the operation.
.sp
.I aio_reqprio
@@ -106,4 +106,4 @@ Insufficient resources were available to
.BR io_prep_fdsync (3),
.BR io_prep_noop (3),
.BR io_cancel (2),
-.BR errno (3)
+.BR errno (3).
--- a/man/io_submit.3
+++ b/man/io_submit.3
@@ -1,16 +1,16 @@
-./"/* sys_io_submit:
-./" * Queue the nr iocbs pointed to by iocbpp for processing. Returns
-./" * the number of iocbs queued. May return -EINVAL if the aio_context
-./" * specified by ctx_id is invalid, if nr is < 0, if the iocb at
-./" * *iocbpp[0] is not properly initialized, if the operation specified
-./" * is invalid for the file descriptor in the iocb. May fail with
-./" * -EFAULT if any of the data structures point to invalid data. May
-./" * fail with -EBADF if the file descriptor specified in the first
-./" * iocb is invalid. May fail with -EAGAIN if insufficient resources
-./" * are available to queue any iocbs. Will return 0 if nr is 0. Will
-./" * fail with -ENOSYS if not implemented.
-./" */
-.TH io_submit 2 2002-09-02 "Linux 2.4" "Linux AIO"
+.\"/* sys_io_submit:
+.\" * Queue the nr iocbs pointed to by iocbpp for processing. Returns
+.\" * the number of iocbs queued. May return -EINVAL if the aio_context
+.\" * specified by ctx_id is invalid, if nr is < 0, if the iocb at
+.\" * *iocbpp[0] is not properly initialized, if the operation specified
+.\" * is invalid for the file descriptor in the iocb. May fail with
+.\" * -EFAULT if any of the data structures point to invalid data. May
+.\" * fail with -EBADF if the file descriptor specified in the first
+.\" * iocb is invalid. May fail with -EAGAIN if insufficient resources
+.\" * are available to queue any iocbs. Will return 0 if nr is 0. Will
+.\" * fail with -ENOSYS if not implemented.
+.\" */
+.TH io_submit 2 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
io_submit \- Submit io requests
.SH SYNOPSIS
@@ -49,12 +49,12 @@ gets the
.IR "nr"
requests from the array pointed to
by
-.IR "iocbs"
-. The operation to be performed is determined by the
+.IR "iocbs" .
+The operation to be performed is determined by the
.IR "aio_lio_opcode"
member in each element of
-.IR "iocbs"
-. If this
+.IR "iocbs" .
+If this
field is
.B "IO_CMD_PREAD"
a read operation is enqueued, similar to a call
@@ -120,16 +120,16 @@ The iocb contains a file descriptor that
.B EINVAL
The file specified in the iocb does not support the given io operation.
.SH "SEE ALSO"
-.BR io(3),
-.BR io_cancel(3),
-.BR io_fsync(3),
-.BR io_getevents(3),
-.BR io_prep_fsync(3),
-.BR io_prep_pread(3),
-.BR io_prep_pwrite(3),
-.BR io_queue_init(3),
-.BR io_queue_release(3),
-.BR io_queue_run(3),
-.BR io_queue_wait(3),
-.BR io_set_callback(3),
-.BR errno(3)
+.BR io (3),
+.BR io_cancel (3),
+.BR io_fsync (3),
+.BR io_getevents (3),
+.BR io_prep_fsync (3),
+.BR io_prep_pread (3),
+.BR io_prep_pwrite (3),
+.BR io_queue_init (3),
+.BR io_queue_release (3),
+.BR io_queue_run (3),
+.BR io_queue_wait (3),
+.BR io_set_callback (3),
+.BR errno (3).
--- a/man/lio_listio64.3
+++ b/man/lio_listio64.3
@@ -1,4 +1,4 @@
-.TH lio_listio64 3 2002-09-12 "Linux 2.4" Linux AIO"
+.TH lio_listio64 3 2009-06-10 "Linux 2.4" "Linux AIO"
.SH NAME
lio_listio64 \- List directed I/O
.SH SYNOPSYS
@@ -6,31 +6,31 @@ lio_listio64 \- List directed I/O
.br
.B #include <libaio.h>
.LP
-.BI "int lio_listio64 (int mode, struct aiocb *const list[], int nent, struct sigevent *sig)"
+.BI "int lio_listio64 (int " mode ", struct aiocb *const " list "[], int " nent ", struct sigevent *" sig ");"
.nf
.SH DESCRIPTION
This function is similar to the
-.IR "code{lio_listio"
+.BR lio_listio
function. The only
difference is that on
.IR "32 bit"
machines, the file descriptor should
be opened in the large file mode. Internally,
-.IR "lio_listio64"
+.BR lio_listio64
uses
functionality equivalent to
-.IR lseek64"
+.BR lseek64
to position the file descriptor correctly for the reading or
writing, as opposed to
-.IR "lseek"
+.BR lseek
functionality used in
-.IR "lio_listio".
+.BR lio_listio .
When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
+.IR "_FILE_OFFSET_BITS == 64" ,
+this
function is available under the name
-.IR "lio_listio"
+.BR lio_listio
and so
transparently replaces the interface for small files on 32 bit
machines.
Reference in New Issue View Git Blame Copy Permalink