xref: /openbmc/linux/io_uring/io_uring.h (revision 17437f31)
1de23077eSJens Axboe #ifndef IOU_CORE_H
2de23077eSJens Axboe #define IOU_CORE_H
3de23077eSJens Axboe 
4de23077eSJens Axboe #include <linux/errno.h>
5cd40cae2SJens Axboe #include <linux/lockdep.h>
6de23077eSJens Axboe #include "io_uring_types.h"
7de23077eSJens Axboe 
897b388d7SJens Axboe enum {
997b388d7SJens Axboe 	IOU_OK			= 0,
1097b388d7SJens Axboe 	IOU_ISSUE_SKIP_COMPLETE	= -EIOCBQUEUED,
1197b388d7SJens Axboe };
1297b388d7SJens Axboe 
13531113bbSJens Axboe static inline void req_set_fail(struct io_kiocb *req)
14531113bbSJens Axboe {
15531113bbSJens Axboe 	req->flags |= REQ_F_FAIL;
16531113bbSJens Axboe 	if (req->flags & REQ_F_CQE_SKIP) {
17531113bbSJens Axboe 		req->flags &= ~REQ_F_CQE_SKIP;
18531113bbSJens Axboe 		req->flags |= REQ_F_SKIP_LINK_CQES;
19531113bbSJens Axboe 	}
20531113bbSJens Axboe }
21531113bbSJens Axboe 
22de23077eSJens Axboe static inline void io_req_set_res(struct io_kiocb *req, s32 res, u32 cflags)
23de23077eSJens Axboe {
24de23077eSJens Axboe 	req->cqe.res = res;
25de23077eSJens Axboe 	req->cqe.flags = cflags;
26de23077eSJens Axboe }
27de23077eSJens Axboe 
2899f15d8dSJens Axboe static inline bool req_has_async_data(struct io_kiocb *req)
2999f15d8dSJens Axboe {
3099f15d8dSJens Axboe 	return req->flags & REQ_F_ASYNC_DATA;
3199f15d8dSJens Axboe }
3299f15d8dSJens Axboe 
33531113bbSJens Axboe static inline void io_put_file(struct file *file)
34531113bbSJens Axboe {
35531113bbSJens Axboe 	if (file)
36531113bbSJens Axboe 		fput(file);
37531113bbSJens Axboe }
38531113bbSJens Axboe 
39cd40cae2SJens Axboe static inline void io_ring_submit_unlock(struct io_ring_ctx *ctx,
40cd40cae2SJens Axboe 					 unsigned issue_flags)
41cd40cae2SJens Axboe {
42cd40cae2SJens Axboe 	lockdep_assert_held(&ctx->uring_lock);
43cd40cae2SJens Axboe 	if (issue_flags & IO_URING_F_UNLOCKED)
44cd40cae2SJens Axboe 		mutex_unlock(&ctx->uring_lock);
45cd40cae2SJens Axboe }
46cd40cae2SJens Axboe 
47cd40cae2SJens Axboe static inline void io_ring_submit_lock(struct io_ring_ctx *ctx,
48cd40cae2SJens Axboe 				       unsigned issue_flags)
49cd40cae2SJens Axboe {
50cd40cae2SJens Axboe 	/*
51cd40cae2SJens Axboe 	 * "Normal" inline submissions always hold the uring_lock, since we
52cd40cae2SJens Axboe 	 * grab it from the system call. Same is true for the SQPOLL offload.
53cd40cae2SJens Axboe 	 * The only exception is when we've detached the request and issue it
54cd40cae2SJens Axboe 	 * from an async worker thread, grab the lock for that case.
55cd40cae2SJens Axboe 	 */
56cd40cae2SJens Axboe 	if (issue_flags & IO_URING_F_UNLOCKED)
57cd40cae2SJens Axboe 		mutex_lock(&ctx->uring_lock);
58cd40cae2SJens Axboe 	lockdep_assert_held(&ctx->uring_lock);
59cd40cae2SJens Axboe }
60cd40cae2SJens Axboe 
61f9ead18cSJens Axboe static inline void io_commit_cqring(struct io_ring_ctx *ctx)
62f9ead18cSJens Axboe {
63f9ead18cSJens Axboe 	/* order cqe stores with ring update */
64f9ead18cSJens Axboe 	smp_store_release(&ctx->rings->cq.tail, ctx->cached_cq_tail);
65f9ead18cSJens Axboe }
66f9ead18cSJens Axboe 
67*17437f31SJens Axboe static inline bool io_sqring_full(struct io_ring_ctx *ctx)
68*17437f31SJens Axboe {
69*17437f31SJens Axboe 	struct io_rings *r = ctx->rings;
70*17437f31SJens Axboe 
71*17437f31SJens Axboe 	return READ_ONCE(r->sq.tail) - ctx->cached_sq_head == ctx->sq_entries;
72*17437f31SJens Axboe }
73*17437f31SJens Axboe 
74*17437f31SJens Axboe static inline unsigned int io_sqring_entries(struct io_ring_ctx *ctx)
75*17437f31SJens Axboe {
76*17437f31SJens Axboe 	struct io_rings *rings = ctx->rings;
77*17437f31SJens Axboe 
78*17437f31SJens Axboe 	/* make sure SQ entry isn't read before tail */
79*17437f31SJens Axboe 	return smp_load_acquire(&rings->sq.tail) - ctx->cached_sq_head;
80*17437f31SJens Axboe }
81*17437f31SJens Axboe 
82*17437f31SJens Axboe static inline bool io_run_task_work(void)
83*17437f31SJens Axboe {
84*17437f31SJens Axboe 	if (test_thread_flag(TIF_NOTIFY_SIGNAL) || task_work_pending(current)) {
85*17437f31SJens Axboe 		__set_current_state(TASK_RUNNING);
86*17437f31SJens Axboe 		clear_notify_signal();
87*17437f31SJens Axboe 		if (task_work_pending(current))
88*17437f31SJens Axboe 			task_work_run();
89*17437f31SJens Axboe 		return true;
90*17437f31SJens Axboe 	}
91*17437f31SJens Axboe 
92*17437f31SJens Axboe 	return false;
93*17437f31SJens Axboe }
94*17437f31SJens Axboe 
9599f15d8dSJens Axboe void __io_req_complete(struct io_kiocb *req, unsigned issue_flags);
9659915143SJens Axboe void io_req_complete_post(struct io_kiocb *req);
9759915143SJens Axboe void __io_req_complete_post(struct io_kiocb *req);
98f9ead18cSJens Axboe bool io_fill_cqe_aux(struct io_ring_ctx *ctx, u64 user_data, s32 res,
99f9ead18cSJens Axboe 		     u32 cflags);
100f9ead18cSJens Axboe void io_cqring_ev_posted(struct io_ring_ctx *ctx);
101f9ead18cSJens Axboe void __user *io_buffer_select(struct io_kiocb *req, size_t *len,
102f9ead18cSJens Axboe 			      unsigned int issue_flags);
103f9ead18cSJens Axboe unsigned int io_put_kbuf(struct io_kiocb *req, unsigned issue_flags);
104f9ead18cSJens Axboe 
105f9ead18cSJens Axboe static inline bool io_do_buffer_select(struct io_kiocb *req)
106f9ead18cSJens Axboe {
107f9ead18cSJens Axboe 	if (!(req->flags & REQ_F_BUFFER_SELECT))
108f9ead18cSJens Axboe 		return false;
109f9ead18cSJens Axboe 	return !(req->flags & (REQ_F_BUFFER_SELECTED|REQ_F_BUFFER_RING));
110f9ead18cSJens Axboe }
111f9ead18cSJens Axboe 
112531113bbSJens Axboe struct file *io_file_get_normal(struct io_kiocb *req, int fd);
113531113bbSJens Axboe struct file *io_file_get_fixed(struct io_kiocb *req, int fd,
114531113bbSJens Axboe 			       unsigned issue_flags);
115cd40cae2SJens Axboe int io_fixed_fd_install(struct io_kiocb *req, unsigned int issue_flags,
116cd40cae2SJens Axboe 			struct file *file, unsigned int file_slot);
117f9ead18cSJens Axboe int io_install_fixed_file(struct io_kiocb *req, struct file *file,
118f9ead18cSJens Axboe 			  unsigned int issue_flags, u32 slot_index);
119cd40cae2SJens Axboe 
120cd40cae2SJens Axboe int io_rsrc_node_switch_start(struct io_ring_ctx *ctx);
121cd40cae2SJens Axboe int io_queue_rsrc_removal(struct io_rsrc_data *data, unsigned idx,
122cd40cae2SJens Axboe 			  struct io_rsrc_node *node, void *rsrc);
123cd40cae2SJens Axboe void io_rsrc_node_switch(struct io_ring_ctx *ctx,
124cd40cae2SJens Axboe 			 struct io_rsrc_data *data_to_kill);
125cd40cae2SJens Axboe bool io_is_uring_fops(struct file *file);
12699f15d8dSJens Axboe bool io_alloc_async_data(struct io_kiocb *req);
12799f15d8dSJens Axboe void io_req_task_work_add(struct io_kiocb *req);
12859915143SJens Axboe void io_req_tw_post_queue(struct io_kiocb *req, s32 res, u32 cflags);
12959915143SJens Axboe void io_req_task_complete(struct io_kiocb *req, bool *locked);
13059915143SJens Axboe void io_req_task_queue_fail(struct io_kiocb *req, int ret);
13159915143SJens Axboe int io_try_cancel(struct io_kiocb *req, struct io_cancel_data *cd);
132*17437f31SJens Axboe __cold void io_uring_cancel_generic(bool cancel_all, struct io_sq_data *sqd);
133*17437f31SJens Axboe int io_uring_alloc_task_context(struct task_struct *task,
134*17437f31SJens Axboe 				struct io_ring_ctx *ctx);
135*17437f31SJens Axboe 
136*17437f31SJens Axboe int io_submit_sqes(struct io_ring_ctx *ctx, unsigned int nr);
137*17437f31SJens Axboe int io_do_iopoll(struct io_ring_ctx *ctx, bool force_nonspin);
13859915143SJens Axboe 
13959915143SJens Axboe void io_free_req(struct io_kiocb *req);
14059915143SJens Axboe void io_queue_next(struct io_kiocb *req);
14159915143SJens Axboe 
14259915143SJens Axboe #define io_for_each_link(pos, head) \
14359915143SJens Axboe 	for (pos = (head); pos; pos = pos->link)
144531113bbSJens Axboe 
145de23077eSJens Axboe #endif
146