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