xref: /linux/kernel/trace/blktrace.c (revision 1cbfb828e05171ca2dd77b5988d068e6872480fe)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (C) 2006 Jens Axboe <axboe@kernel.dk>
4  *
5  */
6 
7 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
8 
9 #include <linux/kernel.h>
10 #include <linux/blkdev.h>
11 #include <linux/blktrace_api.h>
12 #include <linux/percpu.h>
13 #include <linux/init.h>
14 #include <linux/mutex.h>
15 #include <linux/slab.h>
16 #include <linux/debugfs.h>
17 #include <linux/export.h>
18 #include <linux/time.h>
19 #include <linux/uaccess.h>
20 #include <linux/list.h>
21 #include <linux/blk-cgroup.h>
22 
23 #include "../../block/blk.h"
24 
25 #include <trace/events/block.h>
26 
27 #include "trace_output.h"
28 
29 #ifdef CONFIG_BLK_DEV_IO_TRACE
30 
31 static unsigned int blktrace_seq __read_mostly = 1;
32 
33 static struct trace_array *blk_tr;
34 static bool blk_tracer_enabled __read_mostly;
35 
36 static LIST_HEAD(running_trace_list);
37 static __cacheline_aligned_in_smp DEFINE_RAW_SPINLOCK(running_trace_lock);
38 
39 /* Select an alternative, minimalistic output than the original one */
40 #define TRACE_BLK_OPT_CLASSIC	0x1
41 #define TRACE_BLK_OPT_CGROUP	0x2
42 #define TRACE_BLK_OPT_CGNAME	0x4
43 
44 static struct tracer_opt blk_tracer_opts[] = {
45 	/* Default disable the minimalistic output */
46 	{ TRACER_OPT(blk_classic, TRACE_BLK_OPT_CLASSIC) },
47 #ifdef CONFIG_BLK_CGROUP
48 	{ TRACER_OPT(blk_cgroup, TRACE_BLK_OPT_CGROUP) },
49 	{ TRACER_OPT(blk_cgname, TRACE_BLK_OPT_CGNAME) },
50 #endif
51 	{ }
52 };
53 
54 static struct tracer_flags blk_tracer_flags = {
55 	.val  = 0,
56 	.opts = blk_tracer_opts,
57 };
58 
59 /* Global reference count of probes */
60 static DEFINE_MUTEX(blk_probe_mutex);
61 static int blk_probes_ref;
62 
63 static void blk_register_tracepoints(void);
64 static void blk_unregister_tracepoints(void);
65 
66 /*
67  * Send out a notify message.
68  */
69 static void trace_note(struct blk_trace *bt, pid_t pid, int action,
70 		       const void *data, size_t len, u64 cgid)
71 {
72 	struct blk_io_trace *t;
73 	struct ring_buffer_event *event = NULL;
74 	struct trace_buffer *buffer = NULL;
75 	unsigned int trace_ctx = 0;
76 	int cpu = smp_processor_id();
77 	bool blk_tracer = blk_tracer_enabled;
78 	ssize_t cgid_len = cgid ? sizeof(cgid) : 0;
79 
80 	if (blk_tracer) {
81 		buffer = blk_tr->array_buffer.buffer;
82 		trace_ctx = tracing_gen_ctx_flags(0);
83 		event = trace_buffer_lock_reserve(buffer, TRACE_BLK,
84 						  sizeof(*t) + len + cgid_len,
85 						  trace_ctx);
86 		if (!event)
87 			return;
88 		t = ring_buffer_event_data(event);
89 		goto record_it;
90 	}
91 
92 	if (!bt->rchan)
93 		return;
94 
95 	t = relay_reserve(bt->rchan, sizeof(*t) + len + cgid_len);
96 	if (t) {
97 		t->magic = BLK_IO_TRACE_MAGIC | BLK_IO_TRACE_VERSION;
98 		t->time = ktime_to_ns(ktime_get());
99 record_it:
100 		t->device = bt->dev;
101 		t->action = action | (cgid ? __BLK_TN_CGROUP : 0);
102 		t->pid = pid;
103 		t->cpu = cpu;
104 		t->pdu_len = len + cgid_len;
105 		if (cgid_len)
106 			memcpy((void *)t + sizeof(*t), &cgid, cgid_len);
107 		memcpy((void *) t + sizeof(*t) + cgid_len, data, len);
108 
109 		if (blk_tracer)
110 			trace_buffer_unlock_commit(blk_tr, buffer, event, trace_ctx);
111 	}
112 }
113 
114 /*
115  * Send out a notify for this process, if we haven't done so since a trace
116  * started
117  */
118 static void trace_note_tsk(struct task_struct *tsk)
119 {
120 	unsigned long flags;
121 	struct blk_trace *bt;
122 
123 	tsk->btrace_seq = blktrace_seq;
124 	raw_spin_lock_irqsave(&running_trace_lock, flags);
125 	list_for_each_entry(bt, &running_trace_list, running_list) {
126 		trace_note(bt, tsk->pid, BLK_TN_PROCESS, tsk->comm,
127 			   sizeof(tsk->comm), 0);
128 	}
129 	raw_spin_unlock_irqrestore(&running_trace_lock, flags);
130 }
131 
132 static void trace_note_time(struct blk_trace *bt)
133 {
134 	struct timespec64 now;
135 	unsigned long flags;
136 	u32 words[2];
137 
138 	/* need to check user space to see if this breaks in y2038 or y2106 */
139 	ktime_get_real_ts64(&now);
140 	words[0] = (u32)now.tv_sec;
141 	words[1] = now.tv_nsec;
142 
143 	local_irq_save(flags);
144 	trace_note(bt, 0, BLK_TN_TIMESTAMP, words, sizeof(words), 0);
145 	local_irq_restore(flags);
146 }
147 
148 void __blk_trace_note_message(struct blk_trace *bt,
149 		struct cgroup_subsys_state *css, const char *fmt, ...)
150 {
151 	int n;
152 	va_list args;
153 	unsigned long flags;
154 	char *buf;
155 	u64 cgid = 0;
156 
157 	if (unlikely(bt->trace_state != Blktrace_running &&
158 		     !blk_tracer_enabled))
159 		return;
160 
161 	/*
162 	 * If the BLK_TC_NOTIFY action mask isn't set, don't send any note
163 	 * message to the trace.
164 	 */
165 	if (!(bt->act_mask & BLK_TC_NOTIFY))
166 		return;
167 
168 	local_irq_save(flags);
169 	buf = this_cpu_ptr(bt->msg_data);
170 	va_start(args, fmt);
171 	n = vscnprintf(buf, BLK_TN_MAX_MSG, fmt, args);
172 	va_end(args);
173 
174 #ifdef CONFIG_BLK_CGROUP
175 	if (css && (blk_tracer_flags.val & TRACE_BLK_OPT_CGROUP))
176 		cgid = cgroup_id(css->cgroup);
177 	else
178 		cgid = 1;
179 #endif
180 	trace_note(bt, current->pid, BLK_TN_MESSAGE, buf, n, cgid);
181 	local_irq_restore(flags);
182 }
183 EXPORT_SYMBOL_GPL(__blk_trace_note_message);
184 
185 static int act_log_check(struct blk_trace *bt, u32 what, sector_t sector,
186 			 pid_t pid)
187 {
188 	if (((bt->act_mask << BLK_TC_SHIFT) & what) == 0)
189 		return 1;
190 	if (sector && (sector < bt->start_lba || sector > bt->end_lba))
191 		return 1;
192 	if (bt->pid && pid != bt->pid)
193 		return 1;
194 
195 	return 0;
196 }
197 
198 /*
199  * Data direction bit lookup
200  */
201 static const u32 ddir_act[2] = { BLK_TC_ACT(BLK_TC_READ),
202 				 BLK_TC_ACT(BLK_TC_WRITE) };
203 
204 #define BLK_TC_RAHEAD		BLK_TC_AHEAD
205 #define BLK_TC_PREFLUSH		BLK_TC_FLUSH
206 
207 /* The ilog2() calls fall out because they're constant */
208 #define MASK_TC_BIT(rw, __name) ((__force u32)(rw & REQ_ ## __name) <<	\
209 	  (ilog2(BLK_TC_ ## __name) + BLK_TC_SHIFT - __REQ_ ## __name))
210 
211 /*
212  * The worker for the various blk_add_trace*() types. Fills out a
213  * blk_io_trace structure and places it in a per-cpu subbuffer.
214  */
215 static void __blk_add_trace(struct blk_trace *bt, sector_t sector, int bytes,
216 			    const blk_opf_t opf, u32 what, int error,
217 			    int pdu_len, void *pdu_data, u64 cgid)
218 {
219 	struct task_struct *tsk = current;
220 	struct ring_buffer_event *event = NULL;
221 	struct trace_buffer *buffer = NULL;
222 	struct blk_io_trace *t;
223 	unsigned long flags = 0;
224 	unsigned long *sequence;
225 	unsigned int trace_ctx = 0;
226 	pid_t pid;
227 	int cpu;
228 	bool blk_tracer = blk_tracer_enabled;
229 	ssize_t cgid_len = cgid ? sizeof(cgid) : 0;
230 	const enum req_op op = opf & REQ_OP_MASK;
231 
232 	if (unlikely(bt->trace_state != Blktrace_running && !blk_tracer))
233 		return;
234 
235 	what |= ddir_act[op_is_write(op) ? WRITE : READ];
236 	what |= MASK_TC_BIT(opf, SYNC);
237 	what |= MASK_TC_BIT(opf, RAHEAD);
238 	what |= MASK_TC_BIT(opf, META);
239 	what |= MASK_TC_BIT(opf, PREFLUSH);
240 	what |= MASK_TC_BIT(opf, FUA);
241 	if (op == REQ_OP_DISCARD || op == REQ_OP_SECURE_ERASE)
242 		what |= BLK_TC_ACT(BLK_TC_DISCARD);
243 	if (op == REQ_OP_FLUSH)
244 		what |= BLK_TC_ACT(BLK_TC_FLUSH);
245 	if (cgid)
246 		what |= __BLK_TA_CGROUP;
247 
248 	pid = tsk->pid;
249 	if (act_log_check(bt, what, sector, pid))
250 		return;
251 	cpu = raw_smp_processor_id();
252 
253 	if (blk_tracer) {
254 		tracing_record_cmdline(current);
255 
256 		buffer = blk_tr->array_buffer.buffer;
257 		trace_ctx = tracing_gen_ctx_flags(0);
258 		event = trace_buffer_lock_reserve(buffer, TRACE_BLK,
259 						  sizeof(*t) + pdu_len + cgid_len,
260 						  trace_ctx);
261 		if (!event)
262 			return;
263 		t = ring_buffer_event_data(event);
264 		goto record_it;
265 	}
266 
267 	if (unlikely(tsk->btrace_seq != blktrace_seq))
268 		trace_note_tsk(tsk);
269 
270 	/*
271 	 * A word about the locking here - we disable interrupts to reserve
272 	 * some space in the relay per-cpu buffer, to prevent an irq
273 	 * from coming in and stepping on our toes.
274 	 */
275 	local_irq_save(flags);
276 	t = relay_reserve(bt->rchan, sizeof(*t) + pdu_len + cgid_len);
277 	if (t) {
278 		sequence = per_cpu_ptr(bt->sequence, cpu);
279 
280 		t->magic = BLK_IO_TRACE_MAGIC | BLK_IO_TRACE_VERSION;
281 		t->sequence = ++(*sequence);
282 		t->time = ktime_to_ns(ktime_get());
283 record_it:
284 		/*
285 		 * These two are not needed in ftrace as they are in the
286 		 * generic trace_entry, filled by tracing_generic_entry_update,
287 		 * but for the trace_event->bin() synthesizer benefit we do it
288 		 * here too.
289 		 */
290 		t->cpu = cpu;
291 		t->pid = pid;
292 
293 		t->sector = sector;
294 		t->bytes = bytes;
295 		t->action = what;
296 		t->device = bt->dev;
297 		t->error = error;
298 		t->pdu_len = pdu_len + cgid_len;
299 
300 		if (cgid_len)
301 			memcpy((void *)t + sizeof(*t), &cgid, cgid_len);
302 		if (pdu_len)
303 			memcpy((void *)t + sizeof(*t) + cgid_len, pdu_data, pdu_len);
304 
305 		if (blk_tracer) {
306 			trace_buffer_unlock_commit(blk_tr, buffer, event, trace_ctx);
307 			return;
308 		}
309 	}
310 
311 	local_irq_restore(flags);
312 }
313 
314 static void blk_trace_free(struct request_queue *q, struct blk_trace *bt)
315 {
316 	relay_close(bt->rchan);
317 
318 	/*
319 	 * If 'bt->dir' is not set, then both 'dropped' and 'msg' are created
320 	 * under 'q->debugfs_dir', thus lookup and remove them.
321 	 */
322 	if (!bt->dir) {
323 		debugfs_lookup_and_remove("dropped", q->debugfs_dir);
324 		debugfs_lookup_and_remove("msg", q->debugfs_dir);
325 	} else {
326 		debugfs_remove(bt->dir);
327 	}
328 	free_percpu(bt->sequence);
329 	free_percpu(bt->msg_data);
330 	kfree(bt);
331 }
332 
333 static void get_probe_ref(void)
334 {
335 	mutex_lock(&blk_probe_mutex);
336 	if (++blk_probes_ref == 1)
337 		blk_register_tracepoints();
338 	mutex_unlock(&blk_probe_mutex);
339 }
340 
341 static void put_probe_ref(void)
342 {
343 	mutex_lock(&blk_probe_mutex);
344 	if (!--blk_probes_ref)
345 		blk_unregister_tracepoints();
346 	mutex_unlock(&blk_probe_mutex);
347 }
348 
349 static int blk_trace_start(struct blk_trace *bt)
350 {
351 	if (bt->trace_state != Blktrace_setup &&
352 	    bt->trace_state != Blktrace_stopped)
353 		return -EINVAL;
354 
355 	blktrace_seq++;
356 	smp_mb();
357 	bt->trace_state = Blktrace_running;
358 	raw_spin_lock_irq(&running_trace_lock);
359 	list_add(&bt->running_list, &running_trace_list);
360 	raw_spin_unlock_irq(&running_trace_lock);
361 	trace_note_time(bt);
362 
363 	return 0;
364 }
365 
366 static int blk_trace_stop(struct blk_trace *bt)
367 {
368 	if (bt->trace_state != Blktrace_running)
369 		return -EINVAL;
370 
371 	bt->trace_state = Blktrace_stopped;
372 	raw_spin_lock_irq(&running_trace_lock);
373 	list_del_init(&bt->running_list);
374 	raw_spin_unlock_irq(&running_trace_lock);
375 	relay_flush(bt->rchan);
376 
377 	return 0;
378 }
379 
380 static void blk_trace_cleanup(struct request_queue *q, struct blk_trace *bt)
381 {
382 	blk_trace_stop(bt);
383 	synchronize_rcu();
384 	blk_trace_free(q, bt);
385 	put_probe_ref();
386 }
387 
388 static int __blk_trace_remove(struct request_queue *q)
389 {
390 	struct blk_trace *bt;
391 
392 	bt = rcu_replace_pointer(q->blk_trace, NULL,
393 				 lockdep_is_held(&q->debugfs_mutex));
394 	if (!bt)
395 		return -EINVAL;
396 
397 	blk_trace_cleanup(q, bt);
398 
399 	return 0;
400 }
401 
402 int blk_trace_remove(struct request_queue *q)
403 {
404 	int ret;
405 
406 	mutex_lock(&q->debugfs_mutex);
407 	ret = __blk_trace_remove(q);
408 	mutex_unlock(&q->debugfs_mutex);
409 
410 	return ret;
411 }
412 EXPORT_SYMBOL_GPL(blk_trace_remove);
413 
414 static ssize_t blk_dropped_read(struct file *filp, char __user *buffer,
415 				size_t count, loff_t *ppos)
416 {
417 	struct blk_trace *bt = filp->private_data;
418 	char buf[16];
419 
420 	snprintf(buf, sizeof(buf), "%u\n", atomic_read(&bt->dropped));
421 
422 	return simple_read_from_buffer(buffer, count, ppos, buf, strlen(buf));
423 }
424 
425 static const struct file_operations blk_dropped_fops = {
426 	.owner =	THIS_MODULE,
427 	.open =		simple_open,
428 	.read =		blk_dropped_read,
429 	.llseek =	default_llseek,
430 };
431 
432 static ssize_t blk_msg_write(struct file *filp, const char __user *buffer,
433 				size_t count, loff_t *ppos)
434 {
435 	char *msg;
436 	struct blk_trace *bt;
437 
438 	if (count >= BLK_TN_MAX_MSG)
439 		return -EINVAL;
440 
441 	msg = memdup_user_nul(buffer, count);
442 	if (IS_ERR(msg))
443 		return PTR_ERR(msg);
444 
445 	bt = filp->private_data;
446 	__blk_trace_note_message(bt, NULL, "%s", msg);
447 	kfree(msg);
448 
449 	return count;
450 }
451 
452 static const struct file_operations blk_msg_fops = {
453 	.owner =	THIS_MODULE,
454 	.open =		simple_open,
455 	.write =	blk_msg_write,
456 	.llseek =	noop_llseek,
457 };
458 
459 /*
460  * Keep track of how many times we encountered a full subbuffer, to aid
461  * the user space app in telling how many lost events there were.
462  */
463 static int blk_subbuf_start_callback(struct rchan_buf *buf, void *subbuf,
464 				     void *prev_subbuf, size_t prev_padding)
465 {
466 	struct blk_trace *bt;
467 
468 	if (!relay_buf_full(buf))
469 		return 1;
470 
471 	bt = buf->chan->private_data;
472 	atomic_inc(&bt->dropped);
473 	return 0;
474 }
475 
476 static int blk_remove_buf_file_callback(struct dentry *dentry)
477 {
478 	debugfs_remove(dentry);
479 
480 	return 0;
481 }
482 
483 static struct dentry *blk_create_buf_file_callback(const char *filename,
484 						   struct dentry *parent,
485 						   umode_t mode,
486 						   struct rchan_buf *buf,
487 						   int *is_global)
488 {
489 	return debugfs_create_file(filename, mode, parent, buf,
490 					&relay_file_operations);
491 }
492 
493 static const struct rchan_callbacks blk_relay_callbacks = {
494 	.subbuf_start		= blk_subbuf_start_callback,
495 	.create_buf_file	= blk_create_buf_file_callback,
496 	.remove_buf_file	= blk_remove_buf_file_callback,
497 };
498 
499 static void blk_trace_setup_lba(struct blk_trace *bt,
500 				struct block_device *bdev)
501 {
502 	if (bdev) {
503 		bt->start_lba = bdev->bd_start_sect;
504 		bt->end_lba = bdev->bd_start_sect + bdev_nr_sectors(bdev);
505 	} else {
506 		bt->start_lba = 0;
507 		bt->end_lba = -1ULL;
508 	}
509 }
510 
511 /*
512  * Setup everything required to start tracing
513  */
514 static int do_blk_trace_setup(struct request_queue *q, char *name, dev_t dev,
515 			      struct block_device *bdev,
516 			      struct blk_user_trace_setup *buts)
517 {
518 	struct blk_trace *bt = NULL;
519 	struct dentry *dir = NULL;
520 	int ret;
521 
522 	lockdep_assert_held(&q->debugfs_mutex);
523 
524 	if (!buts->buf_size || !buts->buf_nr)
525 		return -EINVAL;
526 
527 	strscpy_pad(buts->name, name, BLKTRACE_BDEV_SIZE);
528 
529 	/*
530 	 * some device names have larger paths - convert the slashes
531 	 * to underscores for this to work as expected
532 	 */
533 	strreplace(buts->name, '/', '_');
534 
535 	/*
536 	 * bdev can be NULL, as with scsi-generic, this is a helpful as
537 	 * we can be.
538 	 */
539 	if (rcu_dereference_protected(q->blk_trace,
540 				      lockdep_is_held(&q->debugfs_mutex))) {
541 		pr_warn("Concurrent blktraces are not allowed on %s\n",
542 			buts->name);
543 		return -EBUSY;
544 	}
545 
546 	bt = kzalloc(sizeof(*bt), GFP_KERNEL);
547 	if (!bt)
548 		return -ENOMEM;
549 
550 	ret = -ENOMEM;
551 	bt->sequence = alloc_percpu(unsigned long);
552 	if (!bt->sequence)
553 		goto err;
554 
555 	bt->msg_data = __alloc_percpu(BLK_TN_MAX_MSG, __alignof__(char));
556 	if (!bt->msg_data)
557 		goto err;
558 
559 	/*
560 	 * When tracing the whole disk reuse the existing debugfs directory
561 	 * created by the block layer on init. For partitions block devices,
562 	 * and scsi-generic block devices we create a temporary new debugfs
563 	 * directory that will be removed once the trace ends.
564 	 */
565 	if (bdev && !bdev_is_partition(bdev))
566 		dir = q->debugfs_dir;
567 	else
568 		bt->dir = dir = debugfs_create_dir(buts->name, blk_debugfs_root);
569 
570 	/*
571 	 * As blktrace relies on debugfs for its interface the debugfs directory
572 	 * is required, contrary to the usual mantra of not checking for debugfs
573 	 * files or directories.
574 	 */
575 	if (IS_ERR_OR_NULL(dir)) {
576 		pr_warn("debugfs_dir not present for %s so skipping\n",
577 			buts->name);
578 		ret = -ENOENT;
579 		goto err;
580 	}
581 
582 	bt->dev = dev;
583 	atomic_set(&bt->dropped, 0);
584 	INIT_LIST_HEAD(&bt->running_list);
585 
586 	ret = -EIO;
587 	debugfs_create_file("dropped", 0444, dir, bt, &blk_dropped_fops);
588 	debugfs_create_file("msg", 0222, dir, bt, &blk_msg_fops);
589 
590 	bt->rchan = relay_open("trace", dir, buts->buf_size,
591 				buts->buf_nr, &blk_relay_callbacks, bt);
592 	if (!bt->rchan)
593 		goto err;
594 
595 	bt->act_mask = buts->act_mask;
596 	if (!bt->act_mask)
597 		bt->act_mask = (u16) -1;
598 
599 	blk_trace_setup_lba(bt, bdev);
600 
601 	/* overwrite with user settings */
602 	if (buts->start_lba)
603 		bt->start_lba = buts->start_lba;
604 	if (buts->end_lba)
605 		bt->end_lba = buts->end_lba;
606 
607 	bt->pid = buts->pid;
608 	bt->trace_state = Blktrace_setup;
609 
610 	rcu_assign_pointer(q->blk_trace, bt);
611 	get_probe_ref();
612 
613 	ret = 0;
614 err:
615 	if (ret)
616 		blk_trace_free(q, bt);
617 	return ret;
618 }
619 
620 int blk_trace_setup(struct request_queue *q, char *name, dev_t dev,
621 		    struct block_device *bdev,
622 		    char __user *arg)
623 {
624 	struct blk_user_trace_setup buts;
625 	int ret;
626 
627 	ret = copy_from_user(&buts, arg, sizeof(buts));
628 	if (ret)
629 		return -EFAULT;
630 
631 	mutex_lock(&q->debugfs_mutex);
632 	ret = do_blk_trace_setup(q, name, dev, bdev, &buts);
633 	mutex_unlock(&q->debugfs_mutex);
634 	if (ret)
635 		return ret;
636 
637 	if (copy_to_user(arg, &buts, sizeof(buts))) {
638 		blk_trace_remove(q);
639 		return -EFAULT;
640 	}
641 	return 0;
642 }
643 EXPORT_SYMBOL_GPL(blk_trace_setup);
644 
645 #if defined(CONFIG_COMPAT) && defined(CONFIG_X86_64)
646 static int compat_blk_trace_setup(struct request_queue *q, char *name,
647 				  dev_t dev, struct block_device *bdev,
648 				  char __user *arg)
649 {
650 	struct blk_user_trace_setup buts;
651 	struct compat_blk_user_trace_setup cbuts;
652 	int ret;
653 
654 	if (copy_from_user(&cbuts, arg, sizeof(cbuts)))
655 		return -EFAULT;
656 
657 	buts = (struct blk_user_trace_setup) {
658 		.act_mask = cbuts.act_mask,
659 		.buf_size = cbuts.buf_size,
660 		.buf_nr = cbuts.buf_nr,
661 		.start_lba = cbuts.start_lba,
662 		.end_lba = cbuts.end_lba,
663 		.pid = cbuts.pid,
664 	};
665 
666 	mutex_lock(&q->debugfs_mutex);
667 	ret = do_blk_trace_setup(q, name, dev, bdev, &buts);
668 	mutex_unlock(&q->debugfs_mutex);
669 	if (ret)
670 		return ret;
671 
672 	if (copy_to_user(arg, &buts.name, ARRAY_SIZE(buts.name))) {
673 		blk_trace_remove(q);
674 		return -EFAULT;
675 	}
676 
677 	return 0;
678 }
679 #endif
680 
681 static int __blk_trace_startstop(struct request_queue *q, int start)
682 {
683 	struct blk_trace *bt;
684 
685 	bt = rcu_dereference_protected(q->blk_trace,
686 				       lockdep_is_held(&q->debugfs_mutex));
687 	if (bt == NULL)
688 		return -EINVAL;
689 
690 	if (start)
691 		return blk_trace_start(bt);
692 	else
693 		return blk_trace_stop(bt);
694 }
695 
696 int blk_trace_startstop(struct request_queue *q, int start)
697 {
698 	int ret;
699 
700 	mutex_lock(&q->debugfs_mutex);
701 	ret = __blk_trace_startstop(q, start);
702 	mutex_unlock(&q->debugfs_mutex);
703 
704 	return ret;
705 }
706 EXPORT_SYMBOL_GPL(blk_trace_startstop);
707 
708 /*
709  * When reading or writing the blktrace sysfs files, the references to the
710  * opened sysfs or device files should prevent the underlying block device
711  * from being removed. So no further delete protection is really needed.
712  */
713 
714 /**
715  * blk_trace_ioctl - handle the ioctls associated with tracing
716  * @bdev:	the block device
717  * @cmd:	the ioctl cmd
718  * @arg:	the argument data, if any
719  *
720  **/
721 int blk_trace_ioctl(struct block_device *bdev, unsigned cmd, char __user *arg)
722 {
723 	struct request_queue *q = bdev_get_queue(bdev);
724 	int ret, start = 0;
725 	char b[BDEVNAME_SIZE];
726 
727 	switch (cmd) {
728 	case BLKTRACESETUP:
729 		snprintf(b, sizeof(b), "%pg", bdev);
730 		ret = blk_trace_setup(q, b, bdev->bd_dev, bdev, arg);
731 		break;
732 #if defined(CONFIG_COMPAT) && defined(CONFIG_X86_64)
733 	case BLKTRACESETUP32:
734 		snprintf(b, sizeof(b), "%pg", bdev);
735 		ret = compat_blk_trace_setup(q, b, bdev->bd_dev, bdev, arg);
736 		break;
737 #endif
738 	case BLKTRACESTART:
739 		start = 1;
740 		fallthrough;
741 	case BLKTRACESTOP:
742 		ret = blk_trace_startstop(q, start);
743 		break;
744 	case BLKTRACETEARDOWN:
745 		ret = blk_trace_remove(q);
746 		break;
747 	default:
748 		ret = -ENOTTY;
749 		break;
750 	}
751 	return ret;
752 }
753 
754 /**
755  * blk_trace_shutdown - stop and cleanup trace structures
756  * @q:    the request queue associated with the device
757  *
758  **/
759 void blk_trace_shutdown(struct request_queue *q)
760 {
761 	if (rcu_dereference_protected(q->blk_trace,
762 				      lockdep_is_held(&q->debugfs_mutex)))
763 		__blk_trace_remove(q);
764 }
765 
766 #ifdef CONFIG_BLK_CGROUP
767 static u64 blk_trace_bio_get_cgid(struct request_queue *q, struct bio *bio)
768 {
769 	struct cgroup_subsys_state *blkcg_css;
770 	struct blk_trace *bt;
771 
772 	/* We don't use the 'bt' value here except as an optimization... */
773 	bt = rcu_dereference_protected(q->blk_trace, 1);
774 	if (!bt || !(blk_tracer_flags.val & TRACE_BLK_OPT_CGROUP))
775 		return 0;
776 
777 	blkcg_css = bio_blkcg_css(bio);
778 	if (!blkcg_css)
779 		return 0;
780 	return cgroup_id(blkcg_css->cgroup);
781 }
782 #else
783 static u64 blk_trace_bio_get_cgid(struct request_queue *q, struct bio *bio)
784 {
785 	return 0;
786 }
787 #endif
788 
789 static u64
790 blk_trace_request_get_cgid(struct request *rq)
791 {
792 	if (!rq->bio)
793 		return 0;
794 	/* Use the first bio */
795 	return blk_trace_bio_get_cgid(rq->q, rq->bio);
796 }
797 
798 /*
799  * blktrace probes
800  */
801 
802 /**
803  * blk_add_trace_rq - Add a trace for a request oriented action
804  * @rq:		the source request
805  * @error:	return status to log
806  * @nr_bytes:	number of completed bytes
807  * @what:	the action
808  * @cgid:	the cgroup info
809  *
810  * Description:
811  *     Records an action against a request. Will log the bio offset + size.
812  *
813  **/
814 static void blk_add_trace_rq(struct request *rq, blk_status_t error,
815 			     unsigned int nr_bytes, u32 what, u64 cgid)
816 {
817 	struct blk_trace *bt;
818 
819 	rcu_read_lock();
820 	bt = rcu_dereference(rq->q->blk_trace);
821 	if (likely(!bt)) {
822 		rcu_read_unlock();
823 		return;
824 	}
825 
826 	if (blk_rq_is_passthrough(rq))
827 		what |= BLK_TC_ACT(BLK_TC_PC);
828 	else
829 		what |= BLK_TC_ACT(BLK_TC_FS);
830 
831 	__blk_add_trace(bt, blk_rq_trace_sector(rq), nr_bytes, rq->cmd_flags,
832 			what, blk_status_to_errno(error), 0, NULL, cgid);
833 	rcu_read_unlock();
834 }
835 
836 static void blk_add_trace_rq_insert(void *ignore, struct request *rq)
837 {
838 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_INSERT,
839 			 blk_trace_request_get_cgid(rq));
840 }
841 
842 static void blk_add_trace_rq_issue(void *ignore, struct request *rq)
843 {
844 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_ISSUE,
845 			 blk_trace_request_get_cgid(rq));
846 }
847 
848 static void blk_add_trace_rq_merge(void *ignore, struct request *rq)
849 {
850 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_BACKMERGE,
851 			 blk_trace_request_get_cgid(rq));
852 }
853 
854 static void blk_add_trace_rq_requeue(void *ignore, struct request *rq)
855 {
856 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_REQUEUE,
857 			 blk_trace_request_get_cgid(rq));
858 }
859 
860 static void blk_add_trace_rq_complete(void *ignore, struct request *rq,
861 			blk_status_t error, unsigned int nr_bytes)
862 {
863 	blk_add_trace_rq(rq, error, nr_bytes, BLK_TA_COMPLETE,
864 			 blk_trace_request_get_cgid(rq));
865 }
866 
867 /**
868  * blk_add_trace_bio - Add a trace for a bio oriented action
869  * @q:		queue the io is for
870  * @bio:	the source bio
871  * @what:	the action
872  * @error:	error, if any
873  *
874  * Description:
875  *     Records an action against a bio. Will log the bio offset + size.
876  *
877  **/
878 static void blk_add_trace_bio(struct request_queue *q, struct bio *bio,
879 			      u32 what, int error)
880 {
881 	struct blk_trace *bt;
882 
883 	rcu_read_lock();
884 	bt = rcu_dereference(q->blk_trace);
885 	if (likely(!bt)) {
886 		rcu_read_unlock();
887 		return;
888 	}
889 
890 	__blk_add_trace(bt, bio->bi_iter.bi_sector, bio->bi_iter.bi_size,
891 			bio->bi_opf, what, error, 0, NULL,
892 			blk_trace_bio_get_cgid(q, bio));
893 	rcu_read_unlock();
894 }
895 
896 static void blk_add_trace_bio_bounce(void *ignore, struct bio *bio)
897 {
898 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_BOUNCE, 0);
899 }
900 
901 static void blk_add_trace_bio_complete(void *ignore,
902 				       struct request_queue *q, struct bio *bio)
903 {
904 	blk_add_trace_bio(q, bio, BLK_TA_COMPLETE,
905 			  blk_status_to_errno(bio->bi_status));
906 }
907 
908 static void blk_add_trace_bio_backmerge(void *ignore, struct bio *bio)
909 {
910 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_BACKMERGE,
911 			0);
912 }
913 
914 static void blk_add_trace_bio_frontmerge(void *ignore, struct bio *bio)
915 {
916 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_FRONTMERGE,
917 			0);
918 }
919 
920 static void blk_add_trace_bio_queue(void *ignore, struct bio *bio)
921 {
922 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_QUEUE, 0);
923 }
924 
925 static void blk_add_trace_getrq(void *ignore, struct bio *bio)
926 {
927 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_GETRQ, 0);
928 }
929 
930 static void blk_add_trace_plug(void *ignore, struct request_queue *q)
931 {
932 	struct blk_trace *bt;
933 
934 	rcu_read_lock();
935 	bt = rcu_dereference(q->blk_trace);
936 	if (bt)
937 		__blk_add_trace(bt, 0, 0, 0, BLK_TA_PLUG, 0, 0, NULL, 0);
938 	rcu_read_unlock();
939 }
940 
941 static void blk_add_trace_unplug(void *ignore, struct request_queue *q,
942 				    unsigned int depth, bool explicit)
943 {
944 	struct blk_trace *bt;
945 
946 	rcu_read_lock();
947 	bt = rcu_dereference(q->blk_trace);
948 	if (bt) {
949 		__be64 rpdu = cpu_to_be64(depth);
950 		u32 what;
951 
952 		if (explicit)
953 			what = BLK_TA_UNPLUG_IO;
954 		else
955 			what = BLK_TA_UNPLUG_TIMER;
956 
957 		__blk_add_trace(bt, 0, 0, 0, what, 0, sizeof(rpdu), &rpdu, 0);
958 	}
959 	rcu_read_unlock();
960 }
961 
962 static void blk_add_trace_split(void *ignore, struct bio *bio, unsigned int pdu)
963 {
964 	struct request_queue *q = bio->bi_bdev->bd_disk->queue;
965 	struct blk_trace *bt;
966 
967 	rcu_read_lock();
968 	bt = rcu_dereference(q->blk_trace);
969 	if (bt) {
970 		__be64 rpdu = cpu_to_be64(pdu);
971 
972 		__blk_add_trace(bt, bio->bi_iter.bi_sector,
973 				bio->bi_iter.bi_size, bio->bi_opf, BLK_TA_SPLIT,
974 				blk_status_to_errno(bio->bi_status),
975 				sizeof(rpdu), &rpdu,
976 				blk_trace_bio_get_cgid(q, bio));
977 	}
978 	rcu_read_unlock();
979 }
980 
981 /**
982  * blk_add_trace_bio_remap - Add a trace for a bio-remap operation
983  * @ignore:	trace callback data parameter (not used)
984  * @bio:	the source bio
985  * @dev:	source device
986  * @from:	source sector
987  *
988  * Called after a bio is remapped to a different device and/or sector.
989  **/
990 static void blk_add_trace_bio_remap(void *ignore, struct bio *bio, dev_t dev,
991 				    sector_t from)
992 {
993 	struct request_queue *q = bio->bi_bdev->bd_disk->queue;
994 	struct blk_trace *bt;
995 	struct blk_io_trace_remap r;
996 
997 	rcu_read_lock();
998 	bt = rcu_dereference(q->blk_trace);
999 	if (likely(!bt)) {
1000 		rcu_read_unlock();
1001 		return;
1002 	}
1003 
1004 	r.device_from = cpu_to_be32(dev);
1005 	r.device_to   = cpu_to_be32(bio_dev(bio));
1006 	r.sector_from = cpu_to_be64(from);
1007 
1008 	__blk_add_trace(bt, bio->bi_iter.bi_sector, bio->bi_iter.bi_size,
1009 			bio->bi_opf, BLK_TA_REMAP,
1010 			blk_status_to_errno(bio->bi_status),
1011 			sizeof(r), &r, blk_trace_bio_get_cgid(q, bio));
1012 	rcu_read_unlock();
1013 }
1014 
1015 /**
1016  * blk_add_trace_rq_remap - Add a trace for a request-remap operation
1017  * @ignore:	trace callback data parameter (not used)
1018  * @rq:		the source request
1019  * @dev:	target device
1020  * @from:	source sector
1021  *
1022  * Description:
1023  *     Device mapper remaps request to other devices.
1024  *     Add a trace for that action.
1025  *
1026  **/
1027 static void blk_add_trace_rq_remap(void *ignore, struct request *rq, dev_t dev,
1028 				   sector_t from)
1029 {
1030 	struct blk_trace *bt;
1031 	struct blk_io_trace_remap r;
1032 
1033 	rcu_read_lock();
1034 	bt = rcu_dereference(rq->q->blk_trace);
1035 	if (likely(!bt)) {
1036 		rcu_read_unlock();
1037 		return;
1038 	}
1039 
1040 	r.device_from = cpu_to_be32(dev);
1041 	r.device_to   = cpu_to_be32(disk_devt(rq->q->disk));
1042 	r.sector_from = cpu_to_be64(from);
1043 
1044 	__blk_add_trace(bt, blk_rq_pos(rq), blk_rq_bytes(rq),
1045 			rq->cmd_flags, BLK_TA_REMAP, 0,
1046 			sizeof(r), &r, blk_trace_request_get_cgid(rq));
1047 	rcu_read_unlock();
1048 }
1049 
1050 /**
1051  * blk_add_driver_data - Add binary message with driver-specific data
1052  * @rq:		io request
1053  * @data:	driver-specific data
1054  * @len:	length of driver-specific data
1055  *
1056  * Description:
1057  *     Some drivers might want to write driver-specific data per request.
1058  *
1059  **/
1060 void blk_add_driver_data(struct request *rq, void *data, size_t len)
1061 {
1062 	struct blk_trace *bt;
1063 
1064 	rcu_read_lock();
1065 	bt = rcu_dereference(rq->q->blk_trace);
1066 	if (likely(!bt)) {
1067 		rcu_read_unlock();
1068 		return;
1069 	}
1070 
1071 	__blk_add_trace(bt, blk_rq_trace_sector(rq), blk_rq_bytes(rq), 0,
1072 				BLK_TA_DRV_DATA, 0, len, data,
1073 				blk_trace_request_get_cgid(rq));
1074 	rcu_read_unlock();
1075 }
1076 EXPORT_SYMBOL_GPL(blk_add_driver_data);
1077 
1078 static void blk_register_tracepoints(void)
1079 {
1080 	int ret;
1081 
1082 	ret = register_trace_block_rq_insert(blk_add_trace_rq_insert, NULL);
1083 	WARN_ON(ret);
1084 	ret = register_trace_block_rq_issue(blk_add_trace_rq_issue, NULL);
1085 	WARN_ON(ret);
1086 	ret = register_trace_block_rq_merge(blk_add_trace_rq_merge, NULL);
1087 	WARN_ON(ret);
1088 	ret = register_trace_block_rq_requeue(blk_add_trace_rq_requeue, NULL);
1089 	WARN_ON(ret);
1090 	ret = register_trace_block_rq_complete(blk_add_trace_rq_complete, NULL);
1091 	WARN_ON(ret);
1092 	ret = register_trace_block_bio_bounce(blk_add_trace_bio_bounce, NULL);
1093 	WARN_ON(ret);
1094 	ret = register_trace_block_bio_complete(blk_add_trace_bio_complete, NULL);
1095 	WARN_ON(ret);
1096 	ret = register_trace_block_bio_backmerge(blk_add_trace_bio_backmerge, NULL);
1097 	WARN_ON(ret);
1098 	ret = register_trace_block_bio_frontmerge(blk_add_trace_bio_frontmerge, NULL);
1099 	WARN_ON(ret);
1100 	ret = register_trace_block_bio_queue(blk_add_trace_bio_queue, NULL);
1101 	WARN_ON(ret);
1102 	ret = register_trace_block_getrq(blk_add_trace_getrq, NULL);
1103 	WARN_ON(ret);
1104 	ret = register_trace_block_plug(blk_add_trace_plug, NULL);
1105 	WARN_ON(ret);
1106 	ret = register_trace_block_unplug(blk_add_trace_unplug, NULL);
1107 	WARN_ON(ret);
1108 	ret = register_trace_block_split(blk_add_trace_split, NULL);
1109 	WARN_ON(ret);
1110 	ret = register_trace_block_bio_remap(blk_add_trace_bio_remap, NULL);
1111 	WARN_ON(ret);
1112 	ret = register_trace_block_rq_remap(blk_add_trace_rq_remap, NULL);
1113 	WARN_ON(ret);
1114 }
1115 
1116 static void blk_unregister_tracepoints(void)
1117 {
1118 	unregister_trace_block_rq_remap(blk_add_trace_rq_remap, NULL);
1119 	unregister_trace_block_bio_remap(blk_add_trace_bio_remap, NULL);
1120 	unregister_trace_block_split(blk_add_trace_split, NULL);
1121 	unregister_trace_block_unplug(blk_add_trace_unplug, NULL);
1122 	unregister_trace_block_plug(blk_add_trace_plug, NULL);
1123 	unregister_trace_block_getrq(blk_add_trace_getrq, NULL);
1124 	unregister_trace_block_bio_queue(blk_add_trace_bio_queue, NULL);
1125 	unregister_trace_block_bio_frontmerge(blk_add_trace_bio_frontmerge, NULL);
1126 	unregister_trace_block_bio_backmerge(blk_add_trace_bio_backmerge, NULL);
1127 	unregister_trace_block_bio_complete(blk_add_trace_bio_complete, NULL);
1128 	unregister_trace_block_bio_bounce(blk_add_trace_bio_bounce, NULL);
1129 	unregister_trace_block_rq_complete(blk_add_trace_rq_complete, NULL);
1130 	unregister_trace_block_rq_requeue(blk_add_trace_rq_requeue, NULL);
1131 	unregister_trace_block_rq_merge(blk_add_trace_rq_merge, NULL);
1132 	unregister_trace_block_rq_issue(blk_add_trace_rq_issue, NULL);
1133 	unregister_trace_block_rq_insert(blk_add_trace_rq_insert, NULL);
1134 
1135 	tracepoint_synchronize_unregister();
1136 }
1137 
1138 /*
1139  * struct blk_io_tracer formatting routines
1140  */
1141 
1142 static void fill_rwbs(char *rwbs, const struct blk_io_trace *t)
1143 {
1144 	int i = 0;
1145 	int tc = t->action >> BLK_TC_SHIFT;
1146 
1147 	if ((t->action & ~__BLK_TN_CGROUP) == BLK_TN_MESSAGE) {
1148 		rwbs[i++] = 'N';
1149 		goto out;
1150 	}
1151 
1152 	if (tc & BLK_TC_FLUSH)
1153 		rwbs[i++] = 'F';
1154 
1155 	if (tc & BLK_TC_DISCARD)
1156 		rwbs[i++] = 'D';
1157 	else if (tc & BLK_TC_WRITE)
1158 		rwbs[i++] = 'W';
1159 	else if (t->bytes)
1160 		rwbs[i++] = 'R';
1161 	else
1162 		rwbs[i++] = 'N';
1163 
1164 	if (tc & BLK_TC_FUA)
1165 		rwbs[i++] = 'F';
1166 	if (tc & BLK_TC_AHEAD)
1167 		rwbs[i++] = 'A';
1168 	if (tc & BLK_TC_SYNC)
1169 		rwbs[i++] = 'S';
1170 	if (tc & BLK_TC_META)
1171 		rwbs[i++] = 'M';
1172 out:
1173 	rwbs[i] = '\0';
1174 }
1175 
1176 static inline
1177 const struct blk_io_trace *te_blk_io_trace(const struct trace_entry *ent)
1178 {
1179 	return (const struct blk_io_trace *)ent;
1180 }
1181 
1182 static inline const void *pdu_start(const struct trace_entry *ent, bool has_cg)
1183 {
1184 	return (void *)(te_blk_io_trace(ent) + 1) + (has_cg ? sizeof(u64) : 0);
1185 }
1186 
1187 static inline u64 t_cgid(const struct trace_entry *ent)
1188 {
1189 	return *(u64 *)(te_blk_io_trace(ent) + 1);
1190 }
1191 
1192 static inline int pdu_real_len(const struct trace_entry *ent, bool has_cg)
1193 {
1194 	return te_blk_io_trace(ent)->pdu_len - (has_cg ? sizeof(u64) : 0);
1195 }
1196 
1197 static inline u32 t_action(const struct trace_entry *ent)
1198 {
1199 	return te_blk_io_trace(ent)->action;
1200 }
1201 
1202 static inline u32 t_bytes(const struct trace_entry *ent)
1203 {
1204 	return te_blk_io_trace(ent)->bytes;
1205 }
1206 
1207 static inline u32 t_sec(const struct trace_entry *ent)
1208 {
1209 	return te_blk_io_trace(ent)->bytes >> 9;
1210 }
1211 
1212 static inline unsigned long long t_sector(const struct trace_entry *ent)
1213 {
1214 	return te_blk_io_trace(ent)->sector;
1215 }
1216 
1217 static inline __u16 t_error(const struct trace_entry *ent)
1218 {
1219 	return te_blk_io_trace(ent)->error;
1220 }
1221 
1222 static __u64 get_pdu_int(const struct trace_entry *ent, bool has_cg)
1223 {
1224 	const __be64 *val = pdu_start(ent, has_cg);
1225 	return be64_to_cpu(*val);
1226 }
1227 
1228 typedef void (blk_log_action_t) (struct trace_iterator *iter, const char *act,
1229 	bool has_cg);
1230 
1231 static void blk_log_action_classic(struct trace_iterator *iter, const char *act,
1232 	bool has_cg)
1233 {
1234 	char rwbs[RWBS_LEN];
1235 	unsigned long long ts  = iter->ts;
1236 	unsigned long nsec_rem = do_div(ts, NSEC_PER_SEC);
1237 	unsigned secs	       = (unsigned long)ts;
1238 	const struct blk_io_trace *t = te_blk_io_trace(iter->ent);
1239 
1240 	fill_rwbs(rwbs, t);
1241 
1242 	trace_seq_printf(&iter->seq,
1243 			 "%3d,%-3d %2d %5d.%09lu %5u %2s %3s ",
1244 			 MAJOR(t->device), MINOR(t->device), iter->cpu,
1245 			 secs, nsec_rem, iter->ent->pid, act, rwbs);
1246 }
1247 
1248 static void blk_log_action(struct trace_iterator *iter, const char *act,
1249 	bool has_cg)
1250 {
1251 	char rwbs[RWBS_LEN];
1252 	const struct blk_io_trace *t = te_blk_io_trace(iter->ent);
1253 
1254 	fill_rwbs(rwbs, t);
1255 	if (has_cg) {
1256 		u64 id = t_cgid(iter->ent);
1257 
1258 		if (blk_tracer_flags.val & TRACE_BLK_OPT_CGNAME) {
1259 			char blkcg_name_buf[NAME_MAX + 1] = "<...>";
1260 
1261 			cgroup_path_from_kernfs_id(id, blkcg_name_buf,
1262 				sizeof(blkcg_name_buf));
1263 			trace_seq_printf(&iter->seq, "%3d,%-3d %s %2s %3s ",
1264 				 MAJOR(t->device), MINOR(t->device),
1265 				 blkcg_name_buf, act, rwbs);
1266 		} else {
1267 			/*
1268 			 * The cgid portion used to be "INO,GEN".  Userland
1269 			 * builds a FILEID_INO32_GEN fid out of them and
1270 			 * opens the cgroup using open_by_handle_at(2).
1271 			 * While 32bit ino setups are still the same, 64bit
1272 			 * ones now use the 64bit ino as the whole ID and
1273 			 * no longer use generation.
1274 			 *
1275 			 * Regardless of the content, always output
1276 			 * "LOW32,HIGH32" so that FILEID_INO32_GEN fid can
1277 			 * be mapped back to @id on both 64 and 32bit ino
1278 			 * setups.  See __kernfs_fh_to_dentry().
1279 			 */
1280 			trace_seq_printf(&iter->seq,
1281 				 "%3d,%-3d %llx,%-llx %2s %3s ",
1282 				 MAJOR(t->device), MINOR(t->device),
1283 				 id & U32_MAX, id >> 32, act, rwbs);
1284 		}
1285 	} else
1286 		trace_seq_printf(&iter->seq, "%3d,%-3d %2s %3s ",
1287 				 MAJOR(t->device), MINOR(t->device), act, rwbs);
1288 }
1289 
1290 static void blk_log_dump_pdu(struct trace_seq *s,
1291 	const struct trace_entry *ent, bool has_cg)
1292 {
1293 	const unsigned char *pdu_buf;
1294 	int pdu_len;
1295 	int i, end;
1296 
1297 	pdu_buf = pdu_start(ent, has_cg);
1298 	pdu_len = pdu_real_len(ent, has_cg);
1299 
1300 	if (!pdu_len)
1301 		return;
1302 
1303 	/* find the last zero that needs to be printed */
1304 	for (end = pdu_len - 1; end >= 0; end--)
1305 		if (pdu_buf[end])
1306 			break;
1307 	end++;
1308 
1309 	trace_seq_putc(s, '(');
1310 
1311 	for (i = 0; i < pdu_len; i++) {
1312 
1313 		trace_seq_printf(s, "%s%02x",
1314 				 i == 0 ? "" : " ", pdu_buf[i]);
1315 
1316 		/*
1317 		 * stop when the rest is just zeros and indicate so
1318 		 * with a ".." appended
1319 		 */
1320 		if (i == end && end != pdu_len - 1) {
1321 			trace_seq_puts(s, " ..) ");
1322 			return;
1323 		}
1324 	}
1325 
1326 	trace_seq_puts(s, ") ");
1327 }
1328 
1329 static void blk_log_generic(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1330 {
1331 	char cmd[TASK_COMM_LEN];
1332 
1333 	trace_find_cmdline(ent->pid, cmd);
1334 
1335 	if (t_action(ent) & BLK_TC_ACT(BLK_TC_PC)) {
1336 		trace_seq_printf(s, "%u ", t_bytes(ent));
1337 		blk_log_dump_pdu(s, ent, has_cg);
1338 		trace_seq_printf(s, "[%s]\n", cmd);
1339 	} else {
1340 		if (t_sec(ent))
1341 			trace_seq_printf(s, "%llu + %u [%s]\n",
1342 						t_sector(ent), t_sec(ent), cmd);
1343 		else
1344 			trace_seq_printf(s, "[%s]\n", cmd);
1345 	}
1346 }
1347 
1348 static void blk_log_with_error(struct trace_seq *s,
1349 			      const struct trace_entry *ent, bool has_cg)
1350 {
1351 	if (t_action(ent) & BLK_TC_ACT(BLK_TC_PC)) {
1352 		blk_log_dump_pdu(s, ent, has_cg);
1353 		trace_seq_printf(s, "[%d]\n", t_error(ent));
1354 	} else {
1355 		if (t_sec(ent))
1356 			trace_seq_printf(s, "%llu + %u [%d]\n",
1357 					 t_sector(ent),
1358 					 t_sec(ent), t_error(ent));
1359 		else
1360 			trace_seq_printf(s, "%llu [%d]\n",
1361 					 t_sector(ent), t_error(ent));
1362 	}
1363 }
1364 
1365 static void blk_log_remap(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1366 {
1367 	const struct blk_io_trace_remap *__r = pdu_start(ent, has_cg);
1368 
1369 	trace_seq_printf(s, "%llu + %u <- (%d,%d) %llu\n",
1370 			 t_sector(ent), t_sec(ent),
1371 			 MAJOR(be32_to_cpu(__r->device_from)),
1372 			 MINOR(be32_to_cpu(__r->device_from)),
1373 			 be64_to_cpu(__r->sector_from));
1374 }
1375 
1376 static void blk_log_plug(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1377 {
1378 	char cmd[TASK_COMM_LEN];
1379 
1380 	trace_find_cmdline(ent->pid, cmd);
1381 
1382 	trace_seq_printf(s, "[%s]\n", cmd);
1383 }
1384 
1385 static void blk_log_unplug(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1386 {
1387 	char cmd[TASK_COMM_LEN];
1388 
1389 	trace_find_cmdline(ent->pid, cmd);
1390 
1391 	trace_seq_printf(s, "[%s] %llu\n", cmd, get_pdu_int(ent, has_cg));
1392 }
1393 
1394 static void blk_log_split(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1395 {
1396 	char cmd[TASK_COMM_LEN];
1397 
1398 	trace_find_cmdline(ent->pid, cmd);
1399 
1400 	trace_seq_printf(s, "%llu / %llu [%s]\n", t_sector(ent),
1401 			 get_pdu_int(ent, has_cg), cmd);
1402 }
1403 
1404 static void blk_log_msg(struct trace_seq *s, const struct trace_entry *ent,
1405 			bool has_cg)
1406 {
1407 
1408 	trace_seq_putmem(s, pdu_start(ent, has_cg),
1409 		pdu_real_len(ent, has_cg));
1410 	trace_seq_putc(s, '\n');
1411 }
1412 
1413 /*
1414  * struct tracer operations
1415  */
1416 
1417 static void blk_tracer_print_header(struct seq_file *m)
1418 {
1419 	if (!(blk_tracer_flags.val & TRACE_BLK_OPT_CLASSIC))
1420 		return;
1421 	seq_puts(m, "# DEV   CPU TIMESTAMP     PID ACT FLG\n"
1422 		    "#  |     |     |           |   |   |\n");
1423 }
1424 
1425 static void blk_tracer_start(struct trace_array *tr)
1426 {
1427 	blk_tracer_enabled = true;
1428 }
1429 
1430 static int blk_tracer_init(struct trace_array *tr)
1431 {
1432 	blk_tr = tr;
1433 	blk_tracer_start(tr);
1434 	return 0;
1435 }
1436 
1437 static void blk_tracer_stop(struct trace_array *tr)
1438 {
1439 	blk_tracer_enabled = false;
1440 }
1441 
1442 static void blk_tracer_reset(struct trace_array *tr)
1443 {
1444 	blk_tracer_stop(tr);
1445 }
1446 
1447 static const struct {
1448 	const char *act[2];
1449 	void	   (*print)(struct trace_seq *s, const struct trace_entry *ent,
1450 			    bool has_cg);
1451 } what2act[] = {
1452 	[__BLK_TA_QUEUE]	= {{  "Q", "queue" },	   blk_log_generic },
1453 	[__BLK_TA_BACKMERGE]	= {{  "M", "backmerge" },  blk_log_generic },
1454 	[__BLK_TA_FRONTMERGE]	= {{  "F", "frontmerge" }, blk_log_generic },
1455 	[__BLK_TA_GETRQ]	= {{  "G", "getrq" },	   blk_log_generic },
1456 	[__BLK_TA_SLEEPRQ]	= {{  "S", "sleeprq" },	   blk_log_generic },
1457 	[__BLK_TA_REQUEUE]	= {{  "R", "requeue" },	   blk_log_with_error },
1458 	[__BLK_TA_ISSUE]	= {{  "D", "issue" },	   blk_log_generic },
1459 	[__BLK_TA_COMPLETE]	= {{  "C", "complete" },   blk_log_with_error },
1460 	[__BLK_TA_PLUG]		= {{  "P", "plug" },	   blk_log_plug },
1461 	[__BLK_TA_UNPLUG_IO]	= {{  "U", "unplug_io" },  blk_log_unplug },
1462 	[__BLK_TA_UNPLUG_TIMER]	= {{ "UT", "unplug_timer" }, blk_log_unplug },
1463 	[__BLK_TA_INSERT]	= {{  "I", "insert" },	   blk_log_generic },
1464 	[__BLK_TA_SPLIT]	= {{  "X", "split" },	   blk_log_split },
1465 	[__BLK_TA_BOUNCE]	= {{  "B", "bounce" },	   blk_log_generic },
1466 	[__BLK_TA_REMAP]	= {{  "A", "remap" },	   blk_log_remap },
1467 };
1468 
1469 static enum print_line_t print_one_line(struct trace_iterator *iter,
1470 					bool classic)
1471 {
1472 	struct trace_array *tr = iter->tr;
1473 	struct trace_seq *s = &iter->seq;
1474 	const struct blk_io_trace *t;
1475 	u16 what;
1476 	bool long_act;
1477 	blk_log_action_t *log_action;
1478 	bool has_cg;
1479 
1480 	t	   = te_blk_io_trace(iter->ent);
1481 	what	   = (t->action & ((1 << BLK_TC_SHIFT) - 1)) & ~__BLK_TA_CGROUP;
1482 	long_act   = !!(tr->trace_flags & TRACE_ITER_VERBOSE);
1483 	log_action = classic ? &blk_log_action_classic : &blk_log_action;
1484 	has_cg	   = t->action & __BLK_TA_CGROUP;
1485 
1486 	if ((t->action & ~__BLK_TN_CGROUP) == BLK_TN_MESSAGE) {
1487 		log_action(iter, long_act ? "message" : "m", has_cg);
1488 		blk_log_msg(s, iter->ent, has_cg);
1489 		return trace_handle_return(s);
1490 	}
1491 
1492 	if (unlikely(what == 0 || what >= ARRAY_SIZE(what2act)))
1493 		trace_seq_printf(s, "Unknown action %x\n", what);
1494 	else {
1495 		log_action(iter, what2act[what].act[long_act], has_cg);
1496 		what2act[what].print(s, iter->ent, has_cg);
1497 	}
1498 
1499 	return trace_handle_return(s);
1500 }
1501 
1502 static enum print_line_t blk_trace_event_print(struct trace_iterator *iter,
1503 					       int flags, struct trace_event *event)
1504 {
1505 	return print_one_line(iter, false);
1506 }
1507 
1508 static void blk_trace_synthesize_old_trace(struct trace_iterator *iter)
1509 {
1510 	struct trace_seq *s = &iter->seq;
1511 	struct blk_io_trace *t = (struct blk_io_trace *)iter->ent;
1512 	const int offset = offsetof(struct blk_io_trace, sector);
1513 	struct blk_io_trace old = {
1514 		.magic	  = BLK_IO_TRACE_MAGIC | BLK_IO_TRACE_VERSION,
1515 		.time     = iter->ts,
1516 	};
1517 
1518 	trace_seq_putmem(s, &old, offset);
1519 	trace_seq_putmem(s, &t->sector,
1520 			 sizeof(old) - offset + t->pdu_len);
1521 }
1522 
1523 static enum print_line_t
1524 blk_trace_event_print_binary(struct trace_iterator *iter, int flags,
1525 			     struct trace_event *event)
1526 {
1527 	blk_trace_synthesize_old_trace(iter);
1528 
1529 	return trace_handle_return(&iter->seq);
1530 }
1531 
1532 static enum print_line_t blk_tracer_print_line(struct trace_iterator *iter)
1533 {
1534 	if ((iter->ent->type != TRACE_BLK) ||
1535 	    !(blk_tracer_flags.val & TRACE_BLK_OPT_CLASSIC))
1536 		return TRACE_TYPE_UNHANDLED;
1537 
1538 	return print_one_line(iter, true);
1539 }
1540 
1541 static int
1542 blk_tracer_set_flag(struct trace_array *tr, u32 old_flags, u32 bit, int set)
1543 {
1544 	/* don't output context-info for blk_classic output */
1545 	if (bit == TRACE_BLK_OPT_CLASSIC) {
1546 		if (set)
1547 			tr->trace_flags &= ~TRACE_ITER_CONTEXT_INFO;
1548 		else
1549 			tr->trace_flags |= TRACE_ITER_CONTEXT_INFO;
1550 	}
1551 	return 0;
1552 }
1553 
1554 static struct tracer blk_tracer __read_mostly = {
1555 	.name		= "blk",
1556 	.init		= blk_tracer_init,
1557 	.reset		= blk_tracer_reset,
1558 	.start		= blk_tracer_start,
1559 	.stop		= blk_tracer_stop,
1560 	.print_header	= blk_tracer_print_header,
1561 	.print_line	= blk_tracer_print_line,
1562 	.flags		= &blk_tracer_flags,
1563 	.set_flag	= blk_tracer_set_flag,
1564 };
1565 
1566 static struct trace_event_functions trace_blk_event_funcs = {
1567 	.trace		= blk_trace_event_print,
1568 	.binary		= blk_trace_event_print_binary,
1569 };
1570 
1571 static struct trace_event trace_blk_event = {
1572 	.type		= TRACE_BLK,
1573 	.funcs		= &trace_blk_event_funcs,
1574 };
1575 
1576 static int __init init_blk_tracer(void)
1577 {
1578 	if (!register_trace_event(&trace_blk_event)) {
1579 		pr_warn("Warning: could not register block events\n");
1580 		return 1;
1581 	}
1582 
1583 	if (register_tracer(&blk_tracer) != 0) {
1584 		pr_warn("Warning: could not register the block tracer\n");
1585 		unregister_trace_event(&trace_blk_event);
1586 		return 1;
1587 	}
1588 
1589 	return 0;
1590 }
1591 
1592 device_initcall(init_blk_tracer);
1593 
1594 static int blk_trace_remove_queue(struct request_queue *q)
1595 {
1596 	struct blk_trace *bt;
1597 
1598 	bt = rcu_replace_pointer(q->blk_trace, NULL,
1599 				 lockdep_is_held(&q->debugfs_mutex));
1600 	if (bt == NULL)
1601 		return -EINVAL;
1602 
1603 	blk_trace_stop(bt);
1604 
1605 	put_probe_ref();
1606 	synchronize_rcu();
1607 	blk_trace_free(q, bt);
1608 	return 0;
1609 }
1610 
1611 /*
1612  * Setup everything required to start tracing
1613  */
1614 static int blk_trace_setup_queue(struct request_queue *q,
1615 				 struct block_device *bdev)
1616 {
1617 	struct blk_trace *bt = NULL;
1618 	int ret = -ENOMEM;
1619 
1620 	bt = kzalloc(sizeof(*bt), GFP_KERNEL);
1621 	if (!bt)
1622 		return -ENOMEM;
1623 
1624 	bt->msg_data = __alloc_percpu(BLK_TN_MAX_MSG, __alignof__(char));
1625 	if (!bt->msg_data)
1626 		goto free_bt;
1627 
1628 	bt->dev = bdev->bd_dev;
1629 	bt->act_mask = (u16)-1;
1630 
1631 	blk_trace_setup_lba(bt, bdev);
1632 
1633 	rcu_assign_pointer(q->blk_trace, bt);
1634 	get_probe_ref();
1635 	return 0;
1636 
1637 free_bt:
1638 	blk_trace_free(q, bt);
1639 	return ret;
1640 }
1641 
1642 /*
1643  * sysfs interface to enable and configure tracing
1644  */
1645 
1646 static ssize_t sysfs_blk_trace_attr_show(struct device *dev,
1647 					 struct device_attribute *attr,
1648 					 char *buf);
1649 static ssize_t sysfs_blk_trace_attr_store(struct device *dev,
1650 					  struct device_attribute *attr,
1651 					  const char *buf, size_t count);
1652 #define BLK_TRACE_DEVICE_ATTR(_name) \
1653 	DEVICE_ATTR(_name, S_IRUGO | S_IWUSR, \
1654 		    sysfs_blk_trace_attr_show, \
1655 		    sysfs_blk_trace_attr_store)
1656 
1657 static BLK_TRACE_DEVICE_ATTR(enable);
1658 static BLK_TRACE_DEVICE_ATTR(act_mask);
1659 static BLK_TRACE_DEVICE_ATTR(pid);
1660 static BLK_TRACE_DEVICE_ATTR(start_lba);
1661 static BLK_TRACE_DEVICE_ATTR(end_lba);
1662 
1663 static struct attribute *blk_trace_attrs[] = {
1664 	&dev_attr_enable.attr,
1665 	&dev_attr_act_mask.attr,
1666 	&dev_attr_pid.attr,
1667 	&dev_attr_start_lba.attr,
1668 	&dev_attr_end_lba.attr,
1669 	NULL
1670 };
1671 
1672 struct attribute_group blk_trace_attr_group = {
1673 	.name  = "trace",
1674 	.attrs = blk_trace_attrs,
1675 };
1676 
1677 static const struct {
1678 	int mask;
1679 	const char *str;
1680 } mask_maps[] = {
1681 	{ BLK_TC_READ,		"read"		},
1682 	{ BLK_TC_WRITE,		"write"		},
1683 	{ BLK_TC_FLUSH,		"flush"		},
1684 	{ BLK_TC_SYNC,		"sync"		},
1685 	{ BLK_TC_QUEUE,		"queue"		},
1686 	{ BLK_TC_REQUEUE,	"requeue"	},
1687 	{ BLK_TC_ISSUE,		"issue"		},
1688 	{ BLK_TC_COMPLETE,	"complete"	},
1689 	{ BLK_TC_FS,		"fs"		},
1690 	{ BLK_TC_PC,		"pc"		},
1691 	{ BLK_TC_NOTIFY,	"notify"	},
1692 	{ BLK_TC_AHEAD,		"ahead"		},
1693 	{ BLK_TC_META,		"meta"		},
1694 	{ BLK_TC_DISCARD,	"discard"	},
1695 	{ BLK_TC_DRV_DATA,	"drv_data"	},
1696 	{ BLK_TC_FUA,		"fua"		},
1697 };
1698 
1699 static int blk_trace_str2mask(const char *str)
1700 {
1701 	int i;
1702 	int mask = 0;
1703 	char *buf, *s, *token;
1704 
1705 	buf = kstrdup(str, GFP_KERNEL);
1706 	if (buf == NULL)
1707 		return -ENOMEM;
1708 	s = strstrip(buf);
1709 
1710 	while (1) {
1711 		token = strsep(&s, ",");
1712 		if (token == NULL)
1713 			break;
1714 
1715 		if (*token == '\0')
1716 			continue;
1717 
1718 		for (i = 0; i < ARRAY_SIZE(mask_maps); i++) {
1719 			if (strcasecmp(token, mask_maps[i].str) == 0) {
1720 				mask |= mask_maps[i].mask;
1721 				break;
1722 			}
1723 		}
1724 		if (i == ARRAY_SIZE(mask_maps)) {
1725 			mask = -EINVAL;
1726 			break;
1727 		}
1728 	}
1729 	kfree(buf);
1730 
1731 	return mask;
1732 }
1733 
1734 static ssize_t blk_trace_mask2str(char *buf, int mask)
1735 {
1736 	int i;
1737 	char *p = buf;
1738 
1739 	for (i = 0; i < ARRAY_SIZE(mask_maps); i++) {
1740 		if (mask & mask_maps[i].mask) {
1741 			p += sprintf(p, "%s%s",
1742 				    (p == buf) ? "" : ",", mask_maps[i].str);
1743 		}
1744 	}
1745 	*p++ = '\n';
1746 
1747 	return p - buf;
1748 }
1749 
1750 static ssize_t sysfs_blk_trace_attr_show(struct device *dev,
1751 					 struct device_attribute *attr,
1752 					 char *buf)
1753 {
1754 	struct block_device *bdev = dev_to_bdev(dev);
1755 	struct request_queue *q = bdev_get_queue(bdev);
1756 	struct blk_trace *bt;
1757 	ssize_t ret = -ENXIO;
1758 
1759 	mutex_lock(&q->debugfs_mutex);
1760 
1761 	bt = rcu_dereference_protected(q->blk_trace,
1762 				       lockdep_is_held(&q->debugfs_mutex));
1763 	if (attr == &dev_attr_enable) {
1764 		ret = sprintf(buf, "%u\n", !!bt);
1765 		goto out_unlock_bdev;
1766 	}
1767 
1768 	if (bt == NULL)
1769 		ret = sprintf(buf, "disabled\n");
1770 	else if (attr == &dev_attr_act_mask)
1771 		ret = blk_trace_mask2str(buf, bt->act_mask);
1772 	else if (attr == &dev_attr_pid)
1773 		ret = sprintf(buf, "%u\n", bt->pid);
1774 	else if (attr == &dev_attr_start_lba)
1775 		ret = sprintf(buf, "%llu\n", bt->start_lba);
1776 	else if (attr == &dev_attr_end_lba)
1777 		ret = sprintf(buf, "%llu\n", bt->end_lba);
1778 
1779 out_unlock_bdev:
1780 	mutex_unlock(&q->debugfs_mutex);
1781 	return ret;
1782 }
1783 
1784 static ssize_t sysfs_blk_trace_attr_store(struct device *dev,
1785 					  struct device_attribute *attr,
1786 					  const char *buf, size_t count)
1787 {
1788 	struct block_device *bdev = dev_to_bdev(dev);
1789 	struct request_queue *q = bdev_get_queue(bdev);
1790 	struct blk_trace *bt;
1791 	u64 value;
1792 	ssize_t ret = -EINVAL;
1793 
1794 	if (count == 0)
1795 		goto out;
1796 
1797 	if (attr == &dev_attr_act_mask) {
1798 		if (kstrtoull(buf, 0, &value)) {
1799 			/* Assume it is a list of trace category names */
1800 			ret = blk_trace_str2mask(buf);
1801 			if (ret < 0)
1802 				goto out;
1803 			value = ret;
1804 		}
1805 	} else {
1806 		if (kstrtoull(buf, 0, &value))
1807 			goto out;
1808 	}
1809 
1810 	mutex_lock(&q->debugfs_mutex);
1811 
1812 	bt = rcu_dereference_protected(q->blk_trace,
1813 				       lockdep_is_held(&q->debugfs_mutex));
1814 	if (attr == &dev_attr_enable) {
1815 		if (!!value == !!bt) {
1816 			ret = 0;
1817 			goto out_unlock_bdev;
1818 		}
1819 		if (value)
1820 			ret = blk_trace_setup_queue(q, bdev);
1821 		else
1822 			ret = blk_trace_remove_queue(q);
1823 		goto out_unlock_bdev;
1824 	}
1825 
1826 	ret = 0;
1827 	if (bt == NULL) {
1828 		ret = blk_trace_setup_queue(q, bdev);
1829 		bt = rcu_dereference_protected(q->blk_trace,
1830 				lockdep_is_held(&q->debugfs_mutex));
1831 	}
1832 
1833 	if (ret == 0) {
1834 		if (attr == &dev_attr_act_mask)
1835 			bt->act_mask = value;
1836 		else if (attr == &dev_attr_pid)
1837 			bt->pid = value;
1838 		else if (attr == &dev_attr_start_lba)
1839 			bt->start_lba = value;
1840 		else if (attr == &dev_attr_end_lba)
1841 			bt->end_lba = value;
1842 	}
1843 
1844 out_unlock_bdev:
1845 	mutex_unlock(&q->debugfs_mutex);
1846 out:
1847 	return ret ? ret : count;
1848 }
1849 #endif /* CONFIG_BLK_DEV_IO_TRACE */
1850 
1851 #ifdef CONFIG_EVENT_TRACING
1852 
1853 /**
1854  * blk_fill_rwbs - Fill the buffer rwbs by mapping op to character string.
1855  * @rwbs:	buffer to be filled
1856  * @opf:	request operation type (REQ_OP_XXX) and flags for the tracepoint
1857  *
1858  * Description:
1859  *     Maps each request operation and flag to a single character and fills the
1860  *     buffer provided by the caller with resulting string.
1861  *
1862  **/
1863 void blk_fill_rwbs(char *rwbs, blk_opf_t opf)
1864 {
1865 	int i = 0;
1866 
1867 	if (opf & REQ_PREFLUSH)
1868 		rwbs[i++] = 'F';
1869 
1870 	switch (opf & REQ_OP_MASK) {
1871 	case REQ_OP_WRITE:
1872 		rwbs[i++] = 'W';
1873 		break;
1874 	case REQ_OP_DISCARD:
1875 		rwbs[i++] = 'D';
1876 		break;
1877 	case REQ_OP_SECURE_ERASE:
1878 		rwbs[i++] = 'D';
1879 		rwbs[i++] = 'E';
1880 		break;
1881 	case REQ_OP_FLUSH:
1882 		rwbs[i++] = 'F';
1883 		break;
1884 	case REQ_OP_READ:
1885 		rwbs[i++] = 'R';
1886 		break;
1887 	default:
1888 		rwbs[i++] = 'N';
1889 	}
1890 
1891 	if (opf & REQ_FUA)
1892 		rwbs[i++] = 'F';
1893 	if (opf & REQ_RAHEAD)
1894 		rwbs[i++] = 'A';
1895 	if (opf & REQ_SYNC)
1896 		rwbs[i++] = 'S';
1897 	if (opf & REQ_META)
1898 		rwbs[i++] = 'M';
1899 
1900 	rwbs[i] = '\0';
1901 }
1902 EXPORT_SYMBOL_GPL(blk_fill_rwbs);
1903 
1904 #endif /* CONFIG_EVENT_TRACING */
1905 
1906