xref: /linux-6.15/kernel/trace/blktrace.c (revision b769a2f4)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (C) 2006 Jens Axboe <[email protected]>
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 	return ret;
644 }
645 EXPORT_SYMBOL_GPL(blk_trace_setup);
646 
647 #if defined(CONFIG_COMPAT) && defined(CONFIG_X86_64)
648 static int compat_blk_trace_setup(struct request_queue *q, char *name,
649 				  dev_t dev, struct block_device *bdev,
650 				  char __user *arg)
651 {
652 	struct blk_user_trace_setup buts;
653 	struct compat_blk_user_trace_setup cbuts;
654 	int ret;
655 
656 	if (copy_from_user(&cbuts, arg, sizeof(cbuts)))
657 		return -EFAULT;
658 
659 	buts = (struct blk_user_trace_setup) {
660 		.act_mask = cbuts.act_mask,
661 		.buf_size = cbuts.buf_size,
662 		.buf_nr = cbuts.buf_nr,
663 		.start_lba = cbuts.start_lba,
664 		.end_lba = cbuts.end_lba,
665 		.pid = cbuts.pid,
666 	};
667 
668 	mutex_lock(&q->debugfs_mutex);
669 	ret = do_blk_trace_setup(q, name, dev, bdev, &buts);
670 	mutex_unlock(&q->debugfs_mutex);
671 	if (ret)
672 		return ret;
673 
674 	if (copy_to_user(arg, &buts.name, ARRAY_SIZE(buts.name))) {
675 		blk_trace_remove(q);
676 		return -EFAULT;
677 	}
678 
679 	return 0;
680 }
681 #endif
682 
683 static int __blk_trace_startstop(struct request_queue *q, int start)
684 {
685 	struct blk_trace *bt;
686 
687 	bt = rcu_dereference_protected(q->blk_trace,
688 				       lockdep_is_held(&q->debugfs_mutex));
689 	if (bt == NULL)
690 		return -EINVAL;
691 
692 	if (start)
693 		return blk_trace_start(bt);
694 	else
695 		return blk_trace_stop(bt);
696 }
697 
698 int blk_trace_startstop(struct request_queue *q, int start)
699 {
700 	int ret;
701 
702 	mutex_lock(&q->debugfs_mutex);
703 	ret = __blk_trace_startstop(q, start);
704 	mutex_unlock(&q->debugfs_mutex);
705 
706 	return ret;
707 }
708 EXPORT_SYMBOL_GPL(blk_trace_startstop);
709 
710 /*
711  * When reading or writing the blktrace sysfs files, the references to the
712  * opened sysfs or device files should prevent the underlying block device
713  * from being removed. So no further delete protection is really needed.
714  */
715 
716 /**
717  * blk_trace_ioctl - handle the ioctls associated with tracing
718  * @bdev:	the block device
719  * @cmd:	the ioctl cmd
720  * @arg:	the argument data, if any
721  *
722  **/
723 int blk_trace_ioctl(struct block_device *bdev, unsigned cmd, char __user *arg)
724 {
725 	struct request_queue *q = bdev_get_queue(bdev);
726 	int ret, start = 0;
727 	char b[BDEVNAME_SIZE];
728 
729 	switch (cmd) {
730 	case BLKTRACESETUP:
731 		snprintf(b, sizeof(b), "%pg", bdev);
732 		ret = blk_trace_setup(q, b, bdev->bd_dev, bdev, arg);
733 		break;
734 #if defined(CONFIG_COMPAT) && defined(CONFIG_X86_64)
735 	case BLKTRACESETUP32:
736 		snprintf(b, sizeof(b), "%pg", bdev);
737 		ret = compat_blk_trace_setup(q, b, bdev->bd_dev, bdev, arg);
738 		break;
739 #endif
740 	case BLKTRACESTART:
741 		start = 1;
742 		fallthrough;
743 	case BLKTRACESTOP:
744 		ret = blk_trace_startstop(q, start);
745 		break;
746 	case BLKTRACETEARDOWN:
747 		ret = blk_trace_remove(q);
748 		break;
749 	default:
750 		ret = -ENOTTY;
751 		break;
752 	}
753 	return ret;
754 }
755 
756 /**
757  * blk_trace_shutdown - stop and cleanup trace structures
758  * @q:    the request queue associated with the device
759  *
760  **/
761 void blk_trace_shutdown(struct request_queue *q)
762 {
763 	if (rcu_dereference_protected(q->blk_trace,
764 				      lockdep_is_held(&q->debugfs_mutex)))
765 		__blk_trace_remove(q);
766 }
767 
768 #ifdef CONFIG_BLK_CGROUP
769 static u64 blk_trace_bio_get_cgid(struct request_queue *q, struct bio *bio)
770 {
771 	struct cgroup_subsys_state *blkcg_css;
772 	struct blk_trace *bt;
773 
774 	/* We don't use the 'bt' value here except as an optimization... */
775 	bt = rcu_dereference_protected(q->blk_trace, 1);
776 	if (!bt || !(blk_tracer_flags.val & TRACE_BLK_OPT_CGROUP))
777 		return 0;
778 
779 	blkcg_css = bio_blkcg_css(bio);
780 	if (!blkcg_css)
781 		return 0;
782 	return cgroup_id(blkcg_css->cgroup);
783 }
784 #else
785 static u64 blk_trace_bio_get_cgid(struct request_queue *q, struct bio *bio)
786 {
787 	return 0;
788 }
789 #endif
790 
791 static u64
792 blk_trace_request_get_cgid(struct request *rq)
793 {
794 	if (!rq->bio)
795 		return 0;
796 	/* Use the first bio */
797 	return blk_trace_bio_get_cgid(rq->q, rq->bio);
798 }
799 
800 /*
801  * blktrace probes
802  */
803 
804 /**
805  * blk_add_trace_rq - Add a trace for a request oriented action
806  * @rq:		the source request
807  * @error:	return status to log
808  * @nr_bytes:	number of completed bytes
809  * @what:	the action
810  * @cgid:	the cgroup info
811  *
812  * Description:
813  *     Records an action against a request. Will log the bio offset + size.
814  *
815  **/
816 static void blk_add_trace_rq(struct request *rq, blk_status_t error,
817 			     unsigned int nr_bytes, u32 what, u64 cgid)
818 {
819 	struct blk_trace *bt;
820 
821 	rcu_read_lock();
822 	bt = rcu_dereference(rq->q->blk_trace);
823 	if (likely(!bt)) {
824 		rcu_read_unlock();
825 		return;
826 	}
827 
828 	if (blk_rq_is_passthrough(rq))
829 		what |= BLK_TC_ACT(BLK_TC_PC);
830 	else
831 		what |= BLK_TC_ACT(BLK_TC_FS);
832 
833 	__blk_add_trace(bt, blk_rq_trace_sector(rq), nr_bytes, rq->cmd_flags,
834 			what, blk_status_to_errno(error), 0, NULL, cgid);
835 	rcu_read_unlock();
836 }
837 
838 static void blk_add_trace_rq_insert(void *ignore, struct request *rq)
839 {
840 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_INSERT,
841 			 blk_trace_request_get_cgid(rq));
842 }
843 
844 static void blk_add_trace_rq_issue(void *ignore, struct request *rq)
845 {
846 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_ISSUE,
847 			 blk_trace_request_get_cgid(rq));
848 }
849 
850 static void blk_add_trace_rq_merge(void *ignore, struct request *rq)
851 {
852 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_BACKMERGE,
853 			 blk_trace_request_get_cgid(rq));
854 }
855 
856 static void blk_add_trace_rq_requeue(void *ignore, struct request *rq)
857 {
858 	blk_add_trace_rq(rq, 0, blk_rq_bytes(rq), BLK_TA_REQUEUE,
859 			 blk_trace_request_get_cgid(rq));
860 }
861 
862 static void blk_add_trace_rq_complete(void *ignore, struct request *rq,
863 			blk_status_t error, unsigned int nr_bytes)
864 {
865 	blk_add_trace_rq(rq, error, nr_bytes, BLK_TA_COMPLETE,
866 			 blk_trace_request_get_cgid(rq));
867 }
868 
869 /**
870  * blk_add_trace_bio - Add a trace for a bio oriented action
871  * @q:		queue the io is for
872  * @bio:	the source bio
873  * @what:	the action
874  * @error:	error, if any
875  *
876  * Description:
877  *     Records an action against a bio. Will log the bio offset + size.
878  *
879  **/
880 static void blk_add_trace_bio(struct request_queue *q, struct bio *bio,
881 			      u32 what, int error)
882 {
883 	struct blk_trace *bt;
884 
885 	rcu_read_lock();
886 	bt = rcu_dereference(q->blk_trace);
887 	if (likely(!bt)) {
888 		rcu_read_unlock();
889 		return;
890 	}
891 
892 	__blk_add_trace(bt, bio->bi_iter.bi_sector, bio->bi_iter.bi_size,
893 			bio->bi_opf, what, error, 0, NULL,
894 			blk_trace_bio_get_cgid(q, bio));
895 	rcu_read_unlock();
896 }
897 
898 static void blk_add_trace_bio_bounce(void *ignore, struct bio *bio)
899 {
900 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_BOUNCE, 0);
901 }
902 
903 static void blk_add_trace_bio_complete(void *ignore,
904 				       struct request_queue *q, struct bio *bio)
905 {
906 	blk_add_trace_bio(q, bio, BLK_TA_COMPLETE,
907 			  blk_status_to_errno(bio->bi_status));
908 }
909 
910 static void blk_add_trace_bio_backmerge(void *ignore, struct bio *bio)
911 {
912 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_BACKMERGE,
913 			0);
914 }
915 
916 static void blk_add_trace_bio_frontmerge(void *ignore, struct bio *bio)
917 {
918 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_FRONTMERGE,
919 			0);
920 }
921 
922 static void blk_add_trace_bio_queue(void *ignore, struct bio *bio)
923 {
924 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_QUEUE, 0);
925 }
926 
927 static void blk_add_trace_getrq(void *ignore, struct bio *bio)
928 {
929 	blk_add_trace_bio(bio->bi_bdev->bd_disk->queue, bio, BLK_TA_GETRQ, 0);
930 }
931 
932 static void blk_add_trace_plug(void *ignore, struct request_queue *q)
933 {
934 	struct blk_trace *bt;
935 
936 	rcu_read_lock();
937 	bt = rcu_dereference(q->blk_trace);
938 	if (bt)
939 		__blk_add_trace(bt, 0, 0, 0, BLK_TA_PLUG, 0, 0, NULL, 0);
940 	rcu_read_unlock();
941 }
942 
943 static void blk_add_trace_unplug(void *ignore, struct request_queue *q,
944 				    unsigned int depth, bool explicit)
945 {
946 	struct blk_trace *bt;
947 
948 	rcu_read_lock();
949 	bt = rcu_dereference(q->blk_trace);
950 	if (bt) {
951 		__be64 rpdu = cpu_to_be64(depth);
952 		u32 what;
953 
954 		if (explicit)
955 			what = BLK_TA_UNPLUG_IO;
956 		else
957 			what = BLK_TA_UNPLUG_TIMER;
958 
959 		__blk_add_trace(bt, 0, 0, 0, what, 0, sizeof(rpdu), &rpdu, 0);
960 	}
961 	rcu_read_unlock();
962 }
963 
964 static void blk_add_trace_split(void *ignore, struct bio *bio, unsigned int pdu)
965 {
966 	struct request_queue *q = bio->bi_bdev->bd_disk->queue;
967 	struct blk_trace *bt;
968 
969 	rcu_read_lock();
970 	bt = rcu_dereference(q->blk_trace);
971 	if (bt) {
972 		__be64 rpdu = cpu_to_be64(pdu);
973 
974 		__blk_add_trace(bt, bio->bi_iter.bi_sector,
975 				bio->bi_iter.bi_size, bio->bi_opf, BLK_TA_SPLIT,
976 				blk_status_to_errno(bio->bi_status),
977 				sizeof(rpdu), &rpdu,
978 				blk_trace_bio_get_cgid(q, bio));
979 	}
980 	rcu_read_unlock();
981 }
982 
983 /**
984  * blk_add_trace_bio_remap - Add a trace for a bio-remap operation
985  * @ignore:	trace callback data parameter (not used)
986  * @bio:	the source bio
987  * @dev:	source device
988  * @from:	source sector
989  *
990  * Called after a bio is remapped to a different device and/or sector.
991  **/
992 static void blk_add_trace_bio_remap(void *ignore, struct bio *bio, dev_t dev,
993 				    sector_t from)
994 {
995 	struct request_queue *q = bio->bi_bdev->bd_disk->queue;
996 	struct blk_trace *bt;
997 	struct blk_io_trace_remap r;
998 
999 	rcu_read_lock();
1000 	bt = rcu_dereference(q->blk_trace);
1001 	if (likely(!bt)) {
1002 		rcu_read_unlock();
1003 		return;
1004 	}
1005 
1006 	r.device_from = cpu_to_be32(dev);
1007 	r.device_to   = cpu_to_be32(bio_dev(bio));
1008 	r.sector_from = cpu_to_be64(from);
1009 
1010 	__blk_add_trace(bt, bio->bi_iter.bi_sector, bio->bi_iter.bi_size,
1011 			bio->bi_opf, BLK_TA_REMAP,
1012 			blk_status_to_errno(bio->bi_status),
1013 			sizeof(r), &r, blk_trace_bio_get_cgid(q, bio));
1014 	rcu_read_unlock();
1015 }
1016 
1017 /**
1018  * blk_add_trace_rq_remap - Add a trace for a request-remap operation
1019  * @ignore:	trace callback data parameter (not used)
1020  * @rq:		the source request
1021  * @dev:	target device
1022  * @from:	source sector
1023  *
1024  * Description:
1025  *     Device mapper remaps request to other devices.
1026  *     Add a trace for that action.
1027  *
1028  **/
1029 static void blk_add_trace_rq_remap(void *ignore, struct request *rq, dev_t dev,
1030 				   sector_t from)
1031 {
1032 	struct blk_trace *bt;
1033 	struct blk_io_trace_remap r;
1034 
1035 	rcu_read_lock();
1036 	bt = rcu_dereference(rq->q->blk_trace);
1037 	if (likely(!bt)) {
1038 		rcu_read_unlock();
1039 		return;
1040 	}
1041 
1042 	r.device_from = cpu_to_be32(dev);
1043 	r.device_to   = cpu_to_be32(disk_devt(rq->q->disk));
1044 	r.sector_from = cpu_to_be64(from);
1045 
1046 	__blk_add_trace(bt, blk_rq_pos(rq), blk_rq_bytes(rq),
1047 			rq->cmd_flags, BLK_TA_REMAP, 0,
1048 			sizeof(r), &r, blk_trace_request_get_cgid(rq));
1049 	rcu_read_unlock();
1050 }
1051 
1052 /**
1053  * blk_add_driver_data - Add binary message with driver-specific data
1054  * @rq:		io request
1055  * @data:	driver-specific data
1056  * @len:	length of driver-specific data
1057  *
1058  * Description:
1059  *     Some drivers might want to write driver-specific data per request.
1060  *
1061  **/
1062 void blk_add_driver_data(struct request *rq, void *data, size_t len)
1063 {
1064 	struct blk_trace *bt;
1065 
1066 	rcu_read_lock();
1067 	bt = rcu_dereference(rq->q->blk_trace);
1068 	if (likely(!bt)) {
1069 		rcu_read_unlock();
1070 		return;
1071 	}
1072 
1073 	__blk_add_trace(bt, blk_rq_trace_sector(rq), blk_rq_bytes(rq), 0,
1074 				BLK_TA_DRV_DATA, 0, len, data,
1075 				blk_trace_request_get_cgid(rq));
1076 	rcu_read_unlock();
1077 }
1078 EXPORT_SYMBOL_GPL(blk_add_driver_data);
1079 
1080 static void blk_register_tracepoints(void)
1081 {
1082 	int ret;
1083 
1084 	ret = register_trace_block_rq_insert(blk_add_trace_rq_insert, NULL);
1085 	WARN_ON(ret);
1086 	ret = register_trace_block_rq_issue(blk_add_trace_rq_issue, NULL);
1087 	WARN_ON(ret);
1088 	ret = register_trace_block_rq_merge(blk_add_trace_rq_merge, NULL);
1089 	WARN_ON(ret);
1090 	ret = register_trace_block_rq_requeue(blk_add_trace_rq_requeue, NULL);
1091 	WARN_ON(ret);
1092 	ret = register_trace_block_rq_complete(blk_add_trace_rq_complete, NULL);
1093 	WARN_ON(ret);
1094 	ret = register_trace_block_bio_bounce(blk_add_trace_bio_bounce, NULL);
1095 	WARN_ON(ret);
1096 	ret = register_trace_block_bio_complete(blk_add_trace_bio_complete, NULL);
1097 	WARN_ON(ret);
1098 	ret = register_trace_block_bio_backmerge(blk_add_trace_bio_backmerge, NULL);
1099 	WARN_ON(ret);
1100 	ret = register_trace_block_bio_frontmerge(blk_add_trace_bio_frontmerge, NULL);
1101 	WARN_ON(ret);
1102 	ret = register_trace_block_bio_queue(blk_add_trace_bio_queue, NULL);
1103 	WARN_ON(ret);
1104 	ret = register_trace_block_getrq(blk_add_trace_getrq, NULL);
1105 	WARN_ON(ret);
1106 	ret = register_trace_block_plug(blk_add_trace_plug, NULL);
1107 	WARN_ON(ret);
1108 	ret = register_trace_block_unplug(blk_add_trace_unplug, NULL);
1109 	WARN_ON(ret);
1110 	ret = register_trace_block_split(blk_add_trace_split, NULL);
1111 	WARN_ON(ret);
1112 	ret = register_trace_block_bio_remap(blk_add_trace_bio_remap, NULL);
1113 	WARN_ON(ret);
1114 	ret = register_trace_block_rq_remap(blk_add_trace_rq_remap, NULL);
1115 	WARN_ON(ret);
1116 }
1117 
1118 static void blk_unregister_tracepoints(void)
1119 {
1120 	unregister_trace_block_rq_remap(blk_add_trace_rq_remap, NULL);
1121 	unregister_trace_block_bio_remap(blk_add_trace_bio_remap, NULL);
1122 	unregister_trace_block_split(blk_add_trace_split, NULL);
1123 	unregister_trace_block_unplug(blk_add_trace_unplug, NULL);
1124 	unregister_trace_block_plug(blk_add_trace_plug, NULL);
1125 	unregister_trace_block_getrq(blk_add_trace_getrq, NULL);
1126 	unregister_trace_block_bio_queue(blk_add_trace_bio_queue, NULL);
1127 	unregister_trace_block_bio_frontmerge(blk_add_trace_bio_frontmerge, NULL);
1128 	unregister_trace_block_bio_backmerge(blk_add_trace_bio_backmerge, NULL);
1129 	unregister_trace_block_bio_complete(blk_add_trace_bio_complete, NULL);
1130 	unregister_trace_block_bio_bounce(blk_add_trace_bio_bounce, NULL);
1131 	unregister_trace_block_rq_complete(blk_add_trace_rq_complete, NULL);
1132 	unregister_trace_block_rq_requeue(blk_add_trace_rq_requeue, NULL);
1133 	unregister_trace_block_rq_merge(blk_add_trace_rq_merge, NULL);
1134 	unregister_trace_block_rq_issue(blk_add_trace_rq_issue, NULL);
1135 	unregister_trace_block_rq_insert(blk_add_trace_rq_insert, NULL);
1136 
1137 	tracepoint_synchronize_unregister();
1138 }
1139 
1140 /*
1141  * struct blk_io_tracer formatting routines
1142  */
1143 
1144 static void fill_rwbs(char *rwbs, const struct blk_io_trace *t)
1145 {
1146 	int i = 0;
1147 	int tc = t->action >> BLK_TC_SHIFT;
1148 
1149 	if ((t->action & ~__BLK_TN_CGROUP) == BLK_TN_MESSAGE) {
1150 		rwbs[i++] = 'N';
1151 		goto out;
1152 	}
1153 
1154 	if (tc & BLK_TC_FLUSH)
1155 		rwbs[i++] = 'F';
1156 
1157 	if (tc & BLK_TC_DISCARD)
1158 		rwbs[i++] = 'D';
1159 	else if (tc & BLK_TC_WRITE)
1160 		rwbs[i++] = 'W';
1161 	else if (t->bytes)
1162 		rwbs[i++] = 'R';
1163 	else
1164 		rwbs[i++] = 'N';
1165 
1166 	if (tc & BLK_TC_FUA)
1167 		rwbs[i++] = 'F';
1168 	if (tc & BLK_TC_AHEAD)
1169 		rwbs[i++] = 'A';
1170 	if (tc & BLK_TC_SYNC)
1171 		rwbs[i++] = 'S';
1172 	if (tc & BLK_TC_META)
1173 		rwbs[i++] = 'M';
1174 out:
1175 	rwbs[i] = '\0';
1176 }
1177 
1178 static inline
1179 const struct blk_io_trace *te_blk_io_trace(const struct trace_entry *ent)
1180 {
1181 	return (const struct blk_io_trace *)ent;
1182 }
1183 
1184 static inline const void *pdu_start(const struct trace_entry *ent, bool has_cg)
1185 {
1186 	return (void *)(te_blk_io_trace(ent) + 1) + (has_cg ? sizeof(u64) : 0);
1187 }
1188 
1189 static inline u64 t_cgid(const struct trace_entry *ent)
1190 {
1191 	return *(u64 *)(te_blk_io_trace(ent) + 1);
1192 }
1193 
1194 static inline int pdu_real_len(const struct trace_entry *ent, bool has_cg)
1195 {
1196 	return te_blk_io_trace(ent)->pdu_len - (has_cg ? sizeof(u64) : 0);
1197 }
1198 
1199 static inline u32 t_action(const struct trace_entry *ent)
1200 {
1201 	return te_blk_io_trace(ent)->action;
1202 }
1203 
1204 static inline u32 t_bytes(const struct trace_entry *ent)
1205 {
1206 	return te_blk_io_trace(ent)->bytes;
1207 }
1208 
1209 static inline u32 t_sec(const struct trace_entry *ent)
1210 {
1211 	return te_blk_io_trace(ent)->bytes >> 9;
1212 }
1213 
1214 static inline unsigned long long t_sector(const struct trace_entry *ent)
1215 {
1216 	return te_blk_io_trace(ent)->sector;
1217 }
1218 
1219 static inline __u16 t_error(const struct trace_entry *ent)
1220 {
1221 	return te_blk_io_trace(ent)->error;
1222 }
1223 
1224 static __u64 get_pdu_int(const struct trace_entry *ent, bool has_cg)
1225 {
1226 	const __be64 *val = pdu_start(ent, has_cg);
1227 	return be64_to_cpu(*val);
1228 }
1229 
1230 typedef void (blk_log_action_t) (struct trace_iterator *iter, const char *act,
1231 	bool has_cg);
1232 
1233 static void blk_log_action_classic(struct trace_iterator *iter, const char *act,
1234 	bool has_cg)
1235 {
1236 	char rwbs[RWBS_LEN];
1237 	unsigned long long ts  = iter->ts;
1238 	unsigned long nsec_rem = do_div(ts, NSEC_PER_SEC);
1239 	unsigned secs	       = (unsigned long)ts;
1240 	const struct blk_io_trace *t = te_blk_io_trace(iter->ent);
1241 
1242 	fill_rwbs(rwbs, t);
1243 
1244 	trace_seq_printf(&iter->seq,
1245 			 "%3d,%-3d %2d %5d.%09lu %5u %2s %3s ",
1246 			 MAJOR(t->device), MINOR(t->device), iter->cpu,
1247 			 secs, nsec_rem, iter->ent->pid, act, rwbs);
1248 }
1249 
1250 static void blk_log_action(struct trace_iterator *iter, const char *act,
1251 	bool has_cg)
1252 {
1253 	char rwbs[RWBS_LEN];
1254 	const struct blk_io_trace *t = te_blk_io_trace(iter->ent);
1255 
1256 	fill_rwbs(rwbs, t);
1257 	if (has_cg) {
1258 		u64 id = t_cgid(iter->ent);
1259 
1260 		if (blk_tracer_flags.val & TRACE_BLK_OPT_CGNAME) {
1261 			char blkcg_name_buf[NAME_MAX + 1] = "<...>";
1262 
1263 			cgroup_path_from_kernfs_id(id, blkcg_name_buf,
1264 				sizeof(blkcg_name_buf));
1265 			trace_seq_printf(&iter->seq, "%3d,%-3d %s %2s %3s ",
1266 				 MAJOR(t->device), MINOR(t->device),
1267 				 blkcg_name_buf, act, rwbs);
1268 		} else {
1269 			/*
1270 			 * The cgid portion used to be "INO,GEN".  Userland
1271 			 * builds a FILEID_INO32_GEN fid out of them and
1272 			 * opens the cgroup using open_by_handle_at(2).
1273 			 * While 32bit ino setups are still the same, 64bit
1274 			 * ones now use the 64bit ino as the whole ID and
1275 			 * no longer use generation.
1276 			 *
1277 			 * Regardless of the content, always output
1278 			 * "LOW32,HIGH32" so that FILEID_INO32_GEN fid can
1279 			 * be mapped back to @id on both 64 and 32bit ino
1280 			 * setups.  See __kernfs_fh_to_dentry().
1281 			 */
1282 			trace_seq_printf(&iter->seq,
1283 				 "%3d,%-3d %llx,%-llx %2s %3s ",
1284 				 MAJOR(t->device), MINOR(t->device),
1285 				 id & U32_MAX, id >> 32, act, rwbs);
1286 		}
1287 	} else
1288 		trace_seq_printf(&iter->seq, "%3d,%-3d %2s %3s ",
1289 				 MAJOR(t->device), MINOR(t->device), act, rwbs);
1290 }
1291 
1292 static void blk_log_dump_pdu(struct trace_seq *s,
1293 	const struct trace_entry *ent, bool has_cg)
1294 {
1295 	const unsigned char *pdu_buf;
1296 	int pdu_len;
1297 	int i, end;
1298 
1299 	pdu_buf = pdu_start(ent, has_cg);
1300 	pdu_len = pdu_real_len(ent, has_cg);
1301 
1302 	if (!pdu_len)
1303 		return;
1304 
1305 	/* find the last zero that needs to be printed */
1306 	for (end = pdu_len - 1; end >= 0; end--)
1307 		if (pdu_buf[end])
1308 			break;
1309 	end++;
1310 
1311 	trace_seq_putc(s, '(');
1312 
1313 	for (i = 0; i < pdu_len; i++) {
1314 
1315 		trace_seq_printf(s, "%s%02x",
1316 				 i == 0 ? "" : " ", pdu_buf[i]);
1317 
1318 		/*
1319 		 * stop when the rest is just zeros and indicate so
1320 		 * with a ".." appended
1321 		 */
1322 		if (i == end && end != pdu_len - 1) {
1323 			trace_seq_puts(s, " ..) ");
1324 			return;
1325 		}
1326 	}
1327 
1328 	trace_seq_puts(s, ") ");
1329 }
1330 
1331 static void blk_log_generic(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1332 {
1333 	char cmd[TASK_COMM_LEN];
1334 
1335 	trace_find_cmdline(ent->pid, cmd);
1336 
1337 	if (t_action(ent) & BLK_TC_ACT(BLK_TC_PC)) {
1338 		trace_seq_printf(s, "%u ", t_bytes(ent));
1339 		blk_log_dump_pdu(s, ent, has_cg);
1340 		trace_seq_printf(s, "[%s]\n", cmd);
1341 	} else {
1342 		if (t_sec(ent))
1343 			trace_seq_printf(s, "%llu + %u [%s]\n",
1344 						t_sector(ent), t_sec(ent), cmd);
1345 		else
1346 			trace_seq_printf(s, "[%s]\n", cmd);
1347 	}
1348 }
1349 
1350 static void blk_log_with_error(struct trace_seq *s,
1351 			      const struct trace_entry *ent, bool has_cg)
1352 {
1353 	if (t_action(ent) & BLK_TC_ACT(BLK_TC_PC)) {
1354 		blk_log_dump_pdu(s, ent, has_cg);
1355 		trace_seq_printf(s, "[%d]\n", t_error(ent));
1356 	} else {
1357 		if (t_sec(ent))
1358 			trace_seq_printf(s, "%llu + %u [%d]\n",
1359 					 t_sector(ent),
1360 					 t_sec(ent), t_error(ent));
1361 		else
1362 			trace_seq_printf(s, "%llu [%d]\n",
1363 					 t_sector(ent), t_error(ent));
1364 	}
1365 }
1366 
1367 static void blk_log_remap(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1368 {
1369 	const struct blk_io_trace_remap *__r = pdu_start(ent, has_cg);
1370 
1371 	trace_seq_printf(s, "%llu + %u <- (%d,%d) %llu\n",
1372 			 t_sector(ent), t_sec(ent),
1373 			 MAJOR(be32_to_cpu(__r->device_from)),
1374 			 MINOR(be32_to_cpu(__r->device_from)),
1375 			 be64_to_cpu(__r->sector_from));
1376 }
1377 
1378 static void blk_log_plug(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1379 {
1380 	char cmd[TASK_COMM_LEN];
1381 
1382 	trace_find_cmdline(ent->pid, cmd);
1383 
1384 	trace_seq_printf(s, "[%s]\n", cmd);
1385 }
1386 
1387 static void blk_log_unplug(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1388 {
1389 	char cmd[TASK_COMM_LEN];
1390 
1391 	trace_find_cmdline(ent->pid, cmd);
1392 
1393 	trace_seq_printf(s, "[%s] %llu\n", cmd, get_pdu_int(ent, has_cg));
1394 }
1395 
1396 static void blk_log_split(struct trace_seq *s, const struct trace_entry *ent, bool has_cg)
1397 {
1398 	char cmd[TASK_COMM_LEN];
1399 
1400 	trace_find_cmdline(ent->pid, cmd);
1401 
1402 	trace_seq_printf(s, "%llu / %llu [%s]\n", t_sector(ent),
1403 			 get_pdu_int(ent, has_cg), cmd);
1404 }
1405 
1406 static void blk_log_msg(struct trace_seq *s, const struct trace_entry *ent,
1407 			bool has_cg)
1408 {
1409 
1410 	trace_seq_putmem(s, pdu_start(ent, has_cg),
1411 		pdu_real_len(ent, has_cg));
1412 	trace_seq_putc(s, '\n');
1413 }
1414 
1415 /*
1416  * struct tracer operations
1417  */
1418 
1419 static void blk_tracer_print_header(struct seq_file *m)
1420 {
1421 	if (!(blk_tracer_flags.val & TRACE_BLK_OPT_CLASSIC))
1422 		return;
1423 	seq_puts(m, "# DEV   CPU TIMESTAMP     PID ACT FLG\n"
1424 		    "#  |     |     |           |   |   |\n");
1425 }
1426 
1427 static void blk_tracer_start(struct trace_array *tr)
1428 {
1429 	blk_tracer_enabled = true;
1430 }
1431 
1432 static int blk_tracer_init(struct trace_array *tr)
1433 {
1434 	blk_tr = tr;
1435 	blk_tracer_start(tr);
1436 	return 0;
1437 }
1438 
1439 static void blk_tracer_stop(struct trace_array *tr)
1440 {
1441 	blk_tracer_enabled = false;
1442 }
1443 
1444 static void blk_tracer_reset(struct trace_array *tr)
1445 {
1446 	blk_tracer_stop(tr);
1447 }
1448 
1449 static const struct {
1450 	const char *act[2];
1451 	void	   (*print)(struct trace_seq *s, const struct trace_entry *ent,
1452 			    bool has_cg);
1453 } what2act[] = {
1454 	[__BLK_TA_QUEUE]	= {{  "Q", "queue" },	   blk_log_generic },
1455 	[__BLK_TA_BACKMERGE]	= {{  "M", "backmerge" },  blk_log_generic },
1456 	[__BLK_TA_FRONTMERGE]	= {{  "F", "frontmerge" }, blk_log_generic },
1457 	[__BLK_TA_GETRQ]	= {{  "G", "getrq" },	   blk_log_generic },
1458 	[__BLK_TA_SLEEPRQ]	= {{  "S", "sleeprq" },	   blk_log_generic },
1459 	[__BLK_TA_REQUEUE]	= {{  "R", "requeue" },	   blk_log_with_error },
1460 	[__BLK_TA_ISSUE]	= {{  "D", "issue" },	   blk_log_generic },
1461 	[__BLK_TA_COMPLETE]	= {{  "C", "complete" },   blk_log_with_error },
1462 	[__BLK_TA_PLUG]		= {{  "P", "plug" },	   blk_log_plug },
1463 	[__BLK_TA_UNPLUG_IO]	= {{  "U", "unplug_io" },  blk_log_unplug },
1464 	[__BLK_TA_UNPLUG_TIMER]	= {{ "UT", "unplug_timer" }, blk_log_unplug },
1465 	[__BLK_TA_INSERT]	= {{  "I", "insert" },	   blk_log_generic },
1466 	[__BLK_TA_SPLIT]	= {{  "X", "split" },	   blk_log_split },
1467 	[__BLK_TA_BOUNCE]	= {{  "B", "bounce" },	   blk_log_generic },
1468 	[__BLK_TA_REMAP]	= {{  "A", "remap" },	   blk_log_remap },
1469 };
1470 
1471 static enum print_line_t print_one_line(struct trace_iterator *iter,
1472 					bool classic)
1473 {
1474 	struct trace_array *tr = iter->tr;
1475 	struct trace_seq *s = &iter->seq;
1476 	const struct blk_io_trace *t;
1477 	u16 what;
1478 	bool long_act;
1479 	blk_log_action_t *log_action;
1480 	bool has_cg;
1481 
1482 	t	   = te_blk_io_trace(iter->ent);
1483 	what	   = (t->action & ((1 << BLK_TC_SHIFT) - 1)) & ~__BLK_TA_CGROUP;
1484 	long_act   = !!(tr->trace_flags & TRACE_ITER_VERBOSE);
1485 	log_action = classic ? &blk_log_action_classic : &blk_log_action;
1486 	has_cg	   = t->action & __BLK_TA_CGROUP;
1487 
1488 	if ((t->action & ~__BLK_TN_CGROUP) == BLK_TN_MESSAGE) {
1489 		log_action(iter, long_act ? "message" : "m", has_cg);
1490 		blk_log_msg(s, iter->ent, has_cg);
1491 		return trace_handle_return(s);
1492 	}
1493 
1494 	if (unlikely(what == 0 || what >= ARRAY_SIZE(what2act)))
1495 		trace_seq_printf(s, "Unknown action %x\n", what);
1496 	else {
1497 		log_action(iter, what2act[what].act[long_act], has_cg);
1498 		what2act[what].print(s, iter->ent, has_cg);
1499 	}
1500 
1501 	return trace_handle_return(s);
1502 }
1503 
1504 static enum print_line_t blk_trace_event_print(struct trace_iterator *iter,
1505 					       int flags, struct trace_event *event)
1506 {
1507 	return print_one_line(iter, false);
1508 }
1509 
1510 static void blk_trace_synthesize_old_trace(struct trace_iterator *iter)
1511 {
1512 	struct trace_seq *s = &iter->seq;
1513 	struct blk_io_trace *t = (struct blk_io_trace *)iter->ent;
1514 	const int offset = offsetof(struct blk_io_trace, sector);
1515 	struct blk_io_trace old = {
1516 		.magic	  = BLK_IO_TRACE_MAGIC | BLK_IO_TRACE_VERSION,
1517 		.time     = iter->ts,
1518 	};
1519 
1520 	trace_seq_putmem(s, &old, offset);
1521 	trace_seq_putmem(s, &t->sector,
1522 			 sizeof(old) - offset + t->pdu_len);
1523 }
1524 
1525 static enum print_line_t
1526 blk_trace_event_print_binary(struct trace_iterator *iter, int flags,
1527 			     struct trace_event *event)
1528 {
1529 	blk_trace_synthesize_old_trace(iter);
1530 
1531 	return trace_handle_return(&iter->seq);
1532 }
1533 
1534 static enum print_line_t blk_tracer_print_line(struct trace_iterator *iter)
1535 {
1536 	if ((iter->ent->type != TRACE_BLK) ||
1537 	    !(blk_tracer_flags.val & TRACE_BLK_OPT_CLASSIC))
1538 		return TRACE_TYPE_UNHANDLED;
1539 
1540 	return print_one_line(iter, true);
1541 }
1542 
1543 static int
1544 blk_tracer_set_flag(struct trace_array *tr, u32 old_flags, u32 bit, int set)
1545 {
1546 	/* don't output context-info for blk_classic output */
1547 	if (bit == TRACE_BLK_OPT_CLASSIC) {
1548 		if (set)
1549 			tr->trace_flags &= ~TRACE_ITER_CONTEXT_INFO;
1550 		else
1551 			tr->trace_flags |= TRACE_ITER_CONTEXT_INFO;
1552 	}
1553 	return 0;
1554 }
1555 
1556 static struct tracer blk_tracer __read_mostly = {
1557 	.name		= "blk",
1558 	.init		= blk_tracer_init,
1559 	.reset		= blk_tracer_reset,
1560 	.start		= blk_tracer_start,
1561 	.stop		= blk_tracer_stop,
1562 	.print_header	= blk_tracer_print_header,
1563 	.print_line	= blk_tracer_print_line,
1564 	.flags		= &blk_tracer_flags,
1565 	.set_flag	= blk_tracer_set_flag,
1566 };
1567 
1568 static struct trace_event_functions trace_blk_event_funcs = {
1569 	.trace		= blk_trace_event_print,
1570 	.binary		= blk_trace_event_print_binary,
1571 };
1572 
1573 static struct trace_event trace_blk_event = {
1574 	.type		= TRACE_BLK,
1575 	.funcs		= &trace_blk_event_funcs,
1576 };
1577 
1578 static int __init init_blk_tracer(void)
1579 {
1580 	if (!register_trace_event(&trace_blk_event)) {
1581 		pr_warn("Warning: could not register block events\n");
1582 		return 1;
1583 	}
1584 
1585 	if (register_tracer(&blk_tracer) != 0) {
1586 		pr_warn("Warning: could not register the block tracer\n");
1587 		unregister_trace_event(&trace_blk_event);
1588 		return 1;
1589 	}
1590 
1591 	return 0;
1592 }
1593 
1594 device_initcall(init_blk_tracer);
1595 
1596 static int blk_trace_remove_queue(struct request_queue *q)
1597 {
1598 	struct blk_trace *bt;
1599 
1600 	bt = rcu_replace_pointer(q->blk_trace, NULL,
1601 				 lockdep_is_held(&q->debugfs_mutex));
1602 	if (bt == NULL)
1603 		return -EINVAL;
1604 
1605 	blk_trace_stop(bt);
1606 
1607 	put_probe_ref();
1608 	synchronize_rcu();
1609 	blk_trace_free(q, bt);
1610 	return 0;
1611 }
1612 
1613 /*
1614  * Setup everything required to start tracing
1615  */
1616 static int blk_trace_setup_queue(struct request_queue *q,
1617 				 struct block_device *bdev)
1618 {
1619 	struct blk_trace *bt = NULL;
1620 	int ret = -ENOMEM;
1621 
1622 	bt = kzalloc(sizeof(*bt), GFP_KERNEL);
1623 	if (!bt)
1624 		return -ENOMEM;
1625 
1626 	bt->msg_data = __alloc_percpu(BLK_TN_MAX_MSG, __alignof__(char));
1627 	if (!bt->msg_data)
1628 		goto free_bt;
1629 
1630 	bt->dev = bdev->bd_dev;
1631 	bt->act_mask = (u16)-1;
1632 
1633 	blk_trace_setup_lba(bt, bdev);
1634 
1635 	rcu_assign_pointer(q->blk_trace, bt);
1636 	get_probe_ref();
1637 	return 0;
1638 
1639 free_bt:
1640 	blk_trace_free(q, bt);
1641 	return ret;
1642 }
1643 
1644 /*
1645  * sysfs interface to enable and configure tracing
1646  */
1647 
1648 static ssize_t sysfs_blk_trace_attr_show(struct device *dev,
1649 					 struct device_attribute *attr,
1650 					 char *buf);
1651 static ssize_t sysfs_blk_trace_attr_store(struct device *dev,
1652 					  struct device_attribute *attr,
1653 					  const char *buf, size_t count);
1654 #define BLK_TRACE_DEVICE_ATTR(_name) \
1655 	DEVICE_ATTR(_name, S_IRUGO | S_IWUSR, \
1656 		    sysfs_blk_trace_attr_show, \
1657 		    sysfs_blk_trace_attr_store)
1658 
1659 static BLK_TRACE_DEVICE_ATTR(enable);
1660 static BLK_TRACE_DEVICE_ATTR(act_mask);
1661 static BLK_TRACE_DEVICE_ATTR(pid);
1662 static BLK_TRACE_DEVICE_ATTR(start_lba);
1663 static BLK_TRACE_DEVICE_ATTR(end_lba);
1664 
1665 static struct attribute *blk_trace_attrs[] = {
1666 	&dev_attr_enable.attr,
1667 	&dev_attr_act_mask.attr,
1668 	&dev_attr_pid.attr,
1669 	&dev_attr_start_lba.attr,
1670 	&dev_attr_end_lba.attr,
1671 	NULL
1672 };
1673 
1674 struct attribute_group blk_trace_attr_group = {
1675 	.name  = "trace",
1676 	.attrs = blk_trace_attrs,
1677 };
1678 
1679 static const struct {
1680 	int mask;
1681 	const char *str;
1682 } mask_maps[] = {
1683 	{ BLK_TC_READ,		"read"		},
1684 	{ BLK_TC_WRITE,		"write"		},
1685 	{ BLK_TC_FLUSH,		"flush"		},
1686 	{ BLK_TC_SYNC,		"sync"		},
1687 	{ BLK_TC_QUEUE,		"queue"		},
1688 	{ BLK_TC_REQUEUE,	"requeue"	},
1689 	{ BLK_TC_ISSUE,		"issue"		},
1690 	{ BLK_TC_COMPLETE,	"complete"	},
1691 	{ BLK_TC_FS,		"fs"		},
1692 	{ BLK_TC_PC,		"pc"		},
1693 	{ BLK_TC_NOTIFY,	"notify"	},
1694 	{ BLK_TC_AHEAD,		"ahead"		},
1695 	{ BLK_TC_META,		"meta"		},
1696 	{ BLK_TC_DISCARD,	"discard"	},
1697 	{ BLK_TC_DRV_DATA,	"drv_data"	},
1698 	{ BLK_TC_FUA,		"fua"		},
1699 };
1700 
1701 static int blk_trace_str2mask(const char *str)
1702 {
1703 	int i;
1704 	int mask = 0;
1705 	char *buf, *s, *token;
1706 
1707 	buf = kstrdup(str, GFP_KERNEL);
1708 	if (buf == NULL)
1709 		return -ENOMEM;
1710 	s = strstrip(buf);
1711 
1712 	while (1) {
1713 		token = strsep(&s, ",");
1714 		if (token == NULL)
1715 			break;
1716 
1717 		if (*token == '\0')
1718 			continue;
1719 
1720 		for (i = 0; i < ARRAY_SIZE(mask_maps); i++) {
1721 			if (strcasecmp(token, mask_maps[i].str) == 0) {
1722 				mask |= mask_maps[i].mask;
1723 				break;
1724 			}
1725 		}
1726 		if (i == ARRAY_SIZE(mask_maps)) {
1727 			mask = -EINVAL;
1728 			break;
1729 		}
1730 	}
1731 	kfree(buf);
1732 
1733 	return mask;
1734 }
1735 
1736 static ssize_t blk_trace_mask2str(char *buf, int mask)
1737 {
1738 	int i;
1739 	char *p = buf;
1740 
1741 	for (i = 0; i < ARRAY_SIZE(mask_maps); i++) {
1742 		if (mask & mask_maps[i].mask) {
1743 			p += sprintf(p, "%s%s",
1744 				    (p == buf) ? "" : ",", mask_maps[i].str);
1745 		}
1746 	}
1747 	*p++ = '\n';
1748 
1749 	return p - buf;
1750 }
1751 
1752 static ssize_t sysfs_blk_trace_attr_show(struct device *dev,
1753 					 struct device_attribute *attr,
1754 					 char *buf)
1755 {
1756 	struct block_device *bdev = dev_to_bdev(dev);
1757 	struct request_queue *q = bdev_get_queue(bdev);
1758 	struct blk_trace *bt;
1759 	ssize_t ret = -ENXIO;
1760 
1761 	mutex_lock(&q->debugfs_mutex);
1762 
1763 	bt = rcu_dereference_protected(q->blk_trace,
1764 				       lockdep_is_held(&q->debugfs_mutex));
1765 	if (attr == &dev_attr_enable) {
1766 		ret = sprintf(buf, "%u\n", !!bt);
1767 		goto out_unlock_bdev;
1768 	}
1769 
1770 	if (bt == NULL)
1771 		ret = sprintf(buf, "disabled\n");
1772 	else if (attr == &dev_attr_act_mask)
1773 		ret = blk_trace_mask2str(buf, bt->act_mask);
1774 	else if (attr == &dev_attr_pid)
1775 		ret = sprintf(buf, "%u\n", bt->pid);
1776 	else if (attr == &dev_attr_start_lba)
1777 		ret = sprintf(buf, "%llu\n", bt->start_lba);
1778 	else if (attr == &dev_attr_end_lba)
1779 		ret = sprintf(buf, "%llu\n", bt->end_lba);
1780 
1781 out_unlock_bdev:
1782 	mutex_unlock(&q->debugfs_mutex);
1783 	return ret;
1784 }
1785 
1786 static ssize_t sysfs_blk_trace_attr_store(struct device *dev,
1787 					  struct device_attribute *attr,
1788 					  const char *buf, size_t count)
1789 {
1790 	struct block_device *bdev = dev_to_bdev(dev);
1791 	struct request_queue *q = bdev_get_queue(bdev);
1792 	struct blk_trace *bt;
1793 	u64 value;
1794 	ssize_t ret = -EINVAL;
1795 
1796 	if (count == 0)
1797 		goto out;
1798 
1799 	if (attr == &dev_attr_act_mask) {
1800 		if (kstrtoull(buf, 0, &value)) {
1801 			/* Assume it is a list of trace category names */
1802 			ret = blk_trace_str2mask(buf);
1803 			if (ret < 0)
1804 				goto out;
1805 			value = ret;
1806 		}
1807 	} else {
1808 		if (kstrtoull(buf, 0, &value))
1809 			goto out;
1810 	}
1811 
1812 	mutex_lock(&q->debugfs_mutex);
1813 
1814 	bt = rcu_dereference_protected(q->blk_trace,
1815 				       lockdep_is_held(&q->debugfs_mutex));
1816 	if (attr == &dev_attr_enable) {
1817 		if (!!value == !!bt) {
1818 			ret = 0;
1819 			goto out_unlock_bdev;
1820 		}
1821 		if (value)
1822 			ret = blk_trace_setup_queue(q, bdev);
1823 		else
1824 			ret = blk_trace_remove_queue(q);
1825 		goto out_unlock_bdev;
1826 	}
1827 
1828 	ret = 0;
1829 	if (bt == NULL) {
1830 		ret = blk_trace_setup_queue(q, bdev);
1831 		bt = rcu_dereference_protected(q->blk_trace,
1832 				lockdep_is_held(&q->debugfs_mutex));
1833 	}
1834 
1835 	if (ret == 0) {
1836 		if (attr == &dev_attr_act_mask)
1837 			bt->act_mask = value;
1838 		else if (attr == &dev_attr_pid)
1839 			bt->pid = value;
1840 		else if (attr == &dev_attr_start_lba)
1841 			bt->start_lba = value;
1842 		else if (attr == &dev_attr_end_lba)
1843 			bt->end_lba = value;
1844 	}
1845 
1846 out_unlock_bdev:
1847 	mutex_unlock(&q->debugfs_mutex);
1848 out:
1849 	return ret ? ret : count;
1850 }
1851 #endif /* CONFIG_BLK_DEV_IO_TRACE */
1852 
1853 #ifdef CONFIG_EVENT_TRACING
1854 
1855 /**
1856  * blk_fill_rwbs - Fill the buffer rwbs by mapping op to character string.
1857  * @rwbs:	buffer to be filled
1858  * @opf:	request operation type (REQ_OP_XXX) and flags for the tracepoint
1859  *
1860  * Description:
1861  *     Maps each request operation and flag to a single character and fills the
1862  *     buffer provided by the caller with resulting string.
1863  *
1864  **/
1865 void blk_fill_rwbs(char *rwbs, blk_opf_t opf)
1866 {
1867 	int i = 0;
1868 
1869 	if (opf & REQ_PREFLUSH)
1870 		rwbs[i++] = 'F';
1871 
1872 	switch (opf & REQ_OP_MASK) {
1873 	case REQ_OP_WRITE:
1874 		rwbs[i++] = 'W';
1875 		break;
1876 	case REQ_OP_DISCARD:
1877 		rwbs[i++] = 'D';
1878 		break;
1879 	case REQ_OP_SECURE_ERASE:
1880 		rwbs[i++] = 'D';
1881 		rwbs[i++] = 'E';
1882 		break;
1883 	case REQ_OP_FLUSH:
1884 		rwbs[i++] = 'F';
1885 		break;
1886 	case REQ_OP_READ:
1887 		rwbs[i++] = 'R';
1888 		break;
1889 	default:
1890 		rwbs[i++] = 'N';
1891 	}
1892 
1893 	if (opf & REQ_FUA)
1894 		rwbs[i++] = 'F';
1895 	if (opf & REQ_RAHEAD)
1896 		rwbs[i++] = 'A';
1897 	if (opf & REQ_SYNC)
1898 		rwbs[i++] = 'S';
1899 	if (opf & REQ_META)
1900 		rwbs[i++] = 'M';
1901 
1902 	rwbs[i] = '\0';
1903 }
1904 EXPORT_SYMBOL_GPL(blk_fill_rwbs);
1905 
1906 #endif /* CONFIG_EVENT_TRACING */
1907 
1908