2 * QEMU aio implementation
4 * Copyright IBM, Corp. 2008
7 * Anthony Liguori <aliguori@us.ibm.com>
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
17 #include "qemu-common.h"
18 #include "qemu-char.h"
20 typedef struct BlockDriverAIOCB BlockDriverAIOCB
;
21 typedef void BlockDriverCompletionFunc(void *opaque
, int ret
);
23 typedef struct AIOPool
{
24 void (*cancel
)(BlockDriverAIOCB
*acb
);
26 BlockDriverAIOCB
*free_aiocb
;
29 struct BlockDriverAIOCB
{
32 BlockDriverCompletionFunc
*cb
;
34 BlockDriverAIOCB
*next
;
37 void *qemu_aio_get(AIOPool
*pool
, BlockDriverState
*bs
,
38 BlockDriverCompletionFunc
*cb
, void *opaque
);
39 void qemu_aio_release(void *p
);
41 /* Returns 1 if there are still outstanding AIO requests; 0 otherwise */
42 typedef int (AioFlushHandler
)(void *opaque
);
44 /* Runs all currently allowed AIO callbacks of completed requests in the
45 * respective AIO backend. Returns 0 if no requests was handled, non-zero
46 * if at least one queued request was handled. */
47 typedef int (AioProcessQueue
)(void *opaque
);
49 /* Flush any pending AIO operation. This function will block until all
50 * outstanding AIO operations have been completed or cancelled. */
51 void qemu_aio_flush(void);
53 /* Wait for a single AIO completion to occur. This function will wait
54 * until a single AIO event has completed and it will ensure something
55 * has moved before returning. This can issue new pending aio as
56 * result of executing I/O completion or bh callbacks. */
57 void qemu_aio_wait(void);
60 * Runs all currently allowed AIO callbacks of completed requests. Returns 0
61 * if no requests were handled, non-zero if at least one request was
64 int qemu_aio_process_queue(void);
66 /* Register a file descriptor and associated callbacks. Behaves very similarly
67 * to qemu_set_fd_handler2. Unlike qemu_set_fd_handler2, these callbacks will
68 * be invoked when using either qemu_aio_wait() or qemu_aio_flush().
70 * Code that invokes AIO completion functions should rely on this function
71 * instead of qemu_set_fd_handler[2].
73 int qemu_aio_set_fd_handler(int fd
,
76 AioFlushHandler
*io_flush
,
77 AioProcessQueue
*io_process_queue
,