aboutsummaryrefslogtreecommitdiffstats
path: root/tools/libaio/man
diff options
context:
space:
mode:
authorIan Campbell <ian.campbell@citrix.com>2013-07-31 16:15:51 +0100
committerIan Campbell <ian.campbell@citrix.com>2013-08-20 15:34:03 +0100
commit3d4678108a2157db6ae8c290897f67aaed14cdfa (patch)
treee5ce4b22b9fc9f68036937aa931059aee6c79491 /tools/libaio/man
parent03145f0fe42c007834c1ef50d95fe6c4f58a326a (diff)
downloadxen-3d4678108a2157db6ae8c290897f67aaed14cdfa.tar.gz
xen-3d4678108a2157db6ae8c290897f67aaed14cdfa.tar.bz2
xen-3d4678108a2157db6ae8c290897f67aaed14cdfa.zip
tools: remove in tree libaio
We have defaulted to using the system libaio for a while now and I din't think there are any relevant distros which don't have it that running Xen 4.4 would be reasonable on. Also it has caused confusion because it is not ever wanted on ARM, but the build system doesn't express that (could be fixed, but deleting is the right thing to do anyway). Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Reviewed-by: Andrew Cooper <andrew.cooper3@citrix.com> Acked-by: Matt Wilson <msw@amazon.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
Diffstat (limited to 'tools/libaio/man')
-rw-r--r--tools/libaio/man/aio.3315
-rw-r--r--tools/libaio/man/aio_cancel.3137
-rw-r--r--tools/libaio/man/aio_cancel64.350
-rw-r--r--tools/libaio/man/aio_error.381
-rw-r--r--tools/libaio/man/aio_error64.364
-rw-r--r--tools/libaio/man/aio_fsync.3139
-rw-r--r--tools/libaio/man/aio_fsync64.351
-rw-r--r--tools/libaio/man/aio_init.396
-rw-r--r--tools/libaio/man/aio_read.3146
-rw-r--r--tools/libaio/man/aio_read64.360
-rw-r--r--tools/libaio/man/aio_return.371
-rw-r--r--tools/libaio/man/aio_return64.351
-rw-r--r--tools/libaio/man/aio_suspend.3123
-rw-r--r--tools/libaio/man/aio_suspend64.351
-rw-r--r--tools/libaio/man/aio_write.3176
-rw-r--r--tools/libaio/man/aio_write64.361
-rw-r--r--tools/libaio/man/io.3351
-rw-r--r--tools/libaio/man/io_cancel.121
-rw-r--r--tools/libaio/man/io_cancel.365
-rw-r--r--tools/libaio/man/io_destroy.117
-rw-r--r--tools/libaio/man/io_fsync.382
-rw-r--r--tools/libaio/man/io_getevents.129
-rw-r--r--tools/libaio/man/io_getevents.379
-rw-r--r--tools/libaio/man/io_prep_fsync.389
-rw-r--r--tools/libaio/man/io_prep_pread.379
-rw-r--r--tools/libaio/man/io_prep_pwrite.377
-rw-r--r--tools/libaio/man/io_queue_init.363
-rw-r--r--tools/libaio/man/io_queue_release.348
-rw-r--r--tools/libaio/man/io_queue_run.350
-rw-r--r--tools/libaio/man/io_queue_wait.356
-rw-r--r--tools/libaio/man/io_set_callback.344
-rw-r--r--tools/libaio/man/io_setup.115
-rw-r--r--tools/libaio/man/io_submit.1109
-rw-r--r--tools/libaio/man/io_submit.3135
-rw-r--r--tools/libaio/man/lio_listio.3229
-rw-r--r--tools/libaio/man/lio_listio64.339
36 files changed, 0 insertions, 3349 deletions
diff --git a/tools/libaio/man/aio.3 b/tools/libaio/man/aio.3
deleted file mode 100644
index 6dc3c63a8f..0000000000
--- a/tools/libaio/man/aio.3
+++ /dev/null
@@ -1,315 +0,0 @@
-.TH aio 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio \- Asynchronous IO
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.fi
-.SH DESCRIPTION
-The POSIX.1b standard defines a new set of I/O operations which can
-significantly reduce the time an application spends waiting at I/O. The
-new functions allow a program to initiate one or more I/O operations and
-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"
-.
-
-These functions are part of the library with realtime functions named
-.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
-.IR "libpthread"
-in addition to
-.IR "librt"
-and
-.IR "libaio"
-.
-
-All AIO 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 aiocb"
-It is defined in
-.IR "aio.h"
- as follows.
-
-.nf
-struct aiocb
-{
- int aio_fildes; /* File desriptor. */
- int aio_lio_opcode; /* Operation to be performed. */
- int aio_reqprio; /* Request priority offset. */
- volatile void *aio_buf; /* Location of buffer. */
- size_t aio_nbytes; /* Length of transfer. */
- struct sigevent aio_sigevent; /* Signal number and value. */
-
- /* Internal members. */
- struct aiocb *__next_prio;
- int __abs_prio;
- int __policy;
- int __error_code;
- __ssize_t __return_value;
-
-#ifndef __USE_FILE_OFFSET64
- __off_t aio_offset; /* File offset. */
- char __pad[sizeof (__off64_t) - sizeof (__off_t)];
-#else
- __off64_t aio_offset; /* File offset. */
-#endif
- char __unused[32];
-};
-
-.fi
-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
-depending upon these elements is not portable and is highly deprecated.
-
-.TP
-.IR "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.
-
-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
-.IR "lseek"
- 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
-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 "volatile void *aio_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 "size_t aio_nbytes"
-This element specifies the length of the buffer pointed to by
-.IR "aio_buf"
-.
-.TP
-.IR "int aio_reqprio"
-If the platform has defined
-.B "_POSIX_PRIORITIZED_IO"
-and
-.B "_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
-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
-.B "SIGEV_NONE"
-, no notification is sent. If it is
-.B "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
-is created which starts executing the function pointed to by
-.IR "sigev_notify_function"
-.
-.TP
-.IR "int aio_lio_opcode"
-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 each operation can be
-input or output (or nothing), the information must be stored in the
-control block. The possible values are:
-.TP
-.B "LIO_READ"
-Start a read operation. Read from the file at position
-.IR "aio_offset"
- and store the next
-.IR "aio_nbytes"
- bytes in the
-buffer pointed to by
-.IR "aio_buf"
-.
-.TP
-.B "LIO_WRITE"
-Start a write operation. Write
-.IR "aio_nbytes"
-bytes starting at
-.IR "aio_buf"
-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
-.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
-.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
-.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.
-
-.nf
-/* The same for the 64bit offsets. Please note that the members aio_fildes
- to __return_value have to be the same in aiocb and aiocb64. */
-#ifdef __USE_LARGEFILE64
-struct aiocb64
-{
- int aio_fildes; /* File desriptor. */
- int aio_lio_opcode; /* Operation to be performed. */
- int aio_reqprio; /* Request priority offset. */
- volatile void *aio_buf; /* Location of buffer. */
- size_t aio_nbytes; /* Length of transfer. */
- struct sigevent aio_sigevent; /* Signal number and value. */
-
- /* Internal members. */
- struct aiocb *__next_prio;
- int __abs_prio;
- int __policy;
- int __error_code;
- __ssize_t __return_value;
-
- __off64_t aio_offset; /* File offset. */
- char __unused[32];
-};
-
-.fi
-.TP
-.IR "int aio_fildes"
-This element specifies the file descriptor which is used for the
-operation. It must be a legal descriptor since otherwise the operation
-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
-.IR "lseek"
- call would lead to an error.
-.TP
-.IR "off64_t aio_offset"
-This element specifies at which offset in the file the operation (input
-or output) is performed. Since the operation are carried 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 "volatile void *aio_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 "size_t aio_nbytes"
-This element specifies the length of the buffer pointed to by
-.IR "aio_buf"
-.
-.TP
-.IR "int aio_reqprio"
-If for the platform
-.B "_POSIX_PRIORITIZED_IO"
-and
-.B "_POSIX_PRIORITY_SCHEDULING"
-are defined 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
-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
-.B "SIGEV_NONE"
-no notification is sent. If it is
-.B "SIGEV_SIGNAL"
-,
-the signal determined by
-.IR "sigev_signo"
-is sent. Otherwise,
-.IR "sigev_notify"
- must be
-.B "SIGEV_THREAD"
-in which case a thread
-which starts executing the function pointed to by
-.IR "sigev_notify_function"
-.
-.TP
-.IR "int aio_lio_opcode"
-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
-.IR "struct aiocb"
-for a description
-of the possible values.
-.PP
-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.
-.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),
diff --git a/tools/libaio/man/aio_cancel.3 b/tools/libaio/man/aio_cancel.3
deleted file mode 100644
index 502c83c3da..0000000000
--- a/tools/libaio/man/aio_cancel.3
+++ /dev/null
@@ -1,137 +0,0 @@
-.TH aio_cancel 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_cancel - Cancel asynchronous I/O requests
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_cancel (int fildes " , struct aiocb *aiocbp " )"
-.fi
-.SH DESCRIPTION
-When one or more requests are asynchronously processed, it might be
-useful in some situations to cancel a selected operation, e.g., if it
-becomes obvious that the written data is no longer accurate and would
-have to be overwritten soon. As an example, assume an application, which
-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.
-The POSIX AIO implementation provides such a function, but this function
-is not capable of forcing the cancellation of the request. It is up to the
-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".
-.PP
-The
-.IR aio_cancel
-function can be used to cancel one or more
-outstanding requests. If the
-.IR aiocbp
-parameter is
-.IR NULL
-, the
-function tries to cancel all of the outstanding requests which would process
-the file descriptor
-.IR fildes
-(i.e., whose
-.IR aio_fildes
-member
-is
-.IR fildes
-). If
-.IR aiocbp is not
-.IR NULL
-,
-.IR aio_cancel
-attempts to cancel the specific request pointed to by
-.IR aiocbp.
-
-For requests which were successfully canceled, the normal notification
-about the termination of the request should take place. I.e., depending
-on the
-.IR "struct sigevent"
-object which controls this, nothing
-happens, a signal is sent or a thread is started. If the request cannot
-be canceled, it terminates the usual way after performing the operation.
-After a request is successfully canceled, a call to
-.IR aio_error
-with
-a reference to this request as the parameter will return
-.B ECANCELED
-and a call to
-.IR aio_return
-will return
-.IR -1.
-If the request wasn't canceled and is still running the error status is
-still
-.B EINPROGRESS.
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
-function is in fact
-.IR aio_cancel64
-since the LFS interface
-transparently replaces the normal implementation.
-
-.SH "RETURN VALUES"
-.TP
-.B AIO_CANCELED
-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
-.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.
-.TP
-.B AIO_ALLDONE
-If all
-requests already terminated at the time
-.IR aio_cancel
-is called the
-return value is
-.
-.SH ERRORS
-If an error occurred during the execution of
-.IR aio_cancel
-the
-function returns
-.IR -1
-and sets
-.IR errno
-to one of the following
-values.
-.TP
-.B EBADF
-The file descriptor
-.IR fildes
-is not valid.
-.TP
-.B ENOSYS
-.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),
diff --git a/tools/libaio/man/aio_cancel64.3 b/tools/libaio/man/aio_cancel64.3
deleted file mode 100644
index ede775be5e..0000000000
--- a/tools/libaio/man/aio_cancel64.3
+++ /dev/null
@@ -1,50 +0,0 @@
-.TH aio_cancel64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_cancel64 \- Cancel asynchronous I/O requests
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.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
-.
-
-When the sources are compiled with
-.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).
-.SH ERRORS
-See 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),
diff --git a/tools/libaio/man/aio_error.3 b/tools/libaio/man/aio_error.3
deleted file mode 100644
index 12b82cf894..0000000000
--- a/tools/libaio/man/aio_error.3
+++ /dev/null
@@ -1,81 +0,0 @@
-.TH aio_error 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_error \- Getting the Status of AIO Operations
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_error (const struct aiocb *aiocbp)"
-.fi
-.SH DESCRIPTION
-The function
-.IR aio_error
-determines the error state of the request described by the
-.IR "struct aiocb"
-variable pointed to by
-.I aiocbp
-.
-
-When the operation is performed truly asynchronously (as with
-.IR "aio_read"
-and
-.IR "aio_write"
-and with
-.IR "lio_listio"
-when the mode is
-.IR "LIO_NOWAIT"
-), one sometimes needs to know whether a
-specific request already terminated and if so, what the result was.
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this function is in fact
-.IR "aio_error64"
-since the LFS interface transparently replaces the normal implementation.
-.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 "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"
-.
-.SH ERRORS
-.TP
-.IR "ENOSYS"
-if it is not implemented. It
-could also return
-.TP
-.IR "EINVAL"
-if the
-.I aiocbp
-parameter does not
-refer to an asynchronous operation whose return status is not yet known.
-.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(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),
diff --git a/tools/libaio/man/aio_error64.3 b/tools/libaio/man/aio_error64.3
deleted file mode 100644
index 3333161d9a..0000000000
--- a/tools/libaio/man/aio_error64.3
+++ /dev/null
@@ -1,64 +0,0 @@
-.TH aio_error64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_error64 \- Return errors
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.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".
-.PP
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is available under the name
-.IR aio_error
-and so
-transparently replaces the interface for small files on 32 bit
-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 "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"
-.
-.SH ERRORS
-See
-.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),
diff --git a/tools/libaio/man/aio_fsync.3 b/tools/libaio/man/aio_fsync.3
deleted file mode 100644
index 637f0f63d4..0000000000
--- a/tools/libaio/man/aio_fsync.3
+++ /dev/null
@@ -1,139 +0,0 @@
-.TH aio_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_fsync \- Synchronize a file's complete in-core state with that on disk
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_fsync (int op, struct aiocb aiocbp)"
-.fi
-.SH DESCRIPTION
-.PP
-When dealing with asynchronous operations it is sometimes necessary to
-get into a consistent state. This would mean for AIO that one wants to
-know whether a certain request or a group of request were processed.
-This could be done by waiting for the notification sent by the system
-after the operation terminated, but this sometimes would mean wasting
-resources (mainly computation time). Instead POSIX.1b defines two
-functions which will help with most kinds of consistency.
-.PP
-The
-.IR aio_fsync
-and
-.IR "aio_fsync64"
-functions are only available
-if the symbol
-.IR "_POSIX_SYNCHRONIZED_IO"
-is defined in
-.I unistd.h
-.
-
-Calling this function forces all I/O operations operating queued at the
-time of the function call operating on the file descriptor
-.IR "aiocbp->aio_fildes"
-into the synchronized I/O completion state . The
-.IR "aio_fsync"
-function returns
-immediately but the notification through the method described in
-.IR "aiocbp->aio_sigevent"
-will happen only after all requests for this
-file descriptor have terminated and the file is synchronized. This also
-means that requests for this very same file descriptor which are queued
-after the synchronization request are not affected.
-
-If
-.IR "op"
-is
-.IR "O_DSYNC"
-the synchronization happens as with a call
-to
-.IR "fdatasync"
-. Otherwise
-.IR "op"
-should be
-.IR "O_SYNC"
-and
-the synchronization happens as with
-.IR "fsync"
-.
-
-As long as the synchronization has not happened, a call to
-.IR "aio_error"
-with the reference to the object pointed to by
-.IR "aiocbp"
-returns
-.IR "EINPROGRESS"
-. Once the synchronization is
-done
-.IR "aio_error"
-return
-.IR 0
-if the synchronization was not
-successful. Otherwise the value returned is the value to which the
-.IR "fsync"
-or
-.IR "fdatasync"
-function would have set the
-.IR "errno"
-variable. In this case nothing can be assumed about the
-consistency for the data written to this file descriptor.
-
-.SH "RETURN VALUES"
-The return value of this function is
-.IR 0
-if the request was
-successfully enqueued. Otherwise the return value is
-.IR -1
-and
-.IR "errno".
-.SH ERRORS
-.TP
-.B EAGAIN
-The request could not be enqueued due to temporary lack of resources.
-.TP
-.B EBADF
-The file descriptor
-.IR "aiocbp->aio_fildes"
-is not valid or not open
-for writing.
-.TP
-.B EINVAL
-The implementation does not support I/O synchronization or the
-.IR "op"
-parameter is other than
-.IR "O_DSYNC"
-and
-.IR "O_SYNC"
-.
-.TP
-.B ENOSYS
-This function is not implemented.
-.PP
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
- this
-function is in fact
-.IR "aio_return64"
-since the LFS interface
-transparently replaces the normal implementation.
-.SH "SEE ALSO"
-.BR aio(3),
-.BR aio_cancel(3),
-.BR aio_cancel64(3),
-.BR aio_error(3),
-.BR aio_error64(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),
diff --git a/tools/libaio/man/aio_fsync64.3 b/tools/libaio/man/aio_fsync64.3
deleted file mode 100644
index 5dce22dda9..0000000000
--- a/tools/libaio/man/aio_fsync64.3
+++ /dev/null
@@ -1,51 +0,0 @@
-.TH aio_fsync64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_fsync64 \- Synchronize a file's complete in-core state with that on disk
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_fsync64 (int op, struct aiocb64 *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function is similar to
-.IR aio_fsync
-with the only difference
-that the argument is a reference to a variable of type
-.IR "struct aiocb64".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is available under the name
-.IR aio_fsync
-and so
-transparently replaces the interface for small files on 32 bit
-machines.
-.SH "RETURN VALUES"
-See
-.IR aio_fsync.
-.SH ERRORS
-See
-.IR aio_fsync.
-.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),
diff --git a/tools/libaio/man/aio_init.3 b/tools/libaio/man/aio_init.3
deleted file mode 100644
index 3b0ec95a83..0000000000
--- a/tools/libaio/man/aio_init.3
+++ /dev/null
@@ -1,96 +0,0 @@
-.TH aio_init 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_init \- How to optimize the AIO implementation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "void aio_init (const struct aioinit *init)"
-.fi
-.SH DESCRIPTION
-
-The POSIX standard does not specify how the AIO functions are
-implemented. They could be system calls, but it is also possible to
-emulate them at userlevel.
-
-At the point of this writing, the available implementation is a userlevel
-implementation which uses threads for handling the enqueued requests.
-While this implementation requires making some decisions about
-limitations, hard limitations are something which is best avoided
-in the GNU C library. Therefore, the GNU C library provides a means
-for tuning the AIO implementation according to the individual use.
-
-.BI "struct aioinit"
-.PP
-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
-function.
-.TP
-.B "int aio_threads"
-This member specifies the maximal number of threads which may be used
-at any one time.
-.TP
-.B "int aio_num"
-This number provides an estimate on the maximal number of simultaneously
-enqueued requests.
-.TP
-.B "int aio_locks"
-Unused.
-.TP
-.B "int aio_usedba"
-Unused.
-.TP
-.B "int aio_debug"
-Unused.
-.TP
-.B "int aio_numusers"
-Unused.
-.TP
-.B "int aio_reserved[2]"
-Unused.
-.PP
-This function must be called before any other AIO function. Calling it
-is completely voluntary, as it is only meant to help the AIO
-implementation perform better.
-
-Before calling the
-.IR aio_init
-, function the members of a variable of
-type
-.IR "struct aioinit"
-must be initialized. Then a reference to
-this variable is passed as the parameter to
-.IR 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.
-.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),
diff --git a/tools/libaio/man/aio_read.3 b/tools/libaio/man/aio_read.3
deleted file mode 100644
index 5bcb6c8a11..0000000000
--- a/tools/libaio/man/aio_read.3
+++ /dev/null
@@ -1,146 +0,0 @@
-.TH aio_read 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_read \- Initiate an asynchronous read operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_read (struct aiocb *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function initiates an asynchronous read operation. It
-immediately returns after the operation was enqueued or when an
-error was encountered.
-
-The first
-.IR "aiocbp->aio_nbytes"
-bytes of the file for which
-.IR "aiocbp->aio_fildes"
-is a descriptor are written to the buffer
-starting at
-.IR "aiocbp->aio_buf"
-. Reading starts at the absolute
-position
-.IR "aiocbp->aio_offset"
-in the file.
-
-If prioritized I/O is supported by the platform the
-.IR "aiocbp->aio_reqprio"
-value is used to adjust the priority before
-the request is actually enqueued.
-
-The calling process is notified about the termination of the read
-request according to the
-.IR "aiocbp->aio_sigevent"
-value.
-
-.SH "RETURN VALUES"
-When
-.IR "aio_read"
-returns, the return value is zero if no error
-occurred that can be found before the process is enqueued. If such an
-early error is found, the function returns
-.IR -1
-and sets
-.IR "errno".
-
-.PP
-If
-.IR "aio_read"
-returns zero, the current status of the request
-can be queried using
-.IR "aio_error"
-and
-.IR "aio_return"
-functions.
-As long as the value returned by
-.IR "aio_error"
-is
-.IR "EINPROGRESS"
-the operation has not yet completed. If
-.IR "aio_error"
-returns zero,
-the operation successfully terminated, otherwise the value is to be
-interpreted as an error code. If the function terminated, the result of
-the operation can be obtained using a call to
-.IR "aio_return"
-. The
-returned value is the same as an equivalent call to
-.IR "read"
-would
-have returned.
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is in fact
-.IR "aio_read64"
-since the LFS interface transparently
-replaces the normal implementation.
-
-.SH ERRORS
-In the case of an early error:
-.TP
-.B EAGAIN
-The request was not enqueued due to (temporarily) exceeded resource
-limitations.
-.TP
-.B ENOSYS
-The
-.IR "aio_read"
-function is not implemented.
-.TP
-.B EBADF
-The
-.IR "aiocbp->aio_fildes"
-descriptor is not valid. This condition
-need not be recognized before enqueueing the request and so this error
-might also be signaled asynchronously.
-.TP
-.B EINVAL
-The
-.IR "aiocbp->aio_offset"
-or
-.IR "aiocbp->aio_reqpiro"
-value is
-invalid. This condition need not be recognized before enqueueing the
-request and so this error might also be signaled asynchronously.
-
-.PP
-In the case of a normal return, possible error codes returned by
-.IR "aio_error"
-are:
-.TP
-.B EBADF
-The
-.IR "aiocbp->aio_fildes"
-descriptor is not valid.
-.TP
-.B ECANCELED
-The operation was canceled before the operation was finished
-.TP
-.B EINVAL
-The
-.IR "aiocbp->aio_offset"
-value is invalid.
-.PP
-.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_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),
diff --git a/tools/libaio/man/aio_read64.3 b/tools/libaio/man/aio_read64.3
deleted file mode 100644
index 8e407a5591..0000000000
--- a/tools/libaio/man/aio_read64.3
+++ /dev/null
@@ -1,60 +0,0 @@
-.TH aio_read64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_read64 \- Initiate an asynchronous read operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_read64 (struct aiocb *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function is similar to the
-.IR "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"
-uses
-functionality equivalent to
-.IR "lseek64"
-to position the file descriptor correctly for the reading,
-as opposed to
-.IR "lseek"
-functionality used in
-.IR "aio_read".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
-function is available under the name
-.IR "aio_read"
-and so transparently
-replaces the interface for small files on 32 bit machines.
-.SH "RETURN VALUES"
-See
-.IR aio_read.
-.SH ERRORS
-See
-.IR aio_read.
-.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),
diff --git a/tools/libaio/man/aio_return.3 b/tools/libaio/man/aio_return.3
deleted file mode 100644
index 1e3335fdb6..0000000000
--- a/tools/libaio/man/aio_return.3
+++ /dev/null
@@ -1,71 +0,0 @@
-.TH aio_return 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_return \- Retrieve status of asynchronous I/O operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "ssize_t aio_return (const struct aiocb *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function can be used to retrieve the return status of the operation
-carried out by the request described in the variable pointed to by
-.IR aiocbp
-. As long as the error status of this request as returned
-by
-.IR aio_error
-is
-.IR EINPROGRESS
-the return of this function is
-undefined.
-
-Once the request is finished this function can be used exactly once to
-retrieve the return value. Following calls might lead to undefined
-behavior.
-When the sources are compiled with
-.B "_FILE_OFFSET_BITS == 64"
-this function is in fact
-.IR aio_return64
-since the LFS interface
-transparently replaces the normal implementation.
-.SH "RETURN VALUES"
-The return value itself is the value which would have been
-returned by the
-.IR read
-,
-.IR write
-, or
-.IR fsync
-call.
-.SH ERRORS
-The function can return
-.TP
-.B ENOSYS
-if it is not implemented.
-.TP
-.B EINVAL
-if the
-.IR aiocbp
-parameter does not
-refer to an asynchronous operation whose return status is not yet known.
-.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_return64(3),
-.BR aio_suspend(3),
-.BR aio_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
diff --git a/tools/libaio/man/aio_return64.3 b/tools/libaio/man/aio_return64.3
deleted file mode 100644
index 7e78362b32..0000000000
--- a/tools/libaio/man/aio_return64.3
+++ /dev/null
@@ -1,51 +0,0 @@
-.TH aio_read64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_read64 \- Retrieve status of asynchronous I/O operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_return64 (const struct aiocb64 *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function is similar to
-.IR "aio_return"
-with the only difference
-that the argument is a reference to a variable of type
-.IR "struct aiocb64".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is available under the name
-.IR "aio_return"
-and so
-transparently replaces the interface for small files on 32 bit
-machines.
-.SH "RETURN VALUES"
-See
-.IR aio_return.
-.SH ERRORS
-See
-.IR aio_return.
-.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),
diff --git a/tools/libaio/man/aio_suspend.3 b/tools/libaio/man/aio_suspend.3
deleted file mode 100644
index cae1b65691..0000000000
--- a/tools/libaio/man/aio_suspend.3
+++ /dev/null
@@ -1,123 +0,0 @@
-.TH aio_suspend 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_suspend \- Wait until one or more requests of a specific set terminates.
-.SH SYNOPSYS
-.nf
-.B "#include <errno.h>"
-.sp
-.br
-.B "#include <aio.h>"
-.sp
-.br
-.BI "int aio_suspend (const struct aiocb *const list[], int nent, const struct timespec *timeout)"
-.fi
-.SH DESCRIPTION
-Another method of synchronization is to wait until one or more requests of a
-specific set terminated. This could be achieved by the
-.IR "aio_*"
-functions to notify the initiating process about the termination but in
-some situations this is not the ideal solution. In a program which
-constantly updates clients somehow connected to the server it is not
-always the best solution to go round robin since some connections might
-be slow. On the other hand letting the
-.IR "aio_*"
-function notify the
-caller might also be not the best solution since whenever the process
-works on preparing data for on client it makes no sense to be
-interrupted by a notification since the new client will not be handled
-before the current client is served. For situations like this
-.IR "aio_suspend"
-should be used.
-.PP
-When calling this function, the calling thread is suspended until at
-least one of the requests pointed to by the
-.IR "nent"
-elements of the
-array
-.IR "list"
-has completed. If any of the requests has already
-completed at the time
-.IR "aio_suspend"
-is called, the function returns
-immediately. Whether a request has terminated or not is determined by
-comparing the error status of the request with
-.IR "EINPROGRESS"
-. If
-an element of
-.IR "list"
-is
-.IR "NULL"
-, the entry is simply ignored.
-
-If no request has finished, the calling process is suspended. If
-.IR "timeout"
-is
-.IR "NULL"
-, the process is not woken until a request
-has finished. If
-.IR "timeout"
-is not
-.IR "NULL"
-, the process remains
-suspended at least as long as specified in
-.IR "timeout"
-. In this case,
-.IR "aio_suspend"
-returns with an error.
-.PP
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is in fact
-.IR "aio_suspend64"
-since the LFS interface
-transparently replaces the normal implementation.
-.SH "RETURN VALUES"
-The return value of the function is
-.IR 0
-if one or more requests
-from the
-.IR "list"
-have terminated. Otherwise the function returns
-.IR -1
-and
-.IR "errno"
-is set.
-.SH ERRORS
-.TP
-.B EAGAIN
-None of the requests from the
-.IR "list"
-completed in the time specified
-by
-.IR "timeout"
-.
-.TP
-.B EINTR
-A signal interrupted the
-.IR "aio_suspend"
-function. This signal might
-also be sent by the AIO implementation while signalling the termination
-of one of the requests.
-.TP
-.B ENOSYS
-The
-.IR "aio_suspend"
-function is not implemented.
-.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_suspend64(3),
-.BR aio_write(3),
-.BR aio_write64(3),
-.BR errno(3),
diff --git a/tools/libaio/man/aio_suspend64.3 b/tools/libaio/man/aio_suspend64.3
deleted file mode 100644
index 2f289ecceb..0000000000
--- a/tools/libaio/man/aio_suspend64.3
+++ /dev/null
@@ -1,51 +0,0 @@
-.TH aio_suspend64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_suspend64 \- Wait until one or more requests of a specific set terminates
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.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"
-with the only difference
-that the argument is a reference to a variable of type
-.IR "struct aiocb64".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-this
-function is available under the name
-.IR "aio_suspend"
-and so
-transparently replaces the interface for small files on 32 bit
-machines.
-.SH "RETURN VALUES"
-See
-.IR aio_suspend.
-.SH ERRORS
-See
-.IR aio_suspend.
-.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),
diff --git a/tools/libaio/man/aio_write.3 b/tools/libaio/man/aio_write.3
deleted file mode 100644
index 7c0cfd0bf7..0000000000
--- a/tools/libaio/man/aio_write.3
+++ /dev/null
@@ -1,176 +0,0 @@
-.TH aio_write 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_write \- Initiate an asynchronous write operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_write (struct aiocb * aiocbp);"
-.fi
-.SH DESCRIPTION
-This function initiates an asynchronous write operation. The function
-call immediately returns after the operation was enqueued or if before
-this happens an error was encountered.
-
-The first
-.IR "aiocbp->aio_nbytes"
-bytes from the buffer starting at
-.IR "aiocbp->aio_buf"
-are written to the file for which
-.IR "aiocbp->aio_fildes"
-is an descriptor, starting at the absolute
-position
-.IR "aiocbp->aio_offset"
-in the file.
-
-If prioritized I/O is supported by the platform, the
-.IR "aiocbp->aio_reqprio "
-value is used to adjust the priority before
-the request is actually enqueued.
-
-The calling process is notified about the termination of the read
-request according to the
-.IR "aiocbp->aio_sigevent"
-value.
-
-When
-.IR "aio_write"
-returns, the return value is zero if no error
-occurred that can be found before the process is enqueued. If such an
-early error is found the function returns
-.IR -1
-and sets
-.IR "errno"
-to one of the following values.
-
-.TP
-.B EAGAIN
-The request was not enqueued due to (temporarily) exceeded resource
-limitations.
-.TP
-.B ENOSYS
-The
-.IR "aio_write"
-function is not implemented.
-.TP
-.B EBADF
-The
-.IR "aiocbp->aio_fildes"
-descriptor is not valid. This condition
-may not be recognized before enqueueing the request, and so this error
-might also be signaled asynchronously.
-.TP
-.B EINVAL
-The
-.IR "aiocbp->aio_offset"
-or
-.IR "aiocbp->aio_reqprio"
-value is
-invalid. This condition may not be recognized before enqueueing the
-request and so this error might also be signaled asynchronously.
-.PP
-
-In the case
-.IR "aio_write"
-returns zero, the current status of the
-request can be queried using
-.IR "aio_error"
-and
-.IR "aio_return"
-functions. As long as the value returned by
-.IR "aio_error"
-is
-.IR "EINPROGRESS"
-the operation has not yet completed. If
-.IR "aio_error"
-returns zero, the operation successfully terminated,
-otherwise the value is to be interpreted as an error code. If the
-function terminated, the result of the operation can be get using a call
-to
-.IR "aio_return"
-. The returned value is the same as an equivalent
-call to
-.IR "read"
-would have returned. Possible error codes returned
-by
-.IR "aio_error"
-are:
-
-.TP
-.B EBADF
-The
-.IR "aiocbp->aio_fildes"
-descriptor is not valid.
-.TP
-.B ECANCELED
-The operation was canceled before the operation was finished.
-.TP
-.B EINVAL
-The
-.IR "aiocbp->aio_offset"
-value is invalid.
-.PP
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
-function is in fact
-.IR "aio_write64"
-since the LFS interface transparently
-replaces the normal implementation.
-.SH "RETURN VALUES"
-When
-.IR "aio_write"
-returns, the return value is zero if no error
-occurred that can be found before the process is enqueued. If such an
-early error is found the function returns
-.IR -1
-and sets
-.IR "errno"
-to one of the following values.
-.SH ERRORS
-.TP
-.B EAGAIN
-The request was not enqueued due to (temporarily) exceeded resource
-limitations.
-.TP
-.B ENOSYS
-The
-.IR "aio_write"
-function is not implemented.
-.TP
-.B EBADF
-The
-.IR "aiocbp->aio_fildes"
-descriptor is not valid. This condition
-may not be recognized before enqueueing the request, and so this error
-might also be signaled asynchronously.
-.TP
-.B EINVAL
-The
-.IR "aiocbp->aio_offset"
-or
-.IR "aiocbp->aio_reqprio"
-value is
-invalid. This condition may not be recognized before enqueueing the
-request and so this error might also be signaled asynchronously.
-.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_write64(3),
-.BR errno(3),
diff --git a/tools/libaio/man/aio_write64.3 b/tools/libaio/man/aio_write64.3
deleted file mode 100644
index 1080903aca..0000000000
--- a/tools/libaio/man/aio_write64.3
+++ /dev/null
@@ -1,61 +0,0 @@
-.TH aio_write64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-aio_write64 \- Initiate an asynchronous write operation
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <aio.h>
-.sp
-.br
-.BI "int aio_write64 (struct aiocb *aiocbp)"
-.fi
-.SH DESCRIPTION
-This function is similar to the
-.IR "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"
-uses
-functionality equivalent to
-.IR "lseek64"
-to position the file descriptor correctly for the writing,
-as opposed to
-.IR "lseek"
-functionality used in
-.IR "aio_write".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
-function is available under the name
-.IR "aio_write"
-and so transparently
-replaces the interface for small files on 32 bit machines.
-.SH "RETURN VALUES"
-See
-.IR aio_write.
-.SH ERRORS
-See
-.IR aio_write.
-.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),
diff --git a/tools/libaio/man/io.3 b/tools/libaio/man/io.3
deleted file mode 100644
index d910a689f5..0000000000
--- a/tools/libaio/man/io.3
+++ /dev/null
@@ -1,351 +0,0 @@
-.TH io 3 2002-09-12 "Linux 2.4" Linux IO"
-.SH NAME
-io \- Asynchronous IO
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <libio.h>
-.sp
-.fi
-.SH DESCRIPTION
-The libaio library defines a new set of I/O operations which can
-significantly reduce the time an application spends waiting at I/O. The
-new functions allow a program to initiate one or more I/O operations and
-then immediately resume normal work while the I/O operations are
-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"
-binary.
-The implementation of these functions can be done using support in the
-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"
-It is defined in
-.IR "libio.h"
-as follows.
-
-.nf
-
-typedef struct io_context *io_context_t;
-
-typedef enum io_iocb_cmd {
- IO_CMD_PREAD = 0,
- IO_CMD_PWRITE = 1,
-
- IO_CMD_FSYNC = 2,
- IO_CMD_FDSYNC = 3,
-
- IO_CMD_POLL = 5,
- IO_CMD_NOOP = 6,
-} io_iocb_cmd_t;
-
-struct io_iocb_common {
- void *buf;
- unsigned __pad1;
- long nbytes;
- unsigned __pad2;
- long long offset;
- long long __pad3, __pad4;
-}; /* result code is the amount read or -'ve errno */
-
-
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
- union {
- struct io_iocb_common c;
- struct io_iocb_vector v;
- struct io_iocb_poll poll;
- struct io_iocb_sockaddr saddr;
- } u;
-};
-
-
-.fi
-.TP
-.IR "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.
-
-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"
-call would lead to an error.
-.TP
-.IR "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"
-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"
-This element specifies the length of the buffer pointed to by
-.IR "io_buf"
-.
-.TP
-.IR "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"
-and store the next
-.IR "u.c.nbytes"
-bytes in the
-buffer pointed to by
-.IR "buf"
-.
-.TP
-.B "IO_CMD_PWRITE"
-Start a write operation. Write
-.IR "u.c.nbytes"
-bytes starting at
-.IR "buf"
-into the file starting at position
-.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"
-values contains holes, i.e., some of the
-values must not be handled although the whole array is presented to the
-.IR "io_submit"
-function.
-.TP
-.B "IO_CMD_FSYNC"
-.TP
-.B "IO_CMD_POLL"
-This is experimental.
-.SH EXAMPLE
-.nf
-/*
- * Simplistic version of copy command using async i/o
- *
- * From: Stephen Hemminger <shemminger@osdl.org>
- * Copy file by using a async I/O state machine.
- * 1. Start read request
- * 2. When read completes turn it into a write request
- * 3. When write completes decrement counter and free resources
- *
- *
- * Usage: aiocp file(s) desination
- */
-
-#include <unistd.h>
-#include <stdio.h>
-#include <sys/types.h>
-#include <sys/stat.h>
-#include <sys/param.h>
-#include <fcntl.h>
-#include <errno.h>
-
-#include <libaio.h>
-
-#define AIO_BLKSIZE (64*1024)
-#define AIO_MAXIO 32
-
-static int busy = 0; // # of I/O's in flight
-static int tocopy = 0; // # of blocks left to copy
-static int dstfd = -1; // destination file descriptor
-static const char *dstname = NULL;
-static const char *srcname = NULL;
-
-
-/* Fatal error handler */
-static void io_error(const char *func, int rc)
-{
- if (rc == -ENOSYS)
- fprintf(stderr, "AIO not in this kernel\n");
- else if (rc < 0 && -rc < sys_nerr)
- fprintf(stderr, "%s: %s\n", func, sys_errlist[-rc]);
- else
- fprintf(stderr, "%s: error %d\n", func, rc);
-
- if (dstfd > 0)
- close(dstfd);
- if (dstname)
- unlink(dstname);
- exit(1);
-}
-
-/*
- * Write complete callback.
- * Adjust counts and free resources
- */
-static void wr_done(io_context_t ctx, struct iocb *iocb, long res, long res2)
-{
- if (res2 != 0) {
- io_error("aio write", res2);
- }
- if (res != iocb->u.c.nbytes) {
- fprintf(stderr, "write missed bytes expect %d got %d\n", iocb->u.c.nbytes, res2);
- exit(1);
- }
- --tocopy;
- --busy;
- free(iocb->u.c.buf);
-
- memset(iocb, 0xff, sizeof(iocb)); // paranoia
- free(iocb);
- write(2, "w", 1);
-}
-
-/*
- * Read complete callback.
- * Change read iocb into a write iocb and start it.
- */
-static void rd_done(io_context_t ctx, struct iocb *iocb, long res, long res2)
-{
- /* library needs accessors to look at iocb? */
- int iosize = iocb->u.c.nbytes;
- char *buf = iocb->u.c.buf;
- off_t offset = iocb->u.c.offset;
-
- if (res2 != 0)
- io_error("aio read", res2);
- if (res != iosize) {
- fprintf(stderr, "read missing bytes expect %d got %d\n", iocb->u.c.nbytes, res);
- exit(1);
- }
-
-
- /* turn read into write */
- io_prep_pwrite(iocb, dstfd, buf, iosize, offset);
- io_set_callback(iocb, wr_done);
- if (1 != (res = io_submit(ctx, 1, &iocb)))
- io_error("io_submit write", res);
- write(2, "r", 1);
-}
-
-
-int main(int argc, char *const *argv)
-{
- int srcfd;
- struct stat st;
- off_t length = 0, offset = 0;
- io_context_t myctx;
-
- if (argc != 3 || argv[1][0] == '-') {
- fprintf(stderr, "Usage: aiocp SOURCE DEST");
- exit(1);
- }
- if ((srcfd = open(srcname = argv[1], O_RDONLY)) < 0) {
- perror(srcname);
- exit(1);
- }
- if (fstat(srcfd, &st) < 0) {
- perror("fstat");
- exit(1);
- }
- length = st.st_size;
-
- if ((dstfd = open(dstname = argv[2], O_WRONLY | O_CREAT, 0666)) < 0) {
- close(srcfd);
- perror(dstname);
- exit(1);
- }
-
- /* initialize state machine */
- memset(&myctx, 0, sizeof(myctx));
- io_queue_init(AIO_MAXIO, &myctx);
- tocopy = howmany(length, AIO_BLKSIZE);
-
- while (tocopy > 0) {
- int i, rc;
- /* Submit as many reads as once as possible upto AIO_MAXIO */
- int n = MIN(MIN(AIO_MAXIO - busy, AIO_MAXIO / 2),
- howmany(length - offset, AIO_BLKSIZE));
- if (n > 0) {
- struct iocb *ioq[n];
-
- for (i = 0; i < n; i++) {
- struct iocb *io = (struct iocb *) malloc(sizeof(struct iocb));
- int iosize = MIN(length - offset, AIO_BLKSIZE);
- char *buf = (char *) malloc(iosize);
-
- if (NULL == buf || NULL == io) {
- fprintf(stderr, "out of memory\n");
- exit(1);
- }
-
- io_prep_pread(io, srcfd, buf, iosize, offset);
- io_set_callback(io, rd_done);
- ioq[i] = io;
- offset += iosize;
- }
-
- rc = io_submit(myctx, n, ioq);
- if (rc < 0)
- io_error("io_submit", rc);
-
- busy += n;
- }
-
- // Handle IO's that have completed
- rc = io_queue_run(myctx);
- if (rc < 0)
- io_error("io_queue_run", rc);
-
- // if we have maximum number of i/o's in flight
- // then wait for one to complete
- if (busy == AIO_MAXIO) {
- rc = io_queue_wait(myctx, NULL);
- if (rc < 0)
- io_error("io_queue_wait", rc);
- }
-
- }
-
- close(srcfd);
- close(dstfd);
- exit(0);
-}
-
-/*
- * Results look like:
- * [alanm@toolbox ~/MOT3]$ ../taio kernel-source-2.4.8-0.4g.ppc.rpm abc
- * rrrrrrrrrrrrrrrwwwrwrrwwrrwrwwrrwrwrwwrrwrwrrrrwwrwwwrrwrrrwwwwwwwwwwwwwwwww
- * rrrrrrrrrrrrrrwwwrrwrwrwrwrrwwwwwwwwwwwwwwrrrrrrrrrrrrrrrrrrwwwwrwrwwrwrwrwr
- * wrrrrrrrwwwwwwwwwwwwwrrrwrrrwrrwrwwwwwwwwwwrrrrwwrwrrrrrrrrrrrwwwwwwwwwwwrww
- * wwwrrrrrrrrwwrrrwwrwrwrwwwrrrrrrrwwwrrwwwrrwrwwwwwwwwrrrrrrrwwwrrrrrrrwwwwww
- * wwwwwwwrwrrrrrrrrwrrwrrwrrwrwrrrwrrrwrrrwrwwwwwwwwwwwwwwwwwwrrrwwwrrrrrrrrrr
- * rrwrrrrrrwrrwwwwwwwwwwwwwwwwrwwwrrwrwwrrrrrrrrrrrrrrrrrrrwwwwwwwwwwwwwwwwwww
- * rrrrrwrrwrwrwrrwrrrwwwwwwwwrrrrwrrrwrwwrwrrrwrrwrrrrwwwwwwwrwrwwwwrwwrrrwrrr
- * rrrwwwwwwwrrrrwwrrrrrrrrrrrrwrwrrrrwwwwwwwwwwwwwwrwrrrrwwwwrwrrrrwrwwwrrrwww
- * rwwrrrrrrrwrrrrrrrrrrrrwwwwrrrwwwrwrrwwwwwwwwwwwwwwwwwwwwwrrrrrrrwwwwwwwrw
- */
-.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)
diff --git a/tools/libaio/man/io_cancel.1 b/tools/libaio/man/io_cancel.1
deleted file mode 100644
index 16e898a7de..0000000000
--- a/tools/libaio/man/io_cancel.1
+++ /dev/null
@@ -1,21 +0,0 @@
-.\"/* sys_io_cancel:
-.\" * Attempts to cancel an iocb previously passed to io_submit. If
-.\" * the operation is successfully cancelled, the resulting event is
-.\" * copied into the memory pointed to by result without being placed
-.\" * into the completion queue and 0 is returned. May fail with
-.\" * -EFAULT if any of the data structures pointed to are invalid.
-.\" * May fail with -EINVAL if aio_context specified by ctx_id is
-.\" * invalid. May fail with -EAGAIN if the iocb specified was not
-.\" * cancelled. Will fail with -ENOSYS if not implemented.
-.\" */
-.\"
-.TH io_cancel 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_cancel \- cancel io requests
-.SH SYNOPSIS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.LP
-.BI "int io_submit(io_context_t " ctx ", struct iocb *" iocb ", struct io_event *" result ");"
-
diff --git a/tools/libaio/man/io_cancel.3 b/tools/libaio/man/io_cancel.3
deleted file mode 100644
index 9a16084a5b..0000000000
--- a/tools/libaio/man/io_cancel.3
+++ /dev/null
@@ -1,65 +0,0 @@
-.TH io_cancel 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_cancel \- Cancel io requests
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <libaio.h>
-.sp
-.br
-.BI "int io_cancel(io_context_t ctx, struct iocb *iocb)"
-.br
-.sp
-struct iocb {
- void *data; /* Return in the io completion event */
- unsigned key; /* For use in identifying io requests */
- short aio_lio_opcode;
- short aio_reqprio; /* Not used */
- int aio_fildes;
-};
-.fi
-.SH DESCRIPTION
-Attempts to cancel an iocb previously passed to io_submit. If
-the operation is successfully cancelled, the resulting event is
-copied into the memory pointed to by result without being placed
-into the completion queue.
-.PP
-When one or more requests are asynchronously processed, it might be
-useful in some situations to cancel a selected operation, e.g., if it
-becomes obvious that the written data is no longer accurate and would
-have to be overwritten soon. As an example, assume an application, which
-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.
-.SH ERRORS
-.TP
-.B EFAULT
-If any of the data structures pointed to are invalid.
-.TP
-.B EINVAL
-If aio_context specified by ctx_id is
-invalid.
-.TP
-.B EAGAIN
-If the iocb specified was not
-cancelled.
-.TP
-.B ENOSYS
-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)
diff --git a/tools/libaio/man/io_destroy.1 b/tools/libaio/man/io_destroy.1
deleted file mode 100644
index 177683b8e0..0000000000
--- a/tools/libaio/man/io_destroy.1
+++ /dev/null
@@ -1,17 +0,0 @@
-.\"/* sys_io_destroy:
-.\" * Destroy the aio_context specified. May cancel any outstanding
-.\" * AIOs and block on completion. Will fail with -ENOSYS if not
-.\" * implemented. May fail with -EFAULT if the context pointed to
-.\" * is invalid.
-.\" */
-.\" libaio provides this as io_queue_release.
-.TH io_destroy 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_destroy \- destroy an io context
-.SH SYNOPSIS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.LP
-.BI "int io_destroy(io_context_t " ctx ");"
-
diff --git a/tools/libaio/man/io_fsync.3 b/tools/libaio/man/io_fsync.3
deleted file mode 100644
index 53eb63d278..0000000000
--- a/tools/libaio/man/io_fsync.3
+++ /dev/null
@@ -1,82 +0,0 @@
-./" 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"
-.SH NAME
-io_fsync \- Synchronize a file's complete in-core state with that on disk
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <libaio.h>
-.sp
-.br
-.BI "int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.sp
-typedef void (*io_callback_t)(io_context_t ctx, struct iocb *iocb, long res, long res2);
-.sp
-.fi
-.SH DESCRIPTION
-When dealing with asynchronous operations it is sometimes necessary to
-get into a consistent state. This would mean for AIO that one wants to
-know whether a certain request or a group of request were processed.
-This could be done by waiting for the notification sent by the system
-after the operation terminated, but this sometimes would mean wasting
-resources (mainly computation time).
-.PP
-Calling this function forces all I/O operations operating queued at the
-time of the function call operating on the file descriptor
-.IR "iocb->io_fildes"
-into the synchronized I/O completion state . The
-.IR "io_fsync"
-function returns
-immediately but the notification through the method described in
-.IR "io_callback"
-will happen only after all requests for this
-file descriptor have terminated and the file is synchronized. This also
-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.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-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 iocbs
-contains an improperly initialized iocb,
-.TP
-.B EBADF
-The iocb contains a file descriptor that does not exist.
-.TP
-.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)
diff --git a/tools/libaio/man/io_getevents.1 b/tools/libaio/man/io_getevents.1
deleted file mode 100644
index 27730b9959..0000000000
--- a/tools/libaio/man/io_getevents.1
+++ /dev/null
@@ -1,29 +0,0 @@
-./"/* 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"
-.SH NAME
-io_getevents \- read resulting events from io requests
-.SH SYNOPSIS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.sp
-.BI "int io_getevents(io_context_t " ctx ", long " min_nr ", long " nr ", struct io_events *" events "[], struct timespec *" timeout ");"
-
-
diff --git a/tools/libaio/man/io_getevents.3 b/tools/libaio/man/io_getevents.3
deleted file mode 100644
index 8e9ddc866a..0000000000
--- a/tools/libaio/man/io_getevents.3
+++ /dev/null
@@ -1,79 +0,0 @@
-./"/* 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"
-.SH NAME
-io_getevents \- Read resulting events from io requests
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.B #include <libaio.h>
-.br
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.sp
-struct io_event {
- unsigned PADDED(data, __pad1);
- unsigned PADDED(obj, __pad2);
- unsigned PADDED(res, __pad3);
- unsigned PADDED(res2, __pad4);
-};
-.sp
-.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.
-.SH "RETURN VALUES"
-May return
-0 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.
-.SH ERRORS
-.TP
-.B 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.
-.TP
-.B EFAULT
-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)
diff --git a/tools/libaio/man/io_prep_fsync.3 b/tools/libaio/man/io_prep_fsync.3
deleted file mode 100644
index 4cf935acaf..0000000000
--- a/tools/libaio/man/io_prep_fsync.3
+++ /dev/null
@@ -1,89 +0,0 @@
-./" 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"
-.SH NAME
-io_prep_fsync \- Synchronize a file's complete in-core state with that on disk
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "static inline void io_prep_fsync(struct iocb *iocb, int fd)"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.sp
-.fi
-.SH DESCRIPTION
-This is an inline convenience function for setting up an iocbv for a FSYNC request.
-.br
-The file for which
-.TP
-.IR "iocb->aio_fildes = fd"
-is a descriptor is set up with
-the command
-.TP
-.IR "iocb->aio_lio_opcode = IO_CMD_FSYNC:
-.
-.PP
-The io_prep_fsync() function shall set up an IO_CMD_FSYNC 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
-the iocb argument and queued at the time of the call to
-io_submit() 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
-integrity completion. If the
-operation queued by io_prep_fsync() fails, then, as for fsync(),
-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
-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
-function
-.IR io_submit
-must be called.
-.PP
-Simultaneous asynchronous operations using the same iocb produce
-undefined results.
-.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_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)
diff --git a/tools/libaio/man/io_prep_pread.3 b/tools/libaio/man/io_prep_pread.3
deleted file mode 100644
index 5938aecc6b..0000000000
--- a/tools/libaio/man/io_prep_pread.3
+++ /dev/null
@@ -1,79 +0,0 @@
-./" 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"
-.SH NAME
-io_prep_pread \- Set up asynchronous read
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.sp
-.br
-.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)
-"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.fi
-.SH DESCRIPTION
-.IR 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
-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
-function
-.IR io_submit
-must be called.
-.PP
-Simultaneous asynchronous operations using the same iocb produce
-undefined results.
-.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_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)
diff --git a/tools/libaio/man/io_prep_pwrite.3 b/tools/libaio/man/io_prep_pwrite.3
deleted file mode 100644
index 68b3500587..0000000000
--- a/tools/libaio/man/io_prep_pwrite.3
+++ /dev/null
@@ -1,77 +0,0 @@
-./" 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"
-.SH NAME
-io_prep_pwrite \- Set up iocb for asynchronous writes
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.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)
-"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.fi
-.SH DESCRIPTION
-io_prep_write 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
-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
-function
-.IR io_submit
-must be called.
-.PP
-Simultaneous asynchronous operations using the same iocb produce
-undefined results.
-.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_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)
diff --git a/tools/libaio/man/io_queue_init.3 b/tools/libaio/man/io_queue_init.3
deleted file mode 100644
index 317f631cfc..0000000000
--- a/tools/libaio/man/io_queue_init.3
+++ /dev/null
@@ -1,63 +0,0 @@
-.TH io_queue_init 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_queue_init \- Initialize asynchronous io state machine
-
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "int io_queue_init(int maxevents, io_context_t *ctx );"
-.sp
-.fi
-.SH DESCRIPTION
-.B io_queue_init
-Attempts to create an aio context capable of receiving at least
-.IR maxevents
-events.
-.IR ctx
-must point to an aio context that already exists and must be initialized
-to
-.IR 0
-before the call.
-If the operation is successful, *cxtp is filled with the resulting handle.
-.SH "RETURN VALUES"
-On success,
-.B io_queue_init
-returns 0. Otherwise, -error is return, where
-error is one of the Exxx values defined in the Errors section.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-referenced data outside of the program's accessible address space.
-.TP
-.B EINVAL
-.I maxevents
-is <= 0 or
-.IR ctx
-is an invalid memory locattion.
-.TP
-.B ENOSYS
-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)
diff --git a/tools/libaio/man/io_queue_release.3 b/tools/libaio/man/io_queue_release.3
deleted file mode 100644
index 06b9ec033d..0000000000
--- a/tools/libaio/man/io_queue_release.3
+++ /dev/null
@@ -1,48 +0,0 @@
-.TH io_queue_release 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_queue_release \- Release the context associated with the userspace handle
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.br
-.sp
-.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
-AIOs and block on completion.
-
-.B cts.
-.SH "RETURN VALUES"
-On success,
-.B io_queue_release
-returns 0. 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
-.I iocbs
-contains an improperly initialized iocb,
-.TP
-.B ENOSYS
-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_queue_wait(3),
-.BR io_set_callback(3),
-.BR io_submit(3),
-.BR errno(3)
-
diff --git a/tools/libaio/man/io_queue_run.3 b/tools/libaio/man/io_queue_run.3
deleted file mode 100644
index 57dd417875..0000000000
--- a/tools/libaio/man/io_queue_run.3
+++ /dev/null
@@ -1,50 +0,0 @@
-.TH io_queue_run 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_queue_run \- Handle completed io requests
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "int io_queue_run(io_context_t ctx );"
-.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.
-.SH "RETURN VALUES"
-May return
-0 if no events are available.
-Will fail with -ENOSYS if not implemented.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-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 iocbs
-contains an improperly initialized iocb,
-.TP
-.B ENOSYS
-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)
diff --git a/tools/libaio/man/io_queue_wait.3 b/tools/libaio/man/io_queue_wait.3
deleted file mode 100644
index 2306663eae..0000000000
--- a/tools/libaio/man/io_queue_wait.3
+++ /dev/null
@@ -1,56 +0,0 @@
-.TH io_queue_wait 2 2002-09-03 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_queue_wait \- Wait for io requests to complete
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "int io_queue_wait(io_context_t ctx, const struct timespec *timeout);"
-.fi
-.SH DESCRIPTION
-Attempts to read an event from
-the completion queue for the aio_context specified by ctx_id.
-.SH "RETURN VALUES"
-May return
-0 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.
-.SH "RETURN VALUES"
-On success,
-.B io_queue_wait
-returns 0. Otherwise, -error is return, where
-error is one of the Exxx values defined in the Errors section.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-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 iocbs
-contains an improperly initialized iocb,
-.TP
-.B ENOSYS
-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)
diff --git a/tools/libaio/man/io_set_callback.3 b/tools/libaio/man/io_set_callback.3
deleted file mode 100644
index a8ca789eb2..0000000000
--- a/tools/libaio/man/io_set_callback.3
+++ /dev/null
@@ -1,44 +0,0 @@
-./"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"
-.SH NAME
-io_set_callback \- Set up io completion callback function
-.SH SYNOPSYS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.sp
-typedef void (*io_callback_t)(io_context_t ctx, struct iocb *iocb, long res, long res2);
-.sp
-.fi
-.SH DESCRIPTION
-The callback is not done if the caller uses raw events from
-io_getevents, only with the library helpers
-.SH "RETURN VALUES"
-.SH ERRORS
-.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)
diff --git a/tools/libaio/man/io_setup.1 b/tools/libaio/man/io_setup.1
deleted file mode 100644
index 68690e1e73..0000000000
--- a/tools/libaio/man/io_setup.1
+++ /dev/null
@@ -1,15 +0,0 @@
-./"/* 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.
diff --git a/tools/libaio/man/io_submit.1 b/tools/libaio/man/io_submit.1
deleted file mode 100644
index f66e80f1b5..0000000000
--- a/tools/libaio/man/io_submit.1
+++ /dev/null
@@ -1,109 +0,0 @@
-.TH io_submit 2 2002-09-02 "Linux 2.4" "Linux AIO"
-.SH NAME
-io_submit \- submit io requests
-.SH SYNOPSIS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.LP
-.BI "int io_submit(io_context_t " ctx ", long " nr ", struct iocb *" iocbs "[]);"
-.SH DESCRIPTION
-.B io_submit
-submits to the io_context
-.I ctx
-up to
-.I nr
-I/O requests pointed to by the vector
-.IR iocbs .
-
-The
-.B iocb
-structure is defined as something like
-.sp
-.RS
-.nf
-struct iocb {
- void *data;
-.\" unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.fi
-.RE
-.sp
-.I data
-is a an opaque pointer which will upon completion be returned in the
-.B io_event
-structure by
-.BR io_getevents (2).
-.\" and io_wait(2)
-Callers will typically use this to point directly or indirectly to a
-callback function.
-.sp
-.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)
-function corresponding to the operation.
-.sp
-.I aio_reqprio
-is the priority of the request. Higher values have more priority; the
-normal priority is 0.
-.sp
-.I aio_fildes
-is the file descriptor for the I/O operation.
-Callers will typically set this and the
-arguments to the I/O operation calling the
-.BR io_prep_ *(3)
-function corresponding to the operation.
-.sp
-The caller may not modify the contents or resubmit a submitted
-.B iocb
-structure until after the operation completes or is canceled.
-The implementation of
-.BR io_submit (2)
-is permitted to modify reserved fields of the
-.B iocb
-structure.
-.SH "RETURN VALUES"
-If able to submit at least one iocb,
-.B io_submit
-returns the number of iocbs submitted successfully. Otherwise,
-.RI - error
-is returned, where
-.I error
-is one of the Exxx values defined in the Errors section.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-referenced data outside of the program's accessible address space.
-.TP
-.B EINVAL
-.I nr
-is negative,
-.I ctx
-refers to an uninitialized aio context, the iocb pointed to by
-.IR iocbs [0]
-is improperly initialized or specifies an unsupported operation.
-.TP
-.B EBADF
-The iocb pointed to by
-.IR iocbs [0]
-contains a file descriptor that does not exist.
-.TP
-.B EAGAIN
-Insufficient resources were available to queue any operations.
-.SH "SEE ALSO"
-.BR io_setup (2),
-.BR io_destroy (2),
-.BR io_getevents (2),
-.\".BR io_wait (2),
-.BR io_prep_pread (3),
-.BR io_prep_pwrite (3),
-.BR io_prep_fsync (3),
-.BR io_prep_fdsync (3),
-.BR io_prep_noop (3),
-.BR io_cancel (2),
-.BR errno (3)
diff --git a/tools/libaio/man/io_submit.3 b/tools/libaio/man/io_submit.3
deleted file mode 100644
index b6966efd8b..0000000000
--- a/tools/libaio/man/io_submit.3
+++ /dev/null
@@ -1,135 +0,0 @@
-./"/* 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"
-.SH NAME
-io_submit \- Submit io requests
-.SH SYNOPSIS
-.nf
-.B #include <errno.h>
-.br
-.sp
-.B #include <libaio.h>
-.br
-.sp
-.BI "int io_submit(io_context_t " ctx ", long " nr ", struct iocb *" iocbs "[]);"
-.sp
-struct iocb {
- void *data;
- unsigned key;
- short aio_lio_opcode;
- short aio_reqprio;
- int aio_fildes;
-};
-.fi
-.SH DESCRIPTION
-.B io_submit
-submits
-.I nr
-iocbs for processing for a given io context ctx.
-
-The
-.IR "io_submit"
-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 "io_submit"
-gets the
-.IR "nr"
-requests from the array pointed to
-by
-.IR "iocbs"
-. The operation to be performed is determined by the
-.IR "aio_lio_opcode"
-member in each element of
-.IR "iocbs"
-. If this
-field is
-.B "IO_CMD_PREAD"
-a read operation is enqueued, similar to a call
-of
-.IR "io_prep_pread"
-for this element of the array (except that the way
-the termination is signalled is different, as we will see below). If
-the
-.IR "aio_lio_opcode"
-member is
-.B "IO_CMD_PWRITE"
-a write operation
-is enqueued. Otherwise the
-.IR "aio_lio_opcode"
-must be
-.B "IO_CMD_NOP"
-in which case this element of
-.IR "iocbs"
-is simply ignored. This
-``operation'' is useful in situations where one has a fixed array of
-.IR "struct iocb"
-elements from which only a few need to be handled at
-a time. Another situation is where the
-.IR "io_submit"
-call was
-canceled before all requests are processed and the remaining requests have to be reissued.
-
-The other members of each element of the array pointed to by
-.IR "iocbs"
-must have values suitable for the operation as described in
-the documentation for
-.IR "io_prep_pread"
-and
-.IR "io_prep_pwrite"
-above.
-
-The function returns immediately after
-having enqueued all the requests.
-On success,
-.B io_submit
-returns the number of iocbs submitted successfully. Otherwise, -error is return, where
-error is one of the Exxx values defined in the Errors section.
-.PP
-If an error is detected, then the behavior is undefined.
-.PP
-Simultaneous asynchronous operations using the same iocb produce
-undefined results.
-.SH ERRORS
-.TP
-.B EFAULT
-.I iocbs
-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 iocbs
-contains an improperly initialized iocb,
-.TP
-.B EBADF
-The iocb contains a file descriptor that does not exist.
-.TP
-.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)
diff --git a/tools/libaio/man/lio_listio.3 b/tools/libaio/man/lio_listio.3
deleted file mode 100644
index 9b5b5e4eb5..0000000000
--- a/tools/libaio/man/lio_listio.3
+++ /dev/null
@@ -1,229 +0,0 @@
-.TH lio_listio 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-lio_listio - List directed I/O
-.SH SYNOPSYS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.LP
-.BI "int lio_listio (int mode, struct aiocb *const list[], int nent, struct sigevent *sig)"
-.nf
-.SH DESCRIPTION
-
-Besides these functions with the more or less traditional interface,
-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
-and
-.IR "writev"
-.
-
-The
-.IR "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"
-gets the
-.IR "nent"
-requests from the array pointed to
-by
-.IR "list"
-. The operation to be performed is determined by the
-.IR "aio_lio_opcode"
-member in each element of
-.IR "list"
-. If this
-field is
-.B "LIO_READ"
-a read operation is enqueued, similar to a call
-of
-.IR "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
-.IR "aio_lio_opcode"
-member is
-.B "LIO_WRITE"
-a write operation
-is enqueued. Otherwise the
-.IR "aio_lio_opcode"
-must be
-.B "LIO_NOP"
-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"
-elements from which only a few need to be handled at
-a time. Another situation is where the
-.IR "lio_listio"
-call was
-canceled before all requests are processed and the remaining requests have to be reissued.
-
-The other members of each element of the array pointed to by
-.IR "list"
-must have values suitable for the operation as described in
-the documentation for
-.IR "aio_read"
-and
-.IR "aio_write"
-above.
-
-The
-.IR "mode"
-argument determines how
-.IR "lio_listio"
-behaves after
-having enqueued all the requests. If
-.IR "mode"
-is
-.B "LIO_WAIT"
-it
-waits until all requests terminated. Otherwise
-.IR "mode"
-must be
-.B "LIO_NOWAIT"
-and in this case the function returns immediately after
-having enqueued all the requests. In this case the caller gets a
-notification of the termination of all requests according to the
-.IR "sig"
-parameter. If
-.IR "sig"
-is
-.B "NULL"
-no notification is
-send. Otherwise a signal is sent or a thread is started, just as
-described in the description for
-.IR "aio_read"
-or
-.IR "aio_write"
-.
-
-When the sources are compiled with
-.B "_FILE_OFFSET_BITS == 64"
-, this
-function is in fact
-.IR "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"
-is
-.IR 0
-when all requests completed successfully. Otherwise the
-function return
-.IR 1
-and
-.IR "errno"
-is set accordingly. To find
-out which request or requests failed one has to use the
-.IR "aio_error"
-function on all the elements of the array
-.IR "list"
-.
-
-In case
-.IR "mode"
-is
-.B "LIO_NOWAIT"
-, the function returns
-.IR 0
-if
-all requests were enqueued correctly. The current state of the requests
-can be found using
-.IR "aio_error"
-and
-.IR "aio_return"
-as described
-above. If
-.IR "lio_listio"
-returns
-.IR -1
-in this mode, the
-global variable
-.IR "errno"
-is set accordingly. If a request did not
-yet terminate, a call to
-.IR "aio_error"
-returns
-.B "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
-using
-.IR "aio_return"
-.
-.SH ERRORS
-Possible values for
-.IR "errno"
-are:
-
-.TP
-.B EAGAIN
-The resources necessary to queue all the requests are not available at
-the moment. The error status for each element of
-.IR "list"
-must be
-checked to determine which request failed.
-
-Another reason could be that the system wide limit of AIO requests is
-exceeded. This cannot be the case for the implementation on GNU systems
-since no arbitrary limits exist.
-.TP
-.B EINVAL
-The
-.IR "mode"
-parameter is invalid or
-.IR "nent"
-is larger than
-.B "AIO_LISTIO_MAX"
-.
-.TP
-.B EIO
-One or more of the request's I/O operations failed. The error status of
-each request should be checked to determine which one failed.
-.TP
-.B ENOSYS
-The
-.IR "lio_listio"
-function is not supported.
-.PP
-
-If the
-.IR "mode"
-parameter is
-.B "LIO_NOWAIT"
-and the caller cancels
-a request, the error status for this request returned by
-.IR "aio_error"
-is
-.B "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)
diff --git a/tools/libaio/man/lio_listio64.3 b/tools/libaio/man/lio_listio64.3
deleted file mode 100644
index 97f69556c0..0000000000
--- a/tools/libaio/man/lio_listio64.3
+++ /dev/null
@@ -1,39 +0,0 @@
-.TH lio_listio64 3 2002-09-12 "Linux 2.4" Linux AIO"
-.SH NAME
-lio_listio64 \- List directed I/O
-.SH SYNOPSYS
-.B #include <errno.h>
-.br
-.B #include <libaio.h>
-.LP
-.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"
-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"
-uses
-functionality equivalent to
-.IR lseek64"
-to position the file descriptor correctly for the reading or
-writing, as opposed to
-.IR "lseek"
-functionality used in
-.IR "lio_listio".
-
-When the sources are compiled with
-.IR "_FILE_OFFSET_BITS == 64"
-, this
-function is available under the name
-.IR "lio_listio"
-and so
-transparently replaces the interface for small files on 32 bit
-machines.
-.SH "RETURN VALUES"
-.SH ERRORS
-.SH "SEE ALSO"