1 /* SPDX-License-Identifier: GPL-2.0 */
3 #define TRACE_SYSTEM block
5 #if !defined(_TRACE_BLOCK_H) || defined(TRACE_HEADER_MULTI_READ)
8 #include <linux/blktrace_api.h>
9 #include <linux/blkdev.h>
10 #include <linux/buffer_head.h>
11 #include <linux/tracepoint.h>
15 #ifdef CONFIG_BUFFER_HEAD
16 DECLARE_EVENT_CLASS(block_buffer,
18 TP_PROTO(struct buffer_head *bh),
24 __field( sector_t, sector )
25 __field( size_t, size )
29 __entry->dev = bh->b_bdev->bd_dev;
30 __entry->sector = bh->b_blocknr;
31 __entry->size = bh->b_size;
34 TP_printk("%d,%d sector=%llu size=%zu",
35 MAJOR(__entry->dev), MINOR(__entry->dev),
36 (unsigned long long)__entry->sector, __entry->size
41 * block_touch_buffer - mark a buffer accessed
42 * @bh: buffer_head being touched
44 * Called from touch_buffer().
46 DEFINE_EVENT(block_buffer, block_touch_buffer,
48 TP_PROTO(struct buffer_head *bh),
54 * block_dirty_buffer - mark a buffer dirty
55 * @bh: buffer_head being dirtied
57 * Called from mark_buffer_dirty().
59 DEFINE_EVENT(block_buffer, block_dirty_buffer,
61 TP_PROTO(struct buffer_head *bh),
65 #endif /* CONFIG_BUFFER_HEAD */
68 * block_rq_requeue - place block IO request back on a queue
69 * @rq: block IO operation request
71 * The block operation request @rq is being placed back into queue
72 * @q. For some reason the request was not completed and needs to be
73 * put back in the queue.
75 TRACE_EVENT(block_rq_requeue,
77 TP_PROTO(struct request *rq),
83 __field( sector_t, sector )
84 __field( unsigned int, nr_sector )
85 __array( char, rwbs, RWBS_LEN )
86 __dynamic_array( char, cmd, 1 )
90 __entry->dev = rq->q->disk ? disk_devt(rq->q->disk) : 0;
91 __entry->sector = blk_rq_trace_sector(rq);
92 __entry->nr_sector = blk_rq_trace_nr_sectors(rq);
94 blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
95 __get_str(cmd)[0] = '\0';
98 TP_printk("%d,%d %s (%s) %llu + %u [%d]",
99 MAJOR(__entry->dev), MINOR(__entry->dev),
100 __entry->rwbs, __get_str(cmd),
101 (unsigned long long)__entry->sector,
102 __entry->nr_sector, 0)
105 DECLARE_EVENT_CLASS(block_rq_completion,
107 TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
109 TP_ARGS(rq, error, nr_bytes),
112 __field( dev_t, dev )
113 __field( sector_t, sector )
114 __field( unsigned int, nr_sector )
115 __field( int , error )
116 __array( char, rwbs, RWBS_LEN )
117 __dynamic_array( char, cmd, 1 )
121 __entry->dev = rq->q->disk ? disk_devt(rq->q->disk) : 0;
122 __entry->sector = blk_rq_pos(rq);
123 __entry->nr_sector = nr_bytes >> 9;
124 __entry->error = blk_status_to_errno(error);
126 blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
127 __get_str(cmd)[0] = '\0';
130 TP_printk("%d,%d %s (%s) %llu + %u [%d]",
131 MAJOR(__entry->dev), MINOR(__entry->dev),
132 __entry->rwbs, __get_str(cmd),
133 (unsigned long long)__entry->sector,
134 __entry->nr_sector, __entry->error)
138 * block_rq_complete - block IO operation completed by device driver
139 * @rq: block operations request
140 * @error: status code
141 * @nr_bytes: number of completed bytes
143 * The block_rq_complete tracepoint event indicates that some portion
144 * of operation request has been completed by the device driver. If
145 * the @rq->bio is %NULL, then there is absolutely no additional work to
146 * do for the request. If @rq->bio is non-NULL then there is
147 * additional work required to complete the request.
149 DEFINE_EVENT(block_rq_completion, block_rq_complete,
151 TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
153 TP_ARGS(rq, error, nr_bytes)
157 * block_rq_error - block IO operation error reported by device driver
158 * @rq: block operations request
159 * @error: status code
160 * @nr_bytes: number of completed bytes
162 * The block_rq_error tracepoint event indicates that some portion
163 * of operation request has failed as reported by the device driver.
165 DEFINE_EVENT(block_rq_completion, block_rq_error,
167 TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
169 TP_ARGS(rq, error, nr_bytes)
172 DECLARE_EVENT_CLASS(block_rq,
174 TP_PROTO(struct request *rq),
179 __field( dev_t, dev )
180 __field( sector_t, sector )
181 __field( unsigned int, nr_sector )
182 __field( unsigned int, bytes )
183 __array( char, rwbs, RWBS_LEN )
184 __array( char, comm, TASK_COMM_LEN )
185 __dynamic_array( char, cmd, 1 )
189 __entry->dev = rq->q->disk ? disk_devt(rq->q->disk) : 0;
190 __entry->sector = blk_rq_trace_sector(rq);
191 __entry->nr_sector = blk_rq_trace_nr_sectors(rq);
192 __entry->bytes = blk_rq_bytes(rq);
194 blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
195 __get_str(cmd)[0] = '\0';
196 memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
199 TP_printk("%d,%d %s %u (%s) %llu + %u [%s]",
200 MAJOR(__entry->dev), MINOR(__entry->dev),
201 __entry->rwbs, __entry->bytes, __get_str(cmd),
202 (unsigned long long)__entry->sector,
203 __entry->nr_sector, __entry->comm)
207 * block_rq_insert - insert block operation request into queue
208 * @rq: block IO operation request
210 * Called immediately before block operation request @rq is inserted
211 * into queue @q. The fields in the operation request @rq struct can
212 * be examined to determine which device and sectors the pending
213 * operation would access.
215 DEFINE_EVENT(block_rq, block_rq_insert,
217 TP_PROTO(struct request *rq),
223 * block_rq_issue - issue pending block IO request operation to device driver
224 * @rq: block IO operation request
226 * Called when block operation request @rq from queue @q is sent to a
227 * device driver for processing.
229 DEFINE_EVENT(block_rq, block_rq_issue,
231 TP_PROTO(struct request *rq),
237 * block_rq_merge - merge request with another one in the elevator
238 * @rq: block IO operation request
240 * Called when block operation request @rq from queue @q is merged to another
241 * request queued in the elevator.
243 DEFINE_EVENT(block_rq, block_rq_merge,
245 TP_PROTO(struct request *rq),
251 * block_io_start - insert a request for execution
252 * @rq: block IO operation request
254 * Called when block operation request @rq is queued for execution
256 DEFINE_EVENT(block_rq, block_io_start,
258 TP_PROTO(struct request *rq),
264 * block_io_done - block IO operation request completed
265 * @rq: block IO operation request
267 * Called when block operation request @rq is completed
269 DEFINE_EVENT(block_rq, block_io_done,
271 TP_PROTO(struct request *rq),
277 * block_bio_complete - completed all work on the block operation
278 * @q: queue holding the block operation
279 * @bio: block operation completed
281 * This tracepoint indicates there is no further work to do on this
282 * block IO operation @bio.
284 TRACE_EVENT(block_bio_complete,
286 TP_PROTO(struct request_queue *q, struct bio *bio),
291 __field( dev_t, dev )
292 __field( sector_t, sector )
293 __field( unsigned, nr_sector )
294 __field( int, error )
295 __array( char, rwbs, RWBS_LEN)
299 __entry->dev = bio_dev(bio);
300 __entry->sector = bio->bi_iter.bi_sector;
301 __entry->nr_sector = bio_sectors(bio);
302 __entry->error = blk_status_to_errno(bio->bi_status);
303 blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
306 TP_printk("%d,%d %s %llu + %u [%d]",
307 MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
308 (unsigned long long)__entry->sector,
309 __entry->nr_sector, __entry->error)
312 DECLARE_EVENT_CLASS(block_bio,
314 TP_PROTO(struct bio *bio),
319 __field( dev_t, dev )
320 __field( sector_t, sector )
321 __field( unsigned int, nr_sector )
322 __array( char, rwbs, RWBS_LEN )
323 __array( char, comm, TASK_COMM_LEN )
327 __entry->dev = bio_dev(bio);
328 __entry->sector = bio->bi_iter.bi_sector;
329 __entry->nr_sector = bio_sectors(bio);
330 blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
331 memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
334 TP_printk("%d,%d %s %llu + %u [%s]",
335 MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
336 (unsigned long long)__entry->sector,
337 __entry->nr_sector, __entry->comm)
341 * block_bio_bounce - used bounce buffer when processing block operation
342 * @bio: block operation
344 * A bounce buffer was used to handle the block operation @bio in @q.
345 * This occurs when hardware limitations prevent a direct transfer of
346 * data between the @bio data memory area and the IO device. Use of a
347 * bounce buffer requires extra copying of data and decreases
350 DEFINE_EVENT(block_bio, block_bio_bounce,
351 TP_PROTO(struct bio *bio),
356 * block_bio_backmerge - merging block operation to the end of an existing operation
357 * @bio: new block operation to merge
359 * Merging block request @bio to the end of an existing block request.
361 DEFINE_EVENT(block_bio, block_bio_backmerge,
362 TP_PROTO(struct bio *bio),
367 * block_bio_frontmerge - merging block operation to the beginning of an existing operation
368 * @bio: new block operation to merge
370 * Merging block IO operation @bio to the beginning of an existing block request.
372 DEFINE_EVENT(block_bio, block_bio_frontmerge,
373 TP_PROTO(struct bio *bio),
378 * block_bio_queue - putting new block IO operation in queue
379 * @bio: new block operation
381 * About to place the block IO operation @bio into queue @q.
383 DEFINE_EVENT(block_bio, block_bio_queue,
384 TP_PROTO(struct bio *bio),
389 * block_getrq - get a free request entry in queue for block IO operations
390 * @bio: pending block IO operation (can be %NULL)
392 * A request struct has been allocated to handle the block IO operation @bio.
394 DEFINE_EVENT(block_bio, block_getrq,
395 TP_PROTO(struct bio *bio),
400 * block_plug - keep operations requests in request queue
401 * @q: request queue to plug
403 * Plug the request queue @q. Do not allow block operation requests
404 * to be sent to the device driver. Instead, accumulate requests in
405 * the queue to improve throughput performance of the block device.
407 TRACE_EVENT(block_plug,
409 TP_PROTO(struct request_queue *q),
414 __array( char, comm, TASK_COMM_LEN )
418 memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
421 TP_printk("[%s]", __entry->comm)
424 DECLARE_EVENT_CLASS(block_unplug,
426 TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
428 TP_ARGS(q, depth, explicit),
431 __field( int, nr_rq )
432 __array( char, comm, TASK_COMM_LEN )
436 __entry->nr_rq = depth;
437 memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
440 TP_printk("[%s] %d", __entry->comm, __entry->nr_rq)
444 * block_unplug - release of operations requests in request queue
445 * @q: request queue to unplug
446 * @depth: number of requests just added to the queue
447 * @explicit: whether this was an explicit unplug, or one from schedule()
449 * Unplug request queue @q because device driver is scheduled to work
450 * on elements in the request queue.
452 DEFINE_EVENT(block_unplug, block_unplug,
454 TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
456 TP_ARGS(q, depth, explicit)
460 * block_split - split a single bio struct into two bio structs
461 * @bio: block operation being split
462 * @new_sector: The starting sector for the new bio
464 * The bio request @bio needs to be split into two bio requests. The newly
465 * created @bio request starts at @new_sector. This split may be required due to
466 * hardware limitations such as operation crossing device boundaries in a RAID
469 TRACE_EVENT(block_split,
471 TP_PROTO(struct bio *bio, unsigned int new_sector),
473 TP_ARGS(bio, new_sector),
476 __field( dev_t, dev )
477 __field( sector_t, sector )
478 __field( sector_t, new_sector )
479 __array( char, rwbs, RWBS_LEN )
480 __array( char, comm, TASK_COMM_LEN )
484 __entry->dev = bio_dev(bio);
485 __entry->sector = bio->bi_iter.bi_sector;
486 __entry->new_sector = new_sector;
487 blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
488 memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
491 TP_printk("%d,%d %s %llu / %llu [%s]",
492 MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
493 (unsigned long long)__entry->sector,
494 (unsigned long long)__entry->new_sector,
499 * block_bio_remap - map request for a logical device to the raw device
500 * @bio: revised operation
501 * @dev: original device for the operation
502 * @from: original sector for the operation
504 * An operation for a logical device has been mapped to the
507 TRACE_EVENT(block_bio_remap,
509 TP_PROTO(struct bio *bio, dev_t dev, sector_t from),
511 TP_ARGS(bio, dev, from),
514 __field( dev_t, dev )
515 __field( sector_t, sector )
516 __field( unsigned int, nr_sector )
517 __field( dev_t, old_dev )
518 __field( sector_t, old_sector )
519 __array( char, rwbs, RWBS_LEN)
523 __entry->dev = bio_dev(bio);
524 __entry->sector = bio->bi_iter.bi_sector;
525 __entry->nr_sector = bio_sectors(bio);
526 __entry->old_dev = dev;
527 __entry->old_sector = from;
528 blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
531 TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu",
532 MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
533 (unsigned long long)__entry->sector,
535 MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
536 (unsigned long long)__entry->old_sector)
540 * block_rq_remap - map request for a block operation request
541 * @rq: block IO operation request
542 * @dev: device for the operation
543 * @from: original sector for the operation
545 * The block operation request @rq in @q has been remapped. The block
546 * operation request @rq holds the current information and @from hold
547 * the original sector.
549 TRACE_EVENT(block_rq_remap,
551 TP_PROTO(struct request *rq, dev_t dev, sector_t from),
553 TP_ARGS(rq, dev, from),
556 __field( dev_t, dev )
557 __field( sector_t, sector )
558 __field( unsigned int, nr_sector )
559 __field( dev_t, old_dev )
560 __field( sector_t, old_sector )
561 __field( unsigned int, nr_bios )
562 __array( char, rwbs, RWBS_LEN)
566 __entry->dev = disk_devt(rq->q->disk);
567 __entry->sector = blk_rq_pos(rq);
568 __entry->nr_sector = blk_rq_sectors(rq);
569 __entry->old_dev = dev;
570 __entry->old_sector = from;
571 __entry->nr_bios = blk_rq_count_bios(rq);
572 blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
575 TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu %u",
576 MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
577 (unsigned long long)__entry->sector,
579 MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
580 (unsigned long long)__entry->old_sector, __entry->nr_bios)
583 #endif /* _TRACE_BLOCK_H */
585 /* This part must be outside protection */
586 #include <trace/define_trace.h>