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