2005-04-17 05:20:36 +07:00
|
|
|
#ifndef __LINUX__AIO_H
|
|
|
|
#define __LINUX__AIO_H
|
|
|
|
|
|
|
|
#include <linux/list.h>
|
|
|
|
#include <linux/workqueue.h>
|
|
|
|
#include <linux/aio_abi.h>
|
2006-10-01 13:28:46 +07:00
|
|
|
#include <linux/uio.h>
|
2008-12-09 14:11:22 +07:00
|
|
|
#include <linux/rcupdate.h>
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2011-07-27 06:09:06 +07:00
|
|
|
#include <linux/atomic.h>
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
struct kioctx;
|
2013-05-08 06:18:49 +07:00
|
|
|
struct kiocb;
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2013-05-08 06:19:10 +07:00
|
|
|
#define KIOCB_KEY 0
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2013-05-08 06:18:49 +07:00
|
|
|
/*
|
|
|
|
* We use ki_cancel == KIOCB_CANCELLED to indicate that a kiocb has been either
|
|
|
|
* cancelled or completed (this makes a certain amount of sense because
|
|
|
|
* successful cancellation - io_cancel() - does deliver the completion to
|
|
|
|
* userspace).
|
|
|
|
*
|
|
|
|
* And since most things don't implement kiocb cancellation and we'd really like
|
|
|
|
* kiocb completion to be lockless when possible, we use ki_cancel to
|
|
|
|
* synchronize cancellation and completion - we only set it to KIOCB_CANCELLED
|
|
|
|
* with xchg() or cmpxchg(), see batch_complete_aio() and kiocb_cancel().
|
|
|
|
*/
|
|
|
|
#define KIOCB_CANCELLED ((void *) (~0ULL))
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2013-05-14 04:45:08 +07:00
|
|
|
typedef int (kiocb_cancel_fn)(struct kiocb *);
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
struct kiocb {
|
|
|
|
struct file *ki_filp;
|
2013-05-08 06:19:10 +07:00
|
|
|
struct kioctx *ki_ctx; /* NULL for sync ops */
|
2013-05-08 06:18:49 +07:00
|
|
|
kiocb_cancel_fn *ki_cancel;
|
2013-02-26 07:36:27 +07:00
|
|
|
void *private;
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
union {
|
|
|
|
void __user *user;
|
|
|
|
struct task_struct *tsk;
|
|
|
|
} ki_obj;
|
2006-01-08 16:04:34 +07:00
|
|
|
|
2005-04-17 05:20:36 +07:00
|
|
|
__u64 ki_user_data; /* user's data for completion */
|
|
|
|
loff_t ki_pos;
|
2013-02-26 07:36:27 +07:00
|
|
|
size_t ki_nbytes; /* copy of iocb->aio_nbytes */
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2006-01-08 16:04:34 +07:00
|
|
|
struct list_head ki_list; /* the aio core uses this
|
|
|
|
* for cancellation */
|
signal/timer/event: KAIO eventfd support example
This is an example about how to add eventfd support to the current KAIO code,
in order to enable KAIO to post readiness events to a pollable fd (hence
compatible with POSIX select/poll). The KAIO code simply signals the eventfd
fd when events are ready, and this triggers a POLLIN in the fd. This patch
uses a reserved for future use member of the struct iocb to pass an eventfd
file descriptor, that KAIO will use to post events every time a request
completes. At that point, an aio_getevents() will return the completed result
to a struct io_event. I made a quick test program to verify the patch, and it
runs fine here:
http://www.xmailserver.org/eventfd-aio-test.c
The test program uses poll(2), but it'd, of course, work with select and epoll
too.
This can allow to schedule both block I/O and other poll-able devices
requests, and wait for results using select/poll/epoll. In a typical
scenario, an application would submit KAIO request using aio_submit(), and
will also use epoll_ctl() on the whole other class of devices (that with the
addition of signals, timers and user events, now it's pretty much complete),
and then would:
epoll_wait(...);
for_each_event {
if (curr_event_is_kaiofd) {
aio_getevents();
dispatch_aio_events();
} else {
dispatch_epoll_event();
}
}
Signed-off-by: Davide Libenzi <davidel@xmailserver.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2007-05-11 12:23:21 +07:00
|
|
|
|
|
|
|
/*
|
|
|
|
* If the aio_resfd field of the userspace iocb is not zero,
|
2009-07-01 01:41:11 +07:00
|
|
|
* this is the underlying eventfd context to deliver events to.
|
signal/timer/event: KAIO eventfd support example
This is an example about how to add eventfd support to the current KAIO code,
in order to enable KAIO to post readiness events to a pollable fd (hence
compatible with POSIX select/poll). The KAIO code simply signals the eventfd
fd when events are ready, and this triggers a POLLIN in the fd. This patch
uses a reserved for future use member of the struct iocb to pass an eventfd
file descriptor, that KAIO will use to post events every time a request
completes. At that point, an aio_getevents() will return the completed result
to a struct io_event. I made a quick test program to verify the patch, and it
runs fine here:
http://www.xmailserver.org/eventfd-aio-test.c
The test program uses poll(2), but it'd, of course, work with select and epoll
too.
This can allow to schedule both block I/O and other poll-able devices
requests, and wait for results using select/poll/epoll. In a typical
scenario, an application would submit KAIO request using aio_submit(), and
will also use epoll_ctl() on the whole other class of devices (that with the
addition of signals, timers and user events, now it's pretty much complete),
and then would:
epoll_wait(...);
for_each_event {
if (curr_event_is_kaiofd) {
aio_getevents();
dispatch_aio_events();
} else {
dispatch_epoll_event();
}
}
Signed-off-by: Davide Libenzi <davidel@xmailserver.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2007-05-11 12:23:21 +07:00
|
|
|
*/
|
2009-07-01 01:41:11 +07:00
|
|
|
struct eventfd_ctx *ki_eventfd;
|
2005-04-17 05:20:36 +07:00
|
|
|
};
|
|
|
|
|
2012-07-31 04:42:56 +07:00
|
|
|
static inline bool is_sync_kiocb(struct kiocb *kiocb)
|
|
|
|
{
|
2013-05-08 06:19:10 +07:00
|
|
|
return kiocb->ki_ctx == NULL;
|
2012-07-31 04:42:56 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline void init_sync_kiocb(struct kiocb *kiocb, struct file *filp)
|
|
|
|
{
|
|
|
|
*kiocb = (struct kiocb) {
|
2013-05-08 06:19:10 +07:00
|
|
|
.ki_ctx = NULL,
|
2012-07-31 04:42:56 +07:00
|
|
|
.ki_filp = filp,
|
|
|
|
.ki_obj.tsk = current,
|
|
|
|
};
|
|
|
|
}
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
/* prototypes */
|
2008-10-16 12:05:12 +07:00
|
|
|
#ifdef CONFIG_AIO
|
2008-02-14 06:03:15 +07:00
|
|
|
extern ssize_t wait_on_sync_kiocb(struct kiocb *iocb);
|
2013-05-08 06:18:29 +07:00
|
|
|
extern void aio_complete(struct kiocb *iocb, long res, long res2);
|
2005-04-17 05:20:36 +07:00
|
|
|
struct mm_struct;
|
2008-02-14 06:03:15 +07:00
|
|
|
extern void exit_aio(struct mm_struct *mm);
|
2010-05-27 04:44:26 +07:00
|
|
|
extern long do_io_submit(aio_context_t ctx_id, long nr,
|
|
|
|
struct iocb __user *__user *iocbpp, bool compat);
|
2013-05-08 06:18:49 +07:00
|
|
|
void kiocb_set_cancel_fn(struct kiocb *req, kiocb_cancel_fn *cancel);
|
2008-10-16 12:05:12 +07:00
|
|
|
#else
|
|
|
|
static inline ssize_t wait_on_sync_kiocb(struct kiocb *iocb) { return 0; }
|
2013-05-08 06:18:29 +07:00
|
|
|
static inline void aio_complete(struct kiocb *iocb, long res, long res2) { }
|
2008-10-16 12:05:12 +07:00
|
|
|
struct mm_struct;
|
|
|
|
static inline void exit_aio(struct mm_struct *mm) { }
|
2010-05-27 04:44:26 +07:00
|
|
|
static inline long do_io_submit(aio_context_t ctx_id, long nr,
|
|
|
|
struct iocb __user * __user *iocbpp,
|
|
|
|
bool compat) { return 0; }
|
2013-05-08 06:18:49 +07:00
|
|
|
static inline void kiocb_set_cancel_fn(struct kiocb *req,
|
|
|
|
kiocb_cancel_fn *cancel) { }
|
2008-10-16 12:05:12 +07:00
|
|
|
#endif /* CONFIG_AIO */
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
static inline struct kiocb *list_kiocb(struct list_head *h)
|
|
|
|
{
|
|
|
|
return list_entry(h, struct kiocb, ki_list);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* for sysctl: */
|
2005-11-07 15:59:31 +07:00
|
|
|
extern unsigned long aio_nr;
|
|
|
|
extern unsigned long aio_max_nr;
|
2005-04-17 05:20:36 +07:00
|
|
|
|
|
|
|
#endif /* __LINUX__AIO_H */
|