]>
Commit | Line | Data |
---|---|---|
a76bab49 AL |
1 | /* |
2 | * QEMU aio implementation | |
3 | * | |
4 | * Copyright IBM, Corp. 2008 | |
5 | * | |
6 | * Authors: | |
7 | * Anthony Liguori <[email protected]> | |
8 | * | |
9 | * This work is licensed under the terms of the GNU GPL, version 2. See | |
10 | * the COPYING file in the top-level directory. | |
11 | * | |
12 | */ | |
13 | ||
14 | #ifndef QEMU_AIO_H | |
15 | #define QEMU_AIO_H | |
16 | ||
17 | #include "qemu-common.h" | |
18 | #include "qemu-char.h" | |
19 | ||
20 | /* Returns 1 if there are still outstanding AIO requests; 0 otherwise */ | |
21 | typedef int (AioFlushHandler)(void *opaque); | |
22 | ||
8febfa26 KW |
23 | /* Runs all currently allowed AIO callbacks of completed requests in the |
24 | * respective AIO backend. Returns 0 if no requests was handled, non-zero | |
25 | * if at least one queued request was handled. */ | |
26 | typedef int (AioProcessQueue)(void *opaque); | |
27 | ||
a76bab49 AL |
28 | /* Flush any pending AIO operation. This function will block until all |
29 | * outstanding AIO operations have been completed or cancelled. */ | |
30 | void qemu_aio_flush(void); | |
31 | ||
986c28d6 AA |
32 | /* Wait for a single AIO completion to occur. This function will wait |
33 | * until a single AIO event has completed and it will ensure something | |
34 | * has moved before returning. This can issue new pending aio as | |
35 | * result of executing I/O completion or bh callbacks. */ | |
a76bab49 AL |
36 | void qemu_aio_wait(void); |
37 | ||
8febfa26 KW |
38 | /* |
39 | * Runs all currently allowed AIO callbacks of completed requests. Returns 0 | |
40 | * if no requests were handled, non-zero if at least one request was | |
41 | * processed. | |
42 | */ | |
43 | int qemu_aio_process_queue(void); | |
44 | ||
a76bab49 AL |
45 | /* Register a file descriptor and associated callbacks. Behaves very similarly |
46 | * to qemu_set_fd_handler2. Unlike qemu_set_fd_handler2, these callbacks will | |
47 | * be invoked when using either qemu_aio_wait() or qemu_aio_flush(). | |
48 | * | |
49 | * Code that invokes AIO completion functions should rely on this function | |
50 | * instead of qemu_set_fd_handler[2]. | |
51 | */ | |
52 | int qemu_aio_set_fd_handler(int fd, | |
53 | IOHandler *io_read, | |
54 | IOHandler *io_write, | |
55 | AioFlushHandler *io_flush, | |
8febfa26 | 56 | AioProcessQueue *io_process_queue, |
a76bab49 AL |
57 | void *opaque); |
58 | ||
59 | #endif |