1 /* SPDX-License-Identifier: GPL-2.0 */
3 #define TRACE_SYSTEM io_uring
5 #if !defined(_TRACE_IO_URING_H) || defined(TRACE_HEADER_MULTI_READ)
6 #define _TRACE_IO_URING_H
8 #include <linux/tracepoint.h>
9 #include <uapi/linux/io_uring.h>
10 #include <linux/io_uring_types.h>
11 #include <linux/io_uring.h>
16 * io_uring_create - called after a new io_uring context was prepared
18 * @fd: corresponding file descriptor
19 * @ctx: pointer to a ring context structure
20 * @sq_entries: actual SQ size
21 * @cq_entries: actual CQ size
22 * @flags: SQ ring flags, provided to io_uring_setup(2)
24 * Allows to trace io_uring creation and provide pointer to a context, that can
25 * be used later to find correlated events.
27 TRACE_EVENT(io_uring_create,
29 TP_PROTO(int fd, void *ctx, u32 sq_entries, u32 cq_entries, u32 flags),
31 TP_ARGS(fd, ctx, sq_entries, cq_entries, flags),
35 __field( void *, ctx )
36 __field( u32, sq_entries )
37 __field( u32, cq_entries )
44 __entry->sq_entries = sq_entries;
45 __entry->cq_entries = cq_entries;
46 __entry->flags = flags;
49 TP_printk("ring %p, fd %d sq size %d, cq size %d, flags 0x%x",
50 __entry->ctx, __entry->fd, __entry->sq_entries,
51 __entry->cq_entries, __entry->flags)
55 * io_uring_register - called after a buffer/file/eventfd was successfully
56 * registered for a ring
58 * @ctx: pointer to a ring context structure
59 * @opcode: describes which operation to perform
60 * @nr_user_files: number of registered files
61 * @nr_user_bufs: number of registered buffers
64 * Allows to trace fixed files/buffers, that could be registered to
65 * avoid an overhead of getting references to them for every operation. This
66 * event, together with io_uring_file_get, can provide a full picture of how
67 * much overhead one can reduce via fixing.
69 TRACE_EVENT(io_uring_register,
71 TP_PROTO(void *ctx, unsigned opcode, unsigned nr_files,
72 unsigned nr_bufs, long ret),
74 TP_ARGS(ctx, opcode, nr_files, nr_bufs, ret),
77 __field( void *, ctx )
78 __field( unsigned, opcode )
79 __field( unsigned, nr_files)
80 __field( unsigned, nr_bufs )
86 __entry->opcode = opcode;
87 __entry->nr_files = nr_files;
88 __entry->nr_bufs = nr_bufs;
92 TP_printk("ring %p, opcode %d, nr_user_files %d, nr_user_bufs %d, "
94 __entry->ctx, __entry->opcode, __entry->nr_files,
95 __entry->nr_bufs, __entry->ret)
99 * io_uring_file_get - called before getting references to an SQE file
101 * @req: pointer to a submitted request
102 * @fd: SQE file descriptor
104 * Allows to trace out how often an SQE file reference is obtained, which can
105 * help figuring out if it makes sense to use fixed files, or check that fixed
106 * files are used correctly.
108 TRACE_EVENT(io_uring_file_get,
110 TP_PROTO(struct io_kiocb *req, int fd),
115 __field( void *, ctx )
116 __field( void *, req )
117 __field( u64, user_data )
122 __entry->ctx = req->ctx;
124 __entry->user_data = req->cqe.user_data;
128 TP_printk("ring %p, req %p, user_data 0x%llx, fd %d",
129 __entry->ctx, __entry->req, __entry->user_data, __entry->fd)
133 * io_uring_queue_async_work - called before submitting a new async work
135 * @req: pointer to a submitted request
136 * @rw: type of workqueue, hashed or normal
138 * Allows to trace asynchronous work submission.
140 TRACE_EVENT(io_uring_queue_async_work,
142 TP_PROTO(struct io_kiocb *req, int rw),
147 __field( void *, ctx )
148 __field( void *, req )
149 __field( u64, user_data )
150 __field( u8, opcode )
151 __field( unsigned long long, flags )
152 __field( struct io_wq_work *, work )
155 __string( op_str, io_uring_get_opcode(req->opcode) )
159 __entry->ctx = req->ctx;
161 __entry->user_data = req->cqe.user_data;
162 __entry->flags = (__force unsigned long long) req->flags;
163 __entry->opcode = req->opcode;
164 __entry->work = &req->work;
167 __assign_str(op_str, io_uring_get_opcode(req->opcode));
170 TP_printk("ring %p, request %p, user_data 0x%llx, opcode %s, flags 0x%llx, %s queue, work %p",
171 __entry->ctx, __entry->req, __entry->user_data,
172 __get_str(op_str), __entry->flags,
173 __entry->rw ? "hashed" : "normal", __entry->work)
177 * io_uring_defer - called when an io_uring request is deferred
179 * @req: pointer to a deferred request
181 * Allows to track deferred requests, to get an insight about what requests are
182 * not started immediately.
184 TRACE_EVENT(io_uring_defer,
186 TP_PROTO(struct io_kiocb *req),
191 __field( void *, ctx )
192 __field( void *, req )
193 __field( unsigned long long, data )
194 __field( u8, opcode )
196 __string( op_str, io_uring_get_opcode(req->opcode) )
200 __entry->ctx = req->ctx;
202 __entry->data = req->cqe.user_data;
203 __entry->opcode = req->opcode;
205 __assign_str(op_str, io_uring_get_opcode(req->opcode));
208 TP_printk("ring %p, request %p, user_data 0x%llx, opcode %s",
209 __entry->ctx, __entry->req, __entry->data,
214 * io_uring_link - called before the io_uring request added into link_list of
217 * @req: pointer to a linked request
218 * @target_req: pointer to a previous request, that would contain @req
220 * Allows to track linked requests, to understand dependencies between requests
221 * and how does it influence their execution flow.
223 TRACE_EVENT(io_uring_link,
225 TP_PROTO(struct io_kiocb *req, struct io_kiocb *target_req),
227 TP_ARGS(req, target_req),
230 __field( void *, ctx )
231 __field( void *, req )
232 __field( void *, target_req )
236 __entry->ctx = req->ctx;
238 __entry->target_req = target_req;
241 TP_printk("ring %p, request %p linked after %p",
242 __entry->ctx, __entry->req, __entry->target_req)
246 * io_uring_cqring_wait - called before start waiting for an available CQE
248 * @ctx: pointer to a ring context structure
249 * @min_events: minimal number of events to wait for
251 * Allows to track waiting for CQE, so that we can e.g. troubleshoot
252 * situations, when an application wants to wait for an event, that never
255 TRACE_EVENT(io_uring_cqring_wait,
257 TP_PROTO(void *ctx, int min_events),
259 TP_ARGS(ctx, min_events),
262 __field( void *, ctx )
263 __field( int, min_events )
268 __entry->min_events = min_events;
271 TP_printk("ring %p, min_events %d", __entry->ctx, __entry->min_events)
275 * io_uring_fail_link - called before failing a linked request
277 * @req: request, which links were cancelled
278 * @link: cancelled link
280 * Allows to track linked requests cancellation, to see not only that some work
281 * was cancelled, but also which request was the reason.
283 TRACE_EVENT(io_uring_fail_link,
285 TP_PROTO(struct io_kiocb *req, struct io_kiocb *link),
290 __field( void *, ctx )
291 __field( void *, req )
292 __field( unsigned long long, user_data )
293 __field( u8, opcode )
294 __field( void *, link )
296 __string( op_str, io_uring_get_opcode(req->opcode) )
300 __entry->ctx = req->ctx;
302 __entry->user_data = req->cqe.user_data;
303 __entry->opcode = req->opcode;
304 __entry->link = link;
306 __assign_str(op_str, io_uring_get_opcode(req->opcode));
309 TP_printk("ring %p, request %p, user_data 0x%llx, opcode %s, link %p",
310 __entry->ctx, __entry->req, __entry->user_data,
311 __get_str(op_str), __entry->link)
315 * io_uring_complete - called when completing an SQE
317 * @ctx: pointer to a ring context structure
318 * @req: pointer to a submitted request
319 * @user_data: user data associated with the request
320 * @res: result of the request
321 * @cflags: completion flags
322 * @extra1: extra 64-bit data for CQE32
323 * @extra2: extra 64-bit data for CQE32
326 TRACE_EVENT(io_uring_complete,
328 TP_PROTO(void *ctx, void *req, u64 user_data, int res, unsigned cflags,
329 u64 extra1, u64 extra2),
331 TP_ARGS(ctx, req, user_data, res, cflags, extra1, extra2),
334 __field( void *, ctx )
335 __field( void *, req )
336 __field( u64, user_data )
338 __field( unsigned, cflags )
339 __field( u64, extra1 )
340 __field( u64, extra2 )
346 __entry->user_data = user_data;
348 __entry->cflags = cflags;
349 __entry->extra1 = extra1;
350 __entry->extra2 = extra2;
353 TP_printk("ring %p, req %p, user_data 0x%llx, result %d, cflags 0x%x "
354 "extra1 %llu extra2 %llu ",
355 __entry->ctx, __entry->req,
357 __entry->res, __entry->cflags,
358 (unsigned long long) __entry->extra1,
359 (unsigned long long) __entry->extra2)
363 * io_uring_submit_req - called before submitting a request
365 * @req: pointer to a submitted request
367 * Allows to track SQE submitting, to understand what was the source of it, SQ
368 * thread or io_uring_enter call.
370 TRACE_EVENT(io_uring_submit_req,
372 TP_PROTO(struct io_kiocb *req),
377 __field( void *, ctx )
378 __field( void *, req )
379 __field( unsigned long long, user_data )
380 __field( u8, opcode )
381 __field( unsigned long long, flags )
382 __field( bool, sq_thread )
384 __string( op_str, io_uring_get_opcode(req->opcode) )
388 __entry->ctx = req->ctx;
390 __entry->user_data = req->cqe.user_data;
391 __entry->opcode = req->opcode;
392 __entry->flags = (__force unsigned long long) req->flags;
393 __entry->sq_thread = req->ctx->flags & IORING_SETUP_SQPOLL;
395 __assign_str(op_str, io_uring_get_opcode(req->opcode));
398 TP_printk("ring %p, req %p, user_data 0x%llx, opcode %s, flags 0x%llx, "
399 "sq_thread %d", __entry->ctx, __entry->req,
400 __entry->user_data, __get_str(op_str), __entry->flags,
405 * io_uring_poll_arm - called after arming a poll wait if successful
407 * @req: pointer to the armed request
408 * @mask: request poll events mask
409 * @events: registered events of interest
411 * Allows to track which fds are waiting for and what are the events of
414 TRACE_EVENT(io_uring_poll_arm,
416 TP_PROTO(struct io_kiocb *req, int mask, int events),
418 TP_ARGS(req, mask, events),
421 __field( void *, ctx )
422 __field( void *, req )
423 __field( unsigned long long, user_data )
424 __field( u8, opcode )
426 __field( int, events )
428 __string( op_str, io_uring_get_opcode(req->opcode) )
432 __entry->ctx = req->ctx;
434 __entry->user_data = req->cqe.user_data;
435 __entry->opcode = req->opcode;
436 __entry->mask = mask;
437 __entry->events = events;
439 __assign_str(op_str, io_uring_get_opcode(req->opcode));
442 TP_printk("ring %p, req %p, user_data 0x%llx, opcode %s, mask 0x%x, events 0x%x",
443 __entry->ctx, __entry->req, __entry->user_data,
445 __entry->mask, __entry->events)
449 * io_uring_task_add - called after adding a task
451 * @req: pointer to request
452 * @mask: request poll events mask
455 TRACE_EVENT(io_uring_task_add,
457 TP_PROTO(struct io_kiocb *req, int mask),
462 __field( void *, ctx )
463 __field( void *, req )
464 __field( unsigned long long, user_data )
465 __field( u8, opcode )
468 __string( op_str, io_uring_get_opcode(req->opcode) )
472 __entry->ctx = req->ctx;
474 __entry->user_data = req->cqe.user_data;
475 __entry->opcode = req->opcode;
476 __entry->mask = mask;
478 __assign_str(op_str, io_uring_get_opcode(req->opcode));
481 TP_printk("ring %p, req %p, user_data 0x%llx, opcode %s, mask %x",
482 __entry->ctx, __entry->req, __entry->user_data,
488 * io_uring_req_failed - called when an sqe is errored dring submission
490 * @sqe: pointer to the io_uring_sqe that failed
491 * @req: pointer to request
492 * @error: error it failed with
494 * Allows easier diagnosing of malformed requests in production systems.
496 TRACE_EVENT(io_uring_req_failed,
498 TP_PROTO(const struct io_uring_sqe *sqe, struct io_kiocb *req, int error),
500 TP_ARGS(sqe, req, error),
503 __field( void *, ctx )
504 __field( void *, req )
505 __field( unsigned long long, user_data )
506 __field( u8, opcode )
508 __field( u8, ioprio )
512 __field( u32, op_flags )
513 __field( u16, buf_index )
514 __field( u16, personality )
515 __field( u32, file_index )
517 __field( u64, addr3 )
518 __field( int, error )
520 __string( op_str, io_uring_get_opcode(sqe->opcode) )
524 __entry->ctx = req->ctx;
526 __entry->user_data = sqe->user_data;
527 __entry->opcode = sqe->opcode;
528 __entry->flags = sqe->flags;
529 __entry->ioprio = sqe->ioprio;
530 __entry->off = sqe->off;
531 __entry->addr = sqe->addr;
532 __entry->len = sqe->len;
533 __entry->op_flags = sqe->poll32_events;
534 __entry->buf_index = sqe->buf_index;
535 __entry->personality = sqe->personality;
536 __entry->file_index = sqe->file_index;
537 __entry->pad1 = sqe->__pad2[0];
538 __entry->addr3 = sqe->addr3;
539 __entry->error = error;
541 __assign_str(op_str, io_uring_get_opcode(sqe->opcode));
544 TP_printk("ring %p, req %p, user_data 0x%llx, "
545 "opcode %s, flags 0x%x, prio=%d, off=%llu, addr=%llu, "
546 "len=%u, rw_flags=0x%x, buf_index=%d, "
547 "personality=%d, file_index=%d, pad=0x%llx, addr3=%llx, "
549 __entry->ctx, __entry->req, __entry->user_data,
551 __entry->flags, __entry->ioprio,
552 (unsigned long long)__entry->off,
553 (unsigned long long) __entry->addr, __entry->len,
555 __entry->buf_index, __entry->personality, __entry->file_index,
556 (unsigned long long) __entry->pad1,
557 (unsigned long long) __entry->addr3, __entry->error)
562 * io_uring_cqe_overflow - a CQE overflowed
564 * @ctx: pointer to a ring context structure
565 * @user_data: user data associated with the request
568 * @ocqe: pointer to the overflow cqe (if available)
571 TRACE_EVENT(io_uring_cqe_overflow,
573 TP_PROTO(void *ctx, unsigned long long user_data, s32 res, u32 cflags,
576 TP_ARGS(ctx, user_data, res, cflags, ocqe),
579 __field( void *, ctx )
580 __field( unsigned long long, user_data )
582 __field( u32, cflags )
583 __field( void *, ocqe )
588 __entry->user_data = user_data;
590 __entry->cflags = cflags;
591 __entry->ocqe = ocqe;
594 TP_printk("ring %p, user_data 0x%llx, res %d, cflags 0x%x, "
596 __entry->ctx, __entry->user_data, __entry->res,
597 __entry->cflags, __entry->ocqe)
601 * io_uring_task_work_run - ran task work
603 * @tctx: pointer to a io_uring_task
604 * @count: how many functions it ran
607 TRACE_EVENT(io_uring_task_work_run,
609 TP_PROTO(void *tctx, unsigned int count),
611 TP_ARGS(tctx, count),
614 __field( void *, tctx )
615 __field( unsigned int, count )
619 __entry->tctx = tctx;
620 __entry->count = count;
623 TP_printk("tctx %p, count %u", __entry->tctx, __entry->count)
626 TRACE_EVENT(io_uring_short_write,
628 TP_PROTO(void *ctx, u64 fpos, u64 wanted, u64 got),
630 TP_ARGS(ctx, fpos, wanted, got),
641 __entry->fpos = fpos;
642 __entry->wanted = wanted;
646 TP_printk("ring %p, fpos %lld, wanted %lld, got %lld",
647 __entry->ctx, __entry->fpos,
648 __entry->wanted, __entry->got)
652 * io_uring_local_work_run - ran ring local task work
654 * @tctx: pointer to a io_uring_ctx
655 * @count: how many functions it ran
656 * @loops: how many loops it ran
659 TRACE_EVENT(io_uring_local_work_run,
661 TP_PROTO(void *ctx, int count, unsigned int loops),
663 TP_ARGS(ctx, count, loops),
666 __field(void *, ctx )
668 __field(unsigned int, loops )
673 __entry->count = count;
674 __entry->loops = loops;
677 TP_printk("ring %p, count %d, loops %u", __entry->ctx, __entry->count, __entry->loops)
680 #endif /* _TRACE_IO_URING_H */
682 /* This part must be outside protection */
683 #include <trace/define_trace.h>