Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v6.2
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#undef TRACE_SYSTEM
  3#define TRACE_SYSTEM block
  4
  5#if !defined(_TRACE_BLOCK_H) || defined(TRACE_HEADER_MULTI_READ)
  6#define _TRACE_BLOCK_H
  7
  8#include <linux/blktrace_api.h>
  9#include <linux/blkdev.h>
 10#include <linux/buffer_head.h>
 11#include <linux/tracepoint.h>
 12
 13#define RWBS_LEN	8
 14
 15DECLARE_EVENT_CLASS(block_buffer,
 16
 17	TP_PROTO(struct buffer_head *bh),
 18
 19	TP_ARGS(bh),
 20
 21	TP_STRUCT__entry (
 22		__field(  dev_t,	dev			)
 23		__field(  sector_t,	sector			)
 24		__field(  size_t,	size			)
 25	),
 26
 27	TP_fast_assign(
 28		__entry->dev		= bh->b_bdev->bd_dev;
 29		__entry->sector		= bh->b_blocknr;
 30		__entry->size		= bh->b_size;
 31	),
 32
 33	TP_printk("%d,%d sector=%llu size=%zu",
 34		MAJOR(__entry->dev), MINOR(__entry->dev),
 35		(unsigned long long)__entry->sector, __entry->size
 36	)
 37);
 38
 39/**
 40 * block_touch_buffer - mark a buffer accessed
 41 * @bh: buffer_head being touched
 42 *
 43 * Called from touch_buffer().
 44 */
 45DEFINE_EVENT(block_buffer, block_touch_buffer,
 46
 47	TP_PROTO(struct buffer_head *bh),
 48
 49	TP_ARGS(bh)
 50);
 51
 52/**
 53 * block_dirty_buffer - mark a buffer dirty
 54 * @bh: buffer_head being dirtied
 55 *
 56 * Called from mark_buffer_dirty().
 57 */
 58DEFINE_EVENT(block_buffer, block_dirty_buffer,
 59
 60	TP_PROTO(struct buffer_head *bh),
 61
 62	TP_ARGS(bh)
 63);
 64
 65/**
 66 * block_rq_requeue - place block IO request back on a queue
 
 67 * @rq: block IO operation request
 68 *
 69 * The block operation request @rq is being placed back into queue
 70 * @q.  For some reason the request was not completed and needs to be
 71 * put back in the queue.
 72 */
 73TRACE_EVENT(block_rq_requeue,
 74
 75	TP_PROTO(struct request *rq),
 76
 77	TP_ARGS(rq),
 78
 79	TP_STRUCT__entry(
 80		__field(  dev_t,	dev			)
 81		__field(  sector_t,	sector			)
 82		__field(  unsigned int,	nr_sector		)
 83		__array(  char,		rwbs,	RWBS_LEN	)
 84		__dynamic_array( char,	cmd,	1		)
 85	),
 86
 87	TP_fast_assign(
 88		__entry->dev	   = rq->q->disk ? disk_devt(rq->q->disk) : 0;
 89		__entry->sector    = blk_rq_trace_sector(rq);
 90		__entry->nr_sector = blk_rq_trace_nr_sectors(rq);
 91
 92		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
 93		__get_str(cmd)[0] = '\0';
 94	),
 95
 96	TP_printk("%d,%d %s (%s) %llu + %u [%d]",
 97		  MAJOR(__entry->dev), MINOR(__entry->dev),
 98		  __entry->rwbs, __get_str(cmd),
 99		  (unsigned long long)__entry->sector,
100		  __entry->nr_sector, 0)
101);
102
103DECLARE_EVENT_CLASS(block_rq_completion,
 
 
 
 
 
 
 
 
 
 
 
 
104
105	TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
106
107	TP_ARGS(rq, error, nr_bytes),
108
109	TP_STRUCT__entry(
110		__field(  dev_t,	dev			)
111		__field(  sector_t,	sector			)
112		__field(  unsigned int,	nr_sector		)
113		__field(  int	,	error			)
114		__array(  char,		rwbs,	RWBS_LEN	)
115		__dynamic_array( char,	cmd,	1		)
116	),
117
118	TP_fast_assign(
119		__entry->dev	   = rq->q->disk ? disk_devt(rq->q->disk) : 0;
120		__entry->sector    = blk_rq_pos(rq);
121		__entry->nr_sector = nr_bytes >> 9;
122		__entry->error     = blk_status_to_errno(error);
123
124		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
125		__get_str(cmd)[0] = '\0';
126	),
127
128	TP_printk("%d,%d %s (%s) %llu + %u [%d]",
129		  MAJOR(__entry->dev), MINOR(__entry->dev),
130		  __entry->rwbs, __get_str(cmd),
131		  (unsigned long long)__entry->sector,
132		  __entry->nr_sector, __entry->error)
133);
134
135/**
136 * block_rq_complete - block IO operation completed by device driver
137 * @rq: block operations request
138 * @error: status code
139 * @nr_bytes: number of completed bytes
140 *
141 * The block_rq_complete tracepoint event indicates that some portion
142 * of operation request has been completed by the device driver.  If
143 * the @rq->bio is %NULL, then there is absolutely no additional work to
144 * do for the request. If @rq->bio is non-NULL then there is
145 * additional work required to complete the request.
146 */
147DEFINE_EVENT(block_rq_completion, block_rq_complete,
148
149	TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
150
151	TP_ARGS(rq, error, nr_bytes)
152);
153
154/**
155 * block_rq_error - block IO operation error reported by device driver
156 * @rq: block operations request
157 * @error: status code
158 * @nr_bytes: number of completed bytes
159 *
160 * The block_rq_error tracepoint event indicates that some portion
161 * of operation request has failed as reported by the device driver.
162 */
163DEFINE_EVENT(block_rq_completion, block_rq_error,
164
165	TP_PROTO(struct request *rq, blk_status_t error, unsigned int nr_bytes),
166
167	TP_ARGS(rq, error, nr_bytes)
168);
169
170DECLARE_EVENT_CLASS(block_rq,
171
172	TP_PROTO(struct request *rq),
173
174	TP_ARGS(rq),
175
176	TP_STRUCT__entry(
177		__field(  dev_t,	dev			)
178		__field(  sector_t,	sector			)
179		__field(  unsigned int,	nr_sector		)
180		__field(  unsigned int,	bytes			)
181		__array(  char,		rwbs,	RWBS_LEN	)
182		__array(  char,         comm,   TASK_COMM_LEN   )
183		__dynamic_array( char,	cmd,	1		)
184	),
185
186	TP_fast_assign(
187		__entry->dev	   = rq->q->disk ? disk_devt(rq->q->disk) : 0;
188		__entry->sector    = blk_rq_trace_sector(rq);
189		__entry->nr_sector = blk_rq_trace_nr_sectors(rq);
190		__entry->bytes     = blk_rq_bytes(rq);
191
192		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
193		__get_str(cmd)[0] = '\0';
194		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
195	),
196
197	TP_printk("%d,%d %s %u (%s) %llu + %u [%s]",
198		  MAJOR(__entry->dev), MINOR(__entry->dev),
199		  __entry->rwbs, __entry->bytes, __get_str(cmd),
200		  (unsigned long long)__entry->sector,
201		  __entry->nr_sector, __entry->comm)
202);
203
204/**
205 * block_rq_insert - insert block operation request into queue
 
206 * @rq: block IO operation request
207 *
208 * Called immediately before block operation request @rq is inserted
209 * into queue @q.  The fields in the operation request @rq struct can
210 * be examined to determine which device and sectors the pending
211 * operation would access.
212 */
213DEFINE_EVENT(block_rq, block_rq_insert,
214
215	TP_PROTO(struct request *rq),
216
217	TP_ARGS(rq)
218);
219
220/**
221 * block_rq_issue - issue pending block IO request operation to device driver
222 * @rq: block IO operation request
 
223 *
224 * Called when block operation request @rq from queue @q is sent to a
225 * device driver for processing.
226 */
227DEFINE_EVENT(block_rq, block_rq_issue,
228
229	TP_PROTO(struct request *rq),
230
231	TP_ARGS(rq)
232);
233
234/**
235 * block_rq_merge - merge request with another one in the elevator
236 * @rq: block IO operation request
 
237 *
238 * Called when block operation request @rq from queue @q is merged to another
239 * request queued in the elevator.
240 */
241DEFINE_EVENT(block_rq, block_rq_merge,
242
243	TP_PROTO(struct request *rq),
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
244
245	TP_ARGS(rq)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
246);
247
248/**
249 * block_bio_complete - completed all work on the block operation
250 * @q: queue holding the block operation
251 * @bio: block operation completed
252 *
253 * This tracepoint indicates there is no further work to do on this
254 * block IO operation @bio.
255 */
256TRACE_EVENT(block_bio_complete,
257
258	TP_PROTO(struct request_queue *q, struct bio *bio),
259
260	TP_ARGS(q, bio),
261
262	TP_STRUCT__entry(
263		__field( dev_t,		dev		)
264		__field( sector_t,	sector		)
265		__field( unsigned,	nr_sector	)
266		__field( int,		error		)
267		__array( char,		rwbs,	RWBS_LEN)
268	),
269
270	TP_fast_assign(
271		__entry->dev		= bio_dev(bio);
272		__entry->sector		= bio->bi_iter.bi_sector;
273		__entry->nr_sector	= bio_sectors(bio);
274		__entry->error		= blk_status_to_errno(bio->bi_status);
275		blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
276	),
277
278	TP_printk("%d,%d %s %llu + %u [%d]",
279		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
280		  (unsigned long long)__entry->sector,
281		  __entry->nr_sector, __entry->error)
282);
283
284DECLARE_EVENT_CLASS(block_bio,
285
286	TP_PROTO(struct bio *bio),
287
288	TP_ARGS(bio),
289
290	TP_STRUCT__entry(
291		__field( dev_t,		dev			)
292		__field( sector_t,	sector			)
293		__field( unsigned int,	nr_sector		)
294		__array( char,		rwbs,	RWBS_LEN	)
295		__array( char,		comm,	TASK_COMM_LEN	)
296	),
297
298	TP_fast_assign(
299		__entry->dev		= bio_dev(bio);
300		__entry->sector		= bio->bi_iter.bi_sector;
301		__entry->nr_sector	= bio_sectors(bio);
302		blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
303		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
304	),
305
306	TP_printk("%d,%d %s %llu + %u [%s]",
307		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
308		  (unsigned long long)__entry->sector,
309		  __entry->nr_sector, __entry->comm)
310);
311
312/**
313 * block_bio_bounce - used bounce buffer when processing block operation
314 * @bio: block operation
315 *
316 * A bounce buffer was used to handle the block operation @bio in @q.
317 * This occurs when hardware limitations prevent a direct transfer of
318 * data between the @bio data memory area and the IO device.  Use of a
319 * bounce buffer requires extra copying of data and decreases
320 * performance.
321 */
322DEFINE_EVENT(block_bio, block_bio_bounce,
323	TP_PROTO(struct bio *bio),
324	TP_ARGS(bio)
325);
326
327/**
328 * block_bio_backmerge - merging block operation to the end of an existing operation
 
 
329 * @bio: new block operation to merge
330 *
331 * Merging block request @bio to the end of an existing block request.
 
332 */
333DEFINE_EVENT(block_bio, block_bio_backmerge,
334	TP_PROTO(struct bio *bio),
335	TP_ARGS(bio)
 
 
336);
337
338/**
339 * block_bio_frontmerge - merging block operation to the beginning of an existing operation
 
 
340 * @bio: new block operation to merge
341 *
342 * Merging block IO operation @bio to the beginning of an existing block request.
 
343 */
344DEFINE_EVENT(block_bio, block_bio_frontmerge,
345	TP_PROTO(struct bio *bio),
346	TP_ARGS(bio)
 
 
347);
348
349/**
350 * block_bio_queue - putting new block IO operation in queue
 
351 * @bio: new block operation
352 *
353 * About to place the block IO operation @bio into queue @q.
354 */
355DEFINE_EVENT(block_bio, block_bio_queue,
356	TP_PROTO(struct bio *bio),
357	TP_ARGS(bio)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
358);
359
360/**
361 * block_getrq - get a free request entry in queue for block IO operations
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
362 * @bio: pending block IO operation (can be %NULL)
 
363 *
364 * A request struct has been allocated to handle the block IO operation @bio.
 
 
 
365 */
366DEFINE_EVENT(block_bio, block_getrq,
367	TP_PROTO(struct bio *bio),
368	TP_ARGS(bio)
 
 
369);
370
371/**
372 * block_plug - keep operations requests in request queue
373 * @q: request queue to plug
374 *
375 * Plug the request queue @q.  Do not allow block operation requests
376 * to be sent to the device driver. Instead, accumulate requests in
377 * the queue to improve throughput performance of the block device.
378 */
379TRACE_EVENT(block_plug,
380
381	TP_PROTO(struct request_queue *q),
382
383	TP_ARGS(q),
384
385	TP_STRUCT__entry(
386		__array( char,		comm,	TASK_COMM_LEN	)
387	),
388
389	TP_fast_assign(
390		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
391	),
392
393	TP_printk("[%s]", __entry->comm)
394);
395
396DECLARE_EVENT_CLASS(block_unplug,
397
398	TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
399
400	TP_ARGS(q, depth, explicit),
401
402	TP_STRUCT__entry(
403		__field( int,		nr_rq			)
404		__array( char,		comm,	TASK_COMM_LEN	)
405	),
406
407	TP_fast_assign(
408		__entry->nr_rq = depth;
409		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
410	),
411
412	TP_printk("[%s] %d", __entry->comm, __entry->nr_rq)
413);
414
415/**
416 * block_unplug - release of operations requests in request queue
417 * @q: request queue to unplug
418 * @depth: number of requests just added to the queue
419 * @explicit: whether this was an explicit unplug, or one from schedule()
420 *
421 * Unplug request queue @q because device driver is scheduled to work
422 * on elements in the request queue.
423 */
424DEFINE_EVENT(block_unplug, block_unplug,
425
426	TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
427
428	TP_ARGS(q, depth, explicit)
429);
430
431/**
432 * block_split - split a single bio struct into two bio structs
 
433 * @bio: block operation being split
434 * @new_sector: The starting sector for the new bio
435 *
436 * The bio request @bio needs to be split into two bio requests.  The newly
437 * created @bio request starts at @new_sector. This split may be required due to
438 * hardware limitations such as operation crossing device boundaries in a RAID
439 * system.
440 */
441TRACE_EVENT(block_split,
442
443	TP_PROTO(struct bio *bio, unsigned int new_sector),
 
444
445	TP_ARGS(bio, new_sector),
446
447	TP_STRUCT__entry(
448		__field( dev_t,		dev				)
449		__field( sector_t,	sector				)
450		__field( sector_t,	new_sector			)
451		__array( char,		rwbs,		RWBS_LEN	)
452		__array( char,		comm,		TASK_COMM_LEN	)
453	),
454
455	TP_fast_assign(
456		__entry->dev		= bio_dev(bio);
457		__entry->sector		= bio->bi_iter.bi_sector;
458		__entry->new_sector	= new_sector;
459		blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
460		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
461	),
462
463	TP_printk("%d,%d %s %llu / %llu [%s]",
464		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
465		  (unsigned long long)__entry->sector,
466		  (unsigned long long)__entry->new_sector,
467		  __entry->comm)
468);
469
470/**
471 * block_bio_remap - map request for a logical device to the raw device
 
472 * @bio: revised operation
473 * @dev: original device for the operation
474 * @from: original sector for the operation
475 *
476 * An operation for a logical device has been mapped to the
477 * raw block device.
478 */
479TRACE_EVENT(block_bio_remap,
480
481	TP_PROTO(struct bio *bio, dev_t dev, sector_t from),
 
482
483	TP_ARGS(bio, dev, from),
484
485	TP_STRUCT__entry(
486		__field( dev_t,		dev		)
487		__field( sector_t,	sector		)
488		__field( unsigned int,	nr_sector	)
489		__field( dev_t,		old_dev		)
490		__field( sector_t,	old_sector	)
491		__array( char,		rwbs,	RWBS_LEN)
492	),
493
494	TP_fast_assign(
495		__entry->dev		= bio_dev(bio);
496		__entry->sector		= bio->bi_iter.bi_sector;
497		__entry->nr_sector	= bio_sectors(bio);
498		__entry->old_dev	= dev;
499		__entry->old_sector	= from;
500		blk_fill_rwbs(__entry->rwbs, bio->bi_opf);
501	),
502
503	TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu",
504		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
505		  (unsigned long long)__entry->sector,
506		  __entry->nr_sector,
507		  MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
508		  (unsigned long long)__entry->old_sector)
509);
510
511/**
512 * block_rq_remap - map request for a block operation request
 
513 * @rq: block IO operation request
514 * @dev: device for the operation
515 * @from: original sector for the operation
516 *
517 * The block operation request @rq in @q has been remapped.  The block
518 * operation request @rq holds the current information and @from hold
519 * the original sector.
520 */
521TRACE_EVENT(block_rq_remap,
522
523	TP_PROTO(struct request *rq, dev_t dev, sector_t from),
 
524
525	TP_ARGS(rq, dev, from),
526
527	TP_STRUCT__entry(
528		__field( dev_t,		dev		)
529		__field( sector_t,	sector		)
530		__field( unsigned int,	nr_sector	)
531		__field( dev_t,		old_dev		)
532		__field( sector_t,	old_sector	)
533		__field( unsigned int,	nr_bios		)
534		__array( char,		rwbs,	RWBS_LEN)
535	),
536
537	TP_fast_assign(
538		__entry->dev		= disk_devt(rq->q->disk);
539		__entry->sector		= blk_rq_pos(rq);
540		__entry->nr_sector	= blk_rq_sectors(rq);
541		__entry->old_dev	= dev;
542		__entry->old_sector	= from;
543		__entry->nr_bios	= blk_rq_count_bios(rq);
544		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags);
545	),
546
547	TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu %u",
548		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
549		  (unsigned long long)__entry->sector,
550		  __entry->nr_sector,
551		  MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
552		  (unsigned long long)__entry->old_sector, __entry->nr_bios)
553);
554
555#endif /* _TRACE_BLOCK_H */
556
557/* This part must be outside protection */
558#include <trace/define_trace.h>
559
v5.9
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#undef TRACE_SYSTEM
  3#define TRACE_SYSTEM block
  4
  5#if !defined(_TRACE_BLOCK_H) || defined(TRACE_HEADER_MULTI_READ)
  6#define _TRACE_BLOCK_H
  7
  8#include <linux/blktrace_api.h>
  9#include <linux/blkdev.h>
 10#include <linux/buffer_head.h>
 11#include <linux/tracepoint.h>
 12
 13#define RWBS_LEN	8
 14
 15DECLARE_EVENT_CLASS(block_buffer,
 16
 17	TP_PROTO(struct buffer_head *bh),
 18
 19	TP_ARGS(bh),
 20
 21	TP_STRUCT__entry (
 22		__field(  dev_t,	dev			)
 23		__field(  sector_t,	sector			)
 24		__field(  size_t,	size			)
 25	),
 26
 27	TP_fast_assign(
 28		__entry->dev		= bh->b_bdev->bd_dev;
 29		__entry->sector		= bh->b_blocknr;
 30		__entry->size		= bh->b_size;
 31	),
 32
 33	TP_printk("%d,%d sector=%llu size=%zu",
 34		MAJOR(__entry->dev), MINOR(__entry->dev),
 35		(unsigned long long)__entry->sector, __entry->size
 36	)
 37);
 38
 39/**
 40 * block_touch_buffer - mark a buffer accessed
 41 * @bh: buffer_head being touched
 42 *
 43 * Called from touch_buffer().
 44 */
 45DEFINE_EVENT(block_buffer, block_touch_buffer,
 46
 47	TP_PROTO(struct buffer_head *bh),
 48
 49	TP_ARGS(bh)
 50);
 51
 52/**
 53 * block_dirty_buffer - mark a buffer dirty
 54 * @bh: buffer_head being dirtied
 55 *
 56 * Called from mark_buffer_dirty().
 57 */
 58DEFINE_EVENT(block_buffer, block_dirty_buffer,
 59
 60	TP_PROTO(struct buffer_head *bh),
 61
 62	TP_ARGS(bh)
 63);
 64
 65/**
 66 * block_rq_requeue - place block IO request back on a queue
 67 * @q: queue holding operation
 68 * @rq: block IO operation request
 69 *
 70 * The block operation request @rq is being placed back into queue
 71 * @q.  For some reason the request was not completed and needs to be
 72 * put back in the queue.
 73 */
 74TRACE_EVENT(block_rq_requeue,
 75
 76	TP_PROTO(struct request_queue *q, struct request *rq),
 77
 78	TP_ARGS(q, rq),
 79
 80	TP_STRUCT__entry(
 81		__field(  dev_t,	dev			)
 82		__field(  sector_t,	sector			)
 83		__field(  unsigned int,	nr_sector		)
 84		__array(  char,		rwbs,	RWBS_LEN	)
 85		__dynamic_array( char,	cmd,	1		)
 86	),
 87
 88	TP_fast_assign(
 89		__entry->dev	   = rq->rq_disk ? disk_devt(rq->rq_disk) : 0;
 90		__entry->sector    = blk_rq_trace_sector(rq);
 91		__entry->nr_sector = blk_rq_trace_nr_sectors(rq);
 92
 93		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags, blk_rq_bytes(rq));
 94		__get_str(cmd)[0] = '\0';
 95	),
 96
 97	TP_printk("%d,%d %s (%s) %llu + %u [%d]",
 98		  MAJOR(__entry->dev), MINOR(__entry->dev),
 99		  __entry->rwbs, __get_str(cmd),
100		  (unsigned long long)__entry->sector,
101		  __entry->nr_sector, 0)
102);
103
104/**
105 * block_rq_complete - block IO operation completed by device driver
106 * @rq: block operations request
107 * @error: status code
108 * @nr_bytes: number of completed bytes
109 *
110 * The block_rq_complete tracepoint event indicates that some portion
111 * of operation request has been completed by the device driver.  If
112 * the @rq->bio is %NULL, then there is absolutely no additional work to
113 * do for the request. If @rq->bio is non-NULL then there is
114 * additional work required to complete the request.
115 */
116TRACE_EVENT(block_rq_complete,
117
118	TP_PROTO(struct request *rq, int error, unsigned int nr_bytes),
119
120	TP_ARGS(rq, error, nr_bytes),
121
122	TP_STRUCT__entry(
123		__field(  dev_t,	dev			)
124		__field(  sector_t,	sector			)
125		__field(  unsigned int,	nr_sector		)
126		__field(  int,		error			)
127		__array(  char,		rwbs,	RWBS_LEN	)
128		__dynamic_array( char,	cmd,	1		)
129	),
130
131	TP_fast_assign(
132		__entry->dev	   = rq->rq_disk ? disk_devt(rq->rq_disk) : 0;
133		__entry->sector    = blk_rq_pos(rq);
134		__entry->nr_sector = nr_bytes >> 9;
135		__entry->error     = error;
136
137		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags, nr_bytes);
138		__get_str(cmd)[0] = '\0';
139	),
140
141	TP_printk("%d,%d %s (%s) %llu + %u [%d]",
142		  MAJOR(__entry->dev), MINOR(__entry->dev),
143		  __entry->rwbs, __get_str(cmd),
144		  (unsigned long long)__entry->sector,
145		  __entry->nr_sector, __entry->error)
146);
147
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
148DECLARE_EVENT_CLASS(block_rq,
149
150	TP_PROTO(struct request_queue *q, struct request *rq),
151
152	TP_ARGS(q, rq),
153
154	TP_STRUCT__entry(
155		__field(  dev_t,	dev			)
156		__field(  sector_t,	sector			)
157		__field(  unsigned int,	nr_sector		)
158		__field(  unsigned int,	bytes			)
159		__array(  char,		rwbs,	RWBS_LEN	)
160		__array(  char,         comm,   TASK_COMM_LEN   )
161		__dynamic_array( char,	cmd,	1		)
162	),
163
164	TP_fast_assign(
165		__entry->dev	   = rq->rq_disk ? disk_devt(rq->rq_disk) : 0;
166		__entry->sector    = blk_rq_trace_sector(rq);
167		__entry->nr_sector = blk_rq_trace_nr_sectors(rq);
168		__entry->bytes     = blk_rq_bytes(rq);
169
170		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags, blk_rq_bytes(rq));
171		__get_str(cmd)[0] = '\0';
172		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
173	),
174
175	TP_printk("%d,%d %s %u (%s) %llu + %u [%s]",
176		  MAJOR(__entry->dev), MINOR(__entry->dev),
177		  __entry->rwbs, __entry->bytes, __get_str(cmd),
178		  (unsigned long long)__entry->sector,
179		  __entry->nr_sector, __entry->comm)
180);
181
182/**
183 * block_rq_insert - insert block operation request into queue
184 * @q: target queue
185 * @rq: block IO operation request
186 *
187 * Called immediately before block operation request @rq is inserted
188 * into queue @q.  The fields in the operation request @rq struct can
189 * be examined to determine which device and sectors the pending
190 * operation would access.
191 */
192DEFINE_EVENT(block_rq, block_rq_insert,
193
194	TP_PROTO(struct request_queue *q, struct request *rq),
195
196	TP_ARGS(q, rq)
197);
198
199/**
200 * block_rq_issue - issue pending block IO request operation to device driver
201 * @q: queue holding operation
202 * @rq: block IO operation operation request
203 *
204 * Called when block operation request @rq from queue @q is sent to a
205 * device driver for processing.
206 */
207DEFINE_EVENT(block_rq, block_rq_issue,
208
209	TP_PROTO(struct request_queue *q, struct request *rq),
210
211	TP_ARGS(q, rq)
212);
213
214/**
215 * block_rq_merge - merge request with another one in the elevator
216 * @q: queue holding operation
217 * @rq: block IO operation operation request
218 *
219 * Called when block operation request @rq from queue @q is merged to another
220 * request queued in the elevator.
221 */
222DEFINE_EVENT(block_rq, block_rq_merge,
223
224	TP_PROTO(struct request_queue *q, struct request *rq),
225
226	TP_ARGS(q, rq)
227);
228
229/**
230 * block_bio_bounce - used bounce buffer when processing block operation
231 * @q: queue holding the block operation
232 * @bio: block operation
233 *
234 * A bounce buffer was used to handle the block operation @bio in @q.
235 * This occurs when hardware limitations prevent a direct transfer of
236 * data between the @bio data memory area and the IO device.  Use of a
237 * bounce buffer requires extra copying of data and decreases
238 * performance.
239 */
240TRACE_EVENT(block_bio_bounce,
241
242	TP_PROTO(struct request_queue *q, struct bio *bio),
243
244	TP_ARGS(q, bio),
245
246	TP_STRUCT__entry(
247		__field( dev_t,		dev			)
248		__field( sector_t,	sector			)
249		__field( unsigned int,	nr_sector		)
250		__array( char,		rwbs,	RWBS_LEN	)
251		__array( char,		comm,	TASK_COMM_LEN	)
252	),
253
254	TP_fast_assign(
255		__entry->dev		= bio_dev(bio);
256		__entry->sector		= bio->bi_iter.bi_sector;
257		__entry->nr_sector	= bio_sectors(bio);
258		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
259		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
260	),
261
262	TP_printk("%d,%d %s %llu + %u [%s]",
263		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
264		  (unsigned long long)__entry->sector,
265		  __entry->nr_sector, __entry->comm)
266);
267
268/**
269 * block_bio_complete - completed all work on the block operation
270 * @q: queue holding the block operation
271 * @bio: block operation completed
272 *
273 * This tracepoint indicates there is no further work to do on this
274 * block IO operation @bio.
275 */
276TRACE_EVENT(block_bio_complete,
277
278	TP_PROTO(struct request_queue *q, struct bio *bio),
279
280	TP_ARGS(q, bio),
281
282	TP_STRUCT__entry(
283		__field( dev_t,		dev		)
284		__field( sector_t,	sector		)
285		__field( unsigned,	nr_sector	)
286		__field( int,		error		)
287		__array( char,		rwbs,	RWBS_LEN)
288	),
289
290	TP_fast_assign(
291		__entry->dev		= bio_dev(bio);
292		__entry->sector		= bio->bi_iter.bi_sector;
293		__entry->nr_sector	= bio_sectors(bio);
294		__entry->error		= blk_status_to_errno(bio->bi_status);
295		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
296	),
297
298	TP_printk("%d,%d %s %llu + %u [%d]",
299		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
300		  (unsigned long long)__entry->sector,
301		  __entry->nr_sector, __entry->error)
302);
303
304DECLARE_EVENT_CLASS(block_bio_merge,
305
306	TP_PROTO(struct request_queue *q, struct request *rq, struct bio *bio),
307
308	TP_ARGS(q, rq, bio),
309
310	TP_STRUCT__entry(
311		__field( dev_t,		dev			)
312		__field( sector_t,	sector			)
313		__field( unsigned int,	nr_sector		)
314		__array( char,		rwbs,	RWBS_LEN	)
315		__array( char,		comm,	TASK_COMM_LEN	)
316	),
317
318	TP_fast_assign(
319		__entry->dev		= bio_dev(bio);
320		__entry->sector		= bio->bi_iter.bi_sector;
321		__entry->nr_sector	= bio_sectors(bio);
322		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
323		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
324	),
325
326	TP_printk("%d,%d %s %llu + %u [%s]",
327		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
328		  (unsigned long long)__entry->sector,
329		  __entry->nr_sector, __entry->comm)
330);
331
332/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
333 * block_bio_backmerge - merging block operation to the end of an existing operation
334 * @q: queue holding operation
335 * @rq: request bio is being merged into
336 * @bio: new block operation to merge
337 *
338 * Merging block request @bio to the end of an existing block request
339 * in queue @q.
340 */
341DEFINE_EVENT(block_bio_merge, block_bio_backmerge,
342
343	TP_PROTO(struct request_queue *q, struct request *rq, struct bio *bio),
344
345	TP_ARGS(q, rq, bio)
346);
347
348/**
349 * block_bio_frontmerge - merging block operation to the beginning of an existing operation
350 * @q: queue holding operation
351 * @rq: request bio is being merged into
352 * @bio: new block operation to merge
353 *
354 * Merging block IO operation @bio to the beginning of an existing block
355 * operation in queue @q.
356 */
357DEFINE_EVENT(block_bio_merge, block_bio_frontmerge,
358
359	TP_PROTO(struct request_queue *q, struct request *rq, struct bio *bio),
360
361	TP_ARGS(q, rq, bio)
362);
363
364/**
365 * block_bio_queue - putting new block IO operation in queue
366 * @q: queue holding operation
367 * @bio: new block operation
368 *
369 * About to place the block IO operation @bio into queue @q.
370 */
371TRACE_EVENT(block_bio_queue,
372
373	TP_PROTO(struct request_queue *q, struct bio *bio),
374
375	TP_ARGS(q, bio),
376
377	TP_STRUCT__entry(
378		__field( dev_t,		dev			)
379		__field( sector_t,	sector			)
380		__field( unsigned int,	nr_sector		)
381		__array( char,		rwbs,	RWBS_LEN	)
382		__array( char,		comm,	TASK_COMM_LEN	)
383	),
384
385	TP_fast_assign(
386		__entry->dev		= bio_dev(bio);
387		__entry->sector		= bio->bi_iter.bi_sector;
388		__entry->nr_sector	= bio_sectors(bio);
389		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
390		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
391	),
392
393	TP_printk("%d,%d %s %llu + %u [%s]",
394		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
395		  (unsigned long long)__entry->sector,
396		  __entry->nr_sector, __entry->comm)
397);
398
399DECLARE_EVENT_CLASS(block_get_rq,
400
401	TP_PROTO(struct request_queue *q, struct bio *bio, int rw),
402
403	TP_ARGS(q, bio, rw),
404
405	TP_STRUCT__entry(
406		__field( dev_t,		dev			)
407		__field( sector_t,	sector			)
408		__field( unsigned int,	nr_sector		)
409		__array( char,		rwbs,	RWBS_LEN	)
410		__array( char,		comm,	TASK_COMM_LEN	)
411        ),
412
413	TP_fast_assign(
414		__entry->dev		= bio ? bio_dev(bio) : 0;
415		__entry->sector		= bio ? bio->bi_iter.bi_sector : 0;
416		__entry->nr_sector	= bio ? bio_sectors(bio) : 0;
417		blk_fill_rwbs(__entry->rwbs,
418			      bio ? bio->bi_opf : 0, __entry->nr_sector);
419		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
420        ),
421
422	TP_printk("%d,%d %s %llu + %u [%s]",
423		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
424		  (unsigned long long)__entry->sector,
425		  __entry->nr_sector, __entry->comm)
426);
427
428/**
429 * block_getrq - get a free request entry in queue for block IO operations
430 * @q: queue for operations
431 * @bio: pending block IO operation (can be %NULL)
432 * @rw: low bit indicates a read (%0) or a write (%1)
433 *
434 * A request struct for queue @q has been allocated to handle the
435 * block IO operation @bio.
436 */
437DEFINE_EVENT(block_get_rq, block_getrq,
438
439	TP_PROTO(struct request_queue *q, struct bio *bio, int rw),
440
441	TP_ARGS(q, bio, rw)
442);
443
444/**
445 * block_sleeprq - waiting to get a free request entry in queue for block IO operation
446 * @q: queue for operation
447 * @bio: pending block IO operation (can be %NULL)
448 * @rw: low bit indicates a read (%0) or a write (%1)
449 *
450 * In the case where a request struct cannot be provided for queue @q
451 * the process needs to wait for an request struct to become
452 * available.  This tracepoint event is generated each time the
453 * process goes to sleep waiting for request struct become available.
454 */
455DEFINE_EVENT(block_get_rq, block_sleeprq,
456
457	TP_PROTO(struct request_queue *q, struct bio *bio, int rw),
458
459	TP_ARGS(q, bio, rw)
460);
461
462/**
463 * block_plug - keep operations requests in request queue
464 * @q: request queue to plug
465 *
466 * Plug the request queue @q.  Do not allow block operation requests
467 * to be sent to the device driver. Instead, accumulate requests in
468 * the queue to improve throughput performance of the block device.
469 */
470TRACE_EVENT(block_plug,
471
472	TP_PROTO(struct request_queue *q),
473
474	TP_ARGS(q),
475
476	TP_STRUCT__entry(
477		__array( char,		comm,	TASK_COMM_LEN	)
478	),
479
480	TP_fast_assign(
481		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
482	),
483
484	TP_printk("[%s]", __entry->comm)
485);
486
487DECLARE_EVENT_CLASS(block_unplug,
488
489	TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
490
491	TP_ARGS(q, depth, explicit),
492
493	TP_STRUCT__entry(
494		__field( int,		nr_rq			)
495		__array( char,		comm,	TASK_COMM_LEN	)
496	),
497
498	TP_fast_assign(
499		__entry->nr_rq = depth;
500		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
501	),
502
503	TP_printk("[%s] %d", __entry->comm, __entry->nr_rq)
504);
505
506/**
507 * block_unplug - release of operations requests in request queue
508 * @q: request queue to unplug
509 * @depth: number of requests just added to the queue
510 * @explicit: whether this was an explicit unplug, or one from schedule()
511 *
512 * Unplug request queue @q because device driver is scheduled to work
513 * on elements in the request queue.
514 */
515DEFINE_EVENT(block_unplug, block_unplug,
516
517	TP_PROTO(struct request_queue *q, unsigned int depth, bool explicit),
518
519	TP_ARGS(q, depth, explicit)
520);
521
522/**
523 * block_split - split a single bio struct into two bio structs
524 * @q: queue containing the bio
525 * @bio: block operation being split
526 * @new_sector: The starting sector for the new bio
527 *
528 * The bio request @bio in request queue @q needs to be split into two
529 * bio requests. The newly created @bio request starts at
530 * @new_sector. This split may be required due to hardware limitation
531 * such as operation crossing device boundaries in a RAID system.
532 */
533TRACE_EVENT(block_split,
534
535	TP_PROTO(struct request_queue *q, struct bio *bio,
536		 unsigned int new_sector),
537
538	TP_ARGS(q, bio, new_sector),
539
540	TP_STRUCT__entry(
541		__field( dev_t,		dev				)
542		__field( sector_t,	sector				)
543		__field( sector_t,	new_sector			)
544		__array( char,		rwbs,		RWBS_LEN	)
545		__array( char,		comm,		TASK_COMM_LEN	)
546	),
547
548	TP_fast_assign(
549		__entry->dev		= bio_dev(bio);
550		__entry->sector		= bio->bi_iter.bi_sector;
551		__entry->new_sector	= new_sector;
552		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
553		memcpy(__entry->comm, current->comm, TASK_COMM_LEN);
554	),
555
556	TP_printk("%d,%d %s %llu / %llu [%s]",
557		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
558		  (unsigned long long)__entry->sector,
559		  (unsigned long long)__entry->new_sector,
560		  __entry->comm)
561);
562
563/**
564 * block_bio_remap - map request for a logical device to the raw device
565 * @q: queue holding the operation
566 * @bio: revised operation
567 * @dev: device for the operation
568 * @from: original sector for the operation
569 *
570 * An operation for a logical device has been mapped to the
571 * raw block device.
572 */
573TRACE_EVENT(block_bio_remap,
574
575	TP_PROTO(struct request_queue *q, struct bio *bio, dev_t dev,
576		 sector_t from),
577
578	TP_ARGS(q, bio, dev, from),
579
580	TP_STRUCT__entry(
581		__field( dev_t,		dev		)
582		__field( sector_t,	sector		)
583		__field( unsigned int,	nr_sector	)
584		__field( dev_t,		old_dev		)
585		__field( sector_t,	old_sector	)
586		__array( char,		rwbs,	RWBS_LEN)
587	),
588
589	TP_fast_assign(
590		__entry->dev		= bio_dev(bio);
591		__entry->sector		= bio->bi_iter.bi_sector;
592		__entry->nr_sector	= bio_sectors(bio);
593		__entry->old_dev	= dev;
594		__entry->old_sector	= from;
595		blk_fill_rwbs(__entry->rwbs, bio->bi_opf, bio->bi_iter.bi_size);
596	),
597
598	TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu",
599		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
600		  (unsigned long long)__entry->sector,
601		  __entry->nr_sector,
602		  MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
603		  (unsigned long long)__entry->old_sector)
604);
605
606/**
607 * block_rq_remap - map request for a block operation request
608 * @q: queue holding the operation
609 * @rq: block IO operation request
610 * @dev: device for the operation
611 * @from: original sector for the operation
612 *
613 * The block operation request @rq in @q has been remapped.  The block
614 * operation request @rq holds the current information and @from hold
615 * the original sector.
616 */
617TRACE_EVENT(block_rq_remap,
618
619	TP_PROTO(struct request_queue *q, struct request *rq, dev_t dev,
620		 sector_t from),
621
622	TP_ARGS(q, rq, dev, from),
623
624	TP_STRUCT__entry(
625		__field( dev_t,		dev		)
626		__field( sector_t,	sector		)
627		__field( unsigned int,	nr_sector	)
628		__field( dev_t,		old_dev		)
629		__field( sector_t,	old_sector	)
630		__field( unsigned int,	nr_bios		)
631		__array( char,		rwbs,	RWBS_LEN)
632	),
633
634	TP_fast_assign(
635		__entry->dev		= disk_devt(rq->rq_disk);
636		__entry->sector		= blk_rq_pos(rq);
637		__entry->nr_sector	= blk_rq_sectors(rq);
638		__entry->old_dev	= dev;
639		__entry->old_sector	= from;
640		__entry->nr_bios	= blk_rq_count_bios(rq);
641		blk_fill_rwbs(__entry->rwbs, rq->cmd_flags, blk_rq_bytes(rq));
642	),
643
644	TP_printk("%d,%d %s %llu + %u <- (%d,%d) %llu %u",
645		  MAJOR(__entry->dev), MINOR(__entry->dev), __entry->rwbs,
646		  (unsigned long long)__entry->sector,
647		  __entry->nr_sector,
648		  MAJOR(__entry->old_dev), MINOR(__entry->old_dev),
649		  (unsigned long long)__entry->old_sector, __entry->nr_bios)
650);
651
652#endif /* _TRACE_BLOCK_H */
653
654/* This part must be outside protection */
655#include <trace/define_trace.h>
656