debuggers.hg

view tools/libaio/man/io_queue_init.3 @ 0:7d21f7218375

Exact replica of unstable on 051908 + README-this
author Mukesh Rathor
date Mon May 19 15:34:57 2008 -0700 (2008-05-19)
parents
children
line source
1 .TH io_queue_init 2 2002-09-03 "Linux 2.4" "Linux AIO"
2 .SH NAME
3 io_queue_init \- Initialize asynchronous io state machine
5 .SH SYNOPSIS
6 .nf
7 .B #include <errno.h>
8 .br
9 .sp
10 .B #include <libaio.h>
11 .br
12 .sp
13 .BI "int io_queue_init(int maxevents, io_context_t *ctx );"
14 .sp
15 .fi
16 .SH DESCRIPTION
17 .B io_queue_init
18 Attempts to create an aio context capable of receiving at least
19 .IR maxevents
20 events.
21 .IR ctx
22 must point to an aio context that already exists and must be initialized
23 to
24 .IR 0
25 before the call.
26 If the operation is successful, *cxtp is filled with the resulting handle.
27 .SH "RETURN VALUES"
28 On success,
29 .B io_queue_init
30 returns 0. Otherwise, -error is return, where
31 error is one of the Exxx values defined in the Errors section.
32 .SH ERRORS
33 .TP
34 .B EFAULT
35 .I iocbs
36 referenced data outside of the program's accessible address space.
37 .TP
38 .B EINVAL
39 .I maxevents
40 is <= 0 or
41 .IR ctx
42 is an invalid memory locattion.
43 .TP
44 .B ENOSYS
45 Not implemented
46 .TP
47 .B EAGAIN
48 .IR "maxevents > max_aio_reqs"
49 where max_aio_reqs is a tunable value.
50 .SH "SEE ALSO"
51 .BR io(3),
52 .BR io_cancel(3),
53 .BR io_fsync(3),
54 .BR io_getevents(3),
55 .BR io_prep_fsync(3),
56 .BR io_prep_pread(3),
57 .BR io_prep_pwrite(3),
58 .BR io_queue_release(3),
59 .BR io_queue_run(3),
60 .BR io_queue_wait(3),
61 .BR io_set_callback(3),
62 .BR io_submit(3),
63 .BR errno(3)