Linux Audio

Check our new training course

Loading...
v6.2
   1// SPDX-License-Identifier: GPL-2.0
   2#define pr_fmt(fmt) "kcov: " fmt
   3
   4#define DISABLE_BRANCH_PROFILING
   5#include <linux/atomic.h>
   6#include <linux/compiler.h>
   7#include <linux/errno.h>
   8#include <linux/export.h>
   9#include <linux/types.h>
  10#include <linux/file.h>
  11#include <linux/fs.h>
  12#include <linux/hashtable.h>
  13#include <linux/init.h>
  14#include <linux/kmsan-checks.h>
  15#include <linux/mm.h>
  16#include <linux/preempt.h>
  17#include <linux/printk.h>
  18#include <linux/sched.h>
  19#include <linux/slab.h>
  20#include <linux/spinlock.h>
  21#include <linux/vmalloc.h>
  22#include <linux/debugfs.h>
  23#include <linux/uaccess.h>
  24#include <linux/kcov.h>
  25#include <linux/refcount.h>
  26#include <linux/log2.h>
  27#include <asm/setup.h>
  28
  29#define kcov_debug(fmt, ...) pr_debug("%s: " fmt, __func__, ##__VA_ARGS__)
  30
  31/* Number of 64-bit words written per one comparison: */
  32#define KCOV_WORDS_PER_CMP 4
  33
  34/*
  35 * kcov descriptor (one per opened debugfs file).
  36 * State transitions of the descriptor:
  37 *  - initial state after open()
  38 *  - then there must be a single ioctl(KCOV_INIT_TRACE) call
  39 *  - then, mmap() call (several calls are allowed but not useful)
  40 *  - then, ioctl(KCOV_ENABLE, arg), where arg is
  41 *	KCOV_TRACE_PC - to trace only the PCs
  42 *	or
  43 *	KCOV_TRACE_CMP - to trace only the comparison operands
  44 *  - then, ioctl(KCOV_DISABLE) to disable the task.
  45 * Enabling/disabling ioctls can be repeated (only one task a time allowed).
  46 */
  47struct kcov {
  48	/*
  49	 * Reference counter. We keep one for:
  50	 *  - opened file descriptor
  51	 *  - task with enabled coverage (we can't unwire it from another task)
  52	 *  - each code section for remote coverage collection
  53	 */
  54	refcount_t		refcount;
  55	/* The lock protects mode, size, area and t. */
  56	spinlock_t		lock;
  57	enum kcov_mode		mode;
  58	/* Size of arena (in long's). */
  59	unsigned int		size;
  60	/* Coverage buffer shared with user space. */
  61	void			*area;
  62	/* Task for which we collect coverage, or NULL. */
  63	struct task_struct	*t;
  64	/* Collecting coverage from remote (background) threads. */
  65	bool			remote;
  66	/* Size of remote area (in long's). */
  67	unsigned int		remote_size;
  68	/*
  69	 * Sequence is incremented each time kcov is reenabled, used by
  70	 * kcov_remote_stop(), see the comment there.
  71	 */
  72	int			sequence;
  73};
  74
  75struct kcov_remote_area {
  76	struct list_head	list;
  77	unsigned int		size;
  78};
  79
  80struct kcov_remote {
  81	u64			handle;
  82	struct kcov		*kcov;
  83	struct hlist_node	hnode;
  84};
  85
  86static DEFINE_SPINLOCK(kcov_remote_lock);
  87static DEFINE_HASHTABLE(kcov_remote_map, 4);
  88static struct list_head kcov_remote_areas = LIST_HEAD_INIT(kcov_remote_areas);
  89
  90struct kcov_percpu_data {
  91	void			*irq_area;
  92	local_lock_t		lock;
  93
  94	unsigned int		saved_mode;
  95	unsigned int		saved_size;
  96	void			*saved_area;
  97	struct kcov		*saved_kcov;
  98	int			saved_sequence;
  99};
 100
 101static DEFINE_PER_CPU(struct kcov_percpu_data, kcov_percpu_data) = {
 102	.lock = INIT_LOCAL_LOCK(lock),
 103};
 104
 105/* Must be called with kcov_remote_lock locked. */
 106static struct kcov_remote *kcov_remote_find(u64 handle)
 107{
 108	struct kcov_remote *remote;
 109
 110	hash_for_each_possible(kcov_remote_map, remote, hnode, handle) {
 111		if (remote->handle == handle)
 112			return remote;
 113	}
 114	return NULL;
 115}
 116
 117/* Must be called with kcov_remote_lock locked. */
 118static struct kcov_remote *kcov_remote_add(struct kcov *kcov, u64 handle)
 119{
 120	struct kcov_remote *remote;
 121
 122	if (kcov_remote_find(handle))
 123		return ERR_PTR(-EEXIST);
 124	remote = kmalloc(sizeof(*remote), GFP_ATOMIC);
 125	if (!remote)
 126		return ERR_PTR(-ENOMEM);
 127	remote->handle = handle;
 128	remote->kcov = kcov;
 129	hash_add(kcov_remote_map, &remote->hnode, handle);
 130	return remote;
 131}
 132
 133/* Must be called with kcov_remote_lock locked. */
 134static struct kcov_remote_area *kcov_remote_area_get(unsigned int size)
 135{
 136	struct kcov_remote_area *area;
 137	struct list_head *pos;
 138
 139	list_for_each(pos, &kcov_remote_areas) {
 140		area = list_entry(pos, struct kcov_remote_area, list);
 141		if (area->size == size) {
 142			list_del(&area->list);
 143			return area;
 144		}
 145	}
 146	return NULL;
 147}
 148
 149/* Must be called with kcov_remote_lock locked. */
 150static void kcov_remote_area_put(struct kcov_remote_area *area,
 151					unsigned int size)
 152{
 153	INIT_LIST_HEAD(&area->list);
 154	area->size = size;
 155	list_add(&area->list, &kcov_remote_areas);
 156	/*
 157	 * KMSAN doesn't instrument this file, so it may not know area->list
 158	 * is initialized. Unpoison it explicitly to avoid reports in
 159	 * kcov_remote_area_get().
 160	 */
 161	kmsan_unpoison_memory(&area->list, sizeof(area->list));
 162}
 163
 164static notrace bool check_kcov_mode(enum kcov_mode needed_mode, struct task_struct *t)
 165{
 166	unsigned int mode;
 167
 168	/*
 169	 * We are interested in code coverage as a function of a syscall inputs,
 170	 * so we ignore code executed in interrupts, unless we are in a remote
 171	 * coverage collection section in a softirq.
 172	 */
 173	if (!in_task() && !(in_serving_softirq() && t->kcov_softirq))
 174		return false;
 175	mode = READ_ONCE(t->kcov_mode);
 176	/*
 177	 * There is some code that runs in interrupts but for which
 178	 * in_interrupt() returns false (e.g. preempt_schedule_irq()).
 179	 * READ_ONCE()/barrier() effectively provides load-acquire wrt
 180	 * interrupts, there are paired barrier()/WRITE_ONCE() in
 181	 * kcov_start().
 182	 */
 183	barrier();
 184	return mode == needed_mode;
 185}
 186
 187static notrace unsigned long canonicalize_ip(unsigned long ip)
 188{
 189#ifdef CONFIG_RANDOMIZE_BASE
 190	ip -= kaslr_offset();
 191#endif
 192	return ip;
 193}
 194
 195/*
 196 * Entry point from instrumented code.
 197 * This is called once per basic-block/edge.
 198 */
 199void notrace __sanitizer_cov_trace_pc(void)
 200{
 201	struct task_struct *t;
 202	unsigned long *area;
 203	unsigned long ip = canonicalize_ip(_RET_IP_);
 204	unsigned long pos;
 205
 206	t = current;
 207	if (!check_kcov_mode(KCOV_MODE_TRACE_PC, t))
 208		return;
 209
 210	area = t->kcov_area;
 211	/* The first 64-bit word is the number of subsequent PCs. */
 212	pos = READ_ONCE(area[0]) + 1;
 213	if (likely(pos < t->kcov_size)) {
 214		/* Previously we write pc before updating pos. However, some
 215		 * early interrupt code could bypass check_kcov_mode() check
 216		 * and invoke __sanitizer_cov_trace_pc(). If such interrupt is
 217		 * raised between writing pc and updating pos, the pc could be
 218		 * overitten by the recursive __sanitizer_cov_trace_pc().
 219		 * Update pos before writing pc to avoid such interleaving.
 220		 */
 221		WRITE_ONCE(area[0], pos);
 222		barrier();
 223		area[pos] = ip;
 
 224	}
 225}
 226EXPORT_SYMBOL(__sanitizer_cov_trace_pc);
 227
 228#ifdef CONFIG_KCOV_ENABLE_COMPARISONS
 229static void notrace write_comp_data(u64 type, u64 arg1, u64 arg2, u64 ip)
 230{
 231	struct task_struct *t;
 232	u64 *area;
 233	u64 count, start_index, end_pos, max_pos;
 234
 235	t = current;
 236	if (!check_kcov_mode(KCOV_MODE_TRACE_CMP, t))
 237		return;
 238
 239	ip = canonicalize_ip(ip);
 240
 241	/*
 242	 * We write all comparison arguments and types as u64.
 243	 * The buffer was allocated for t->kcov_size unsigned longs.
 244	 */
 245	area = (u64 *)t->kcov_area;
 246	max_pos = t->kcov_size * sizeof(unsigned long);
 247
 248	count = READ_ONCE(area[0]);
 249
 250	/* Every record is KCOV_WORDS_PER_CMP 64-bit words. */
 251	start_index = 1 + count * KCOV_WORDS_PER_CMP;
 252	end_pos = (start_index + KCOV_WORDS_PER_CMP) * sizeof(u64);
 253	if (likely(end_pos <= max_pos)) {
 254		/* See comment in __sanitizer_cov_trace_pc(). */
 255		WRITE_ONCE(area[0], count + 1);
 256		barrier();
 257		area[start_index] = type;
 258		area[start_index + 1] = arg1;
 259		area[start_index + 2] = arg2;
 260		area[start_index + 3] = ip;
 
 261	}
 262}
 263
 264void notrace __sanitizer_cov_trace_cmp1(u8 arg1, u8 arg2)
 265{
 266	write_comp_data(KCOV_CMP_SIZE(0), arg1, arg2, _RET_IP_);
 267}
 268EXPORT_SYMBOL(__sanitizer_cov_trace_cmp1);
 269
 270void notrace __sanitizer_cov_trace_cmp2(u16 arg1, u16 arg2)
 271{
 272	write_comp_data(KCOV_CMP_SIZE(1), arg1, arg2, _RET_IP_);
 273}
 274EXPORT_SYMBOL(__sanitizer_cov_trace_cmp2);
 275
 276void notrace __sanitizer_cov_trace_cmp4(u32 arg1, u32 arg2)
 277{
 278	write_comp_data(KCOV_CMP_SIZE(2), arg1, arg2, _RET_IP_);
 279}
 280EXPORT_SYMBOL(__sanitizer_cov_trace_cmp4);
 281
 282void notrace __sanitizer_cov_trace_cmp8(u64 arg1, u64 arg2)
 283{
 284	write_comp_data(KCOV_CMP_SIZE(3), arg1, arg2, _RET_IP_);
 285}
 286EXPORT_SYMBOL(__sanitizer_cov_trace_cmp8);
 287
 288void notrace __sanitizer_cov_trace_const_cmp1(u8 arg1, u8 arg2)
 289{
 290	write_comp_data(KCOV_CMP_SIZE(0) | KCOV_CMP_CONST, arg1, arg2,
 291			_RET_IP_);
 292}
 293EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp1);
 294
 295void notrace __sanitizer_cov_trace_const_cmp2(u16 arg1, u16 arg2)
 296{
 297	write_comp_data(KCOV_CMP_SIZE(1) | KCOV_CMP_CONST, arg1, arg2,
 298			_RET_IP_);
 299}
 300EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp2);
 301
 302void notrace __sanitizer_cov_trace_const_cmp4(u32 arg1, u32 arg2)
 303{
 304	write_comp_data(KCOV_CMP_SIZE(2) | KCOV_CMP_CONST, arg1, arg2,
 305			_RET_IP_);
 306}
 307EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp4);
 308
 309void notrace __sanitizer_cov_trace_const_cmp8(u64 arg1, u64 arg2)
 310{
 311	write_comp_data(KCOV_CMP_SIZE(3) | KCOV_CMP_CONST, arg1, arg2,
 312			_RET_IP_);
 313}
 314EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp8);
 315
 316void notrace __sanitizer_cov_trace_switch(u64 val, u64 *cases)
 317{
 318	u64 i;
 319	u64 count = cases[0];
 320	u64 size = cases[1];
 321	u64 type = KCOV_CMP_CONST;
 322
 323	switch (size) {
 324	case 8:
 325		type |= KCOV_CMP_SIZE(0);
 326		break;
 327	case 16:
 328		type |= KCOV_CMP_SIZE(1);
 329		break;
 330	case 32:
 331		type |= KCOV_CMP_SIZE(2);
 332		break;
 333	case 64:
 334		type |= KCOV_CMP_SIZE(3);
 335		break;
 336	default:
 337		return;
 338	}
 339	for (i = 0; i < count; i++)
 340		write_comp_data(type, cases[i + 2], val, _RET_IP_);
 341}
 342EXPORT_SYMBOL(__sanitizer_cov_trace_switch);
 343#endif /* ifdef CONFIG_KCOV_ENABLE_COMPARISONS */
 344
 345static void kcov_start(struct task_struct *t, struct kcov *kcov,
 346			unsigned int size, void *area, enum kcov_mode mode,
 347			int sequence)
 348{
 349	kcov_debug("t = %px, size = %u, area = %px\n", t, size, area);
 350	t->kcov = kcov;
 351	/* Cache in task struct for performance. */
 352	t->kcov_size = size;
 353	t->kcov_area = area;
 354	t->kcov_sequence = sequence;
 355	/* See comment in check_kcov_mode(). */
 356	barrier();
 357	WRITE_ONCE(t->kcov_mode, mode);
 358}
 359
 360static void kcov_stop(struct task_struct *t)
 361{
 362	WRITE_ONCE(t->kcov_mode, KCOV_MODE_DISABLED);
 363	barrier();
 364	t->kcov = NULL;
 365	t->kcov_size = 0;
 366	t->kcov_area = NULL;
 367}
 368
 369static void kcov_task_reset(struct task_struct *t)
 370{
 371	kcov_stop(t);
 372	t->kcov_sequence = 0;
 373	t->kcov_handle = 0;
 374}
 375
 376void kcov_task_init(struct task_struct *t)
 377{
 378	kcov_task_reset(t);
 379	t->kcov_handle = current->kcov_handle;
 380}
 381
 382static void kcov_reset(struct kcov *kcov)
 383{
 384	kcov->t = NULL;
 385	kcov->mode = KCOV_MODE_INIT;
 386	kcov->remote = false;
 387	kcov->remote_size = 0;
 388	kcov->sequence++;
 389}
 390
 391static void kcov_remote_reset(struct kcov *kcov)
 392{
 393	int bkt;
 394	struct kcov_remote *remote;
 395	struct hlist_node *tmp;
 396	unsigned long flags;
 397
 398	spin_lock_irqsave(&kcov_remote_lock, flags);
 399	hash_for_each_safe(kcov_remote_map, bkt, tmp, remote, hnode) {
 400		if (remote->kcov != kcov)
 401			continue;
 402		hash_del(&remote->hnode);
 403		kfree(remote);
 404	}
 405	/* Do reset before unlock to prevent races with kcov_remote_start(). */
 406	kcov_reset(kcov);
 407	spin_unlock_irqrestore(&kcov_remote_lock, flags);
 408}
 409
 410static void kcov_disable(struct task_struct *t, struct kcov *kcov)
 411{
 412	kcov_task_reset(t);
 413	if (kcov->remote)
 414		kcov_remote_reset(kcov);
 415	else
 416		kcov_reset(kcov);
 417}
 418
 419static void kcov_get(struct kcov *kcov)
 420{
 421	refcount_inc(&kcov->refcount);
 422}
 423
 424static void kcov_put(struct kcov *kcov)
 425{
 426	if (refcount_dec_and_test(&kcov->refcount)) {
 427		kcov_remote_reset(kcov);
 428		vfree(kcov->area);
 429		kfree(kcov);
 430	}
 431}
 432
 433void kcov_task_exit(struct task_struct *t)
 434{
 435	struct kcov *kcov;
 436	unsigned long flags;
 437
 438	kcov = t->kcov;
 439	if (kcov == NULL)
 440		return;
 441
 442	spin_lock_irqsave(&kcov->lock, flags);
 443	kcov_debug("t = %px, kcov->t = %px\n", t, kcov->t);
 444	/*
 445	 * For KCOV_ENABLE devices we want to make sure that t->kcov->t == t,
 446	 * which comes down to:
 447	 *        WARN_ON(!kcov->remote && kcov->t != t);
 448	 *
 449	 * For KCOV_REMOTE_ENABLE devices, the exiting task is either:
 450	 *
 451	 * 1. A remote task between kcov_remote_start() and kcov_remote_stop().
 452	 *    In this case we should print a warning right away, since a task
 453	 *    shouldn't be exiting when it's in a kcov coverage collection
 454	 *    section. Here t points to the task that is collecting remote
 455	 *    coverage, and t->kcov->t points to the thread that created the
 456	 *    kcov device. Which means that to detect this case we need to
 457	 *    check that t != t->kcov->t, and this gives us the following:
 458	 *        WARN_ON(kcov->remote && kcov->t != t);
 459	 *
 460	 * 2. The task that created kcov exiting without calling KCOV_DISABLE,
 461	 *    and then again we make sure that t->kcov->t == t:
 462	 *        WARN_ON(kcov->remote && kcov->t != t);
 463	 *
 464	 * By combining all three checks into one we get:
 465	 */
 466	if (WARN_ON(kcov->t != t)) {
 467		spin_unlock_irqrestore(&kcov->lock, flags);
 468		return;
 469	}
 470	/* Just to not leave dangling references behind. */
 471	kcov_disable(t, kcov);
 472	spin_unlock_irqrestore(&kcov->lock, flags);
 473	kcov_put(kcov);
 474}
 475
 476static int kcov_mmap(struct file *filep, struct vm_area_struct *vma)
 477{
 478	int res = 0;
 
 479	struct kcov *kcov = vma->vm_file->private_data;
 480	unsigned long size, off;
 481	struct page *page;
 482	unsigned long flags;
 483
 
 
 
 
 484	spin_lock_irqsave(&kcov->lock, flags);
 485	size = kcov->size * sizeof(unsigned long);
 486	if (kcov->area == NULL || vma->vm_pgoff != 0 ||
 487	    vma->vm_end - vma->vm_start != size) {
 488		res = -EINVAL;
 489		goto exit;
 490	}
 491	spin_unlock_irqrestore(&kcov->lock, flags);
 492	vma->vm_flags |= VM_DONTEXPAND;
 493	for (off = 0; off < size; off += PAGE_SIZE) {
 494		page = vmalloc_to_page(kcov->area + off);
 495		res = vm_insert_page(vma, vma->vm_start + off, page);
 496		if (res) {
 497			pr_warn_once("kcov: vm_insert_page() failed\n");
 498			return res;
 499		}
 
 500	}
 501	return 0;
 502exit:
 503	spin_unlock_irqrestore(&kcov->lock, flags);
 
 504	return res;
 505}
 506
 507static int kcov_open(struct inode *inode, struct file *filep)
 508{
 509	struct kcov *kcov;
 510
 511	kcov = kzalloc(sizeof(*kcov), GFP_KERNEL);
 512	if (!kcov)
 513		return -ENOMEM;
 514	kcov->mode = KCOV_MODE_DISABLED;
 515	kcov->sequence = 1;
 516	refcount_set(&kcov->refcount, 1);
 517	spin_lock_init(&kcov->lock);
 518	filep->private_data = kcov;
 519	return nonseekable_open(inode, filep);
 520}
 521
 522static int kcov_close(struct inode *inode, struct file *filep)
 523{
 524	kcov_put(filep->private_data);
 525	return 0;
 526}
 527
 528static int kcov_get_mode(unsigned long arg)
 529{
 530	if (arg == KCOV_TRACE_PC)
 531		return KCOV_MODE_TRACE_PC;
 532	else if (arg == KCOV_TRACE_CMP)
 533#ifdef CONFIG_KCOV_ENABLE_COMPARISONS
 534		return KCOV_MODE_TRACE_CMP;
 535#else
 536		return -ENOTSUPP;
 537#endif
 538	else
 539		return -EINVAL;
 540}
 541
 542/*
 543 * Fault in a lazily-faulted vmalloc area before it can be used by
 544 * __santizer_cov_trace_pc(), to avoid recursion issues if any code on the
 545 * vmalloc fault handling path is instrumented.
 546 */
 547static void kcov_fault_in_area(struct kcov *kcov)
 548{
 549	unsigned long stride = PAGE_SIZE / sizeof(unsigned long);
 550	unsigned long *area = kcov->area;
 551	unsigned long offset;
 552
 553	for (offset = 0; offset < kcov->size; offset += stride)
 554		READ_ONCE(area[offset]);
 555}
 556
 557static inline bool kcov_check_handle(u64 handle, bool common_valid,
 558				bool uncommon_valid, bool zero_valid)
 559{
 560	if (handle & ~(KCOV_SUBSYSTEM_MASK | KCOV_INSTANCE_MASK))
 561		return false;
 562	switch (handle & KCOV_SUBSYSTEM_MASK) {
 563	case KCOV_SUBSYSTEM_COMMON:
 564		return (handle & KCOV_INSTANCE_MASK) ?
 565			common_valid : zero_valid;
 566	case KCOV_SUBSYSTEM_USB:
 567		return uncommon_valid;
 568	default:
 569		return false;
 570	}
 571	return false;
 572}
 573
 574static int kcov_ioctl_locked(struct kcov *kcov, unsigned int cmd,
 575			     unsigned long arg)
 576{
 577	struct task_struct *t;
 578	unsigned long flags, unused;
 579	int mode, i;
 580	struct kcov_remote_arg *remote_arg;
 581	struct kcov_remote *remote;
 
 582
 583	switch (cmd) {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 584	case KCOV_ENABLE:
 585		/*
 586		 * Enable coverage for the current task.
 587		 * At this point user must have been enabled trace mode,
 588		 * and mmapped the file. Coverage collection is disabled only
 589		 * at task exit or voluntary by KCOV_DISABLE. After that it can
 590		 * be enabled for another task.
 591		 */
 592		if (kcov->mode != KCOV_MODE_INIT || !kcov->area)
 593			return -EINVAL;
 594		t = current;
 595		if (kcov->t != NULL || t->kcov != NULL)
 596			return -EBUSY;
 597		mode = kcov_get_mode(arg);
 598		if (mode < 0)
 599			return mode;
 600		kcov_fault_in_area(kcov);
 601		kcov->mode = mode;
 602		kcov_start(t, kcov, kcov->size, kcov->area, kcov->mode,
 603				kcov->sequence);
 604		kcov->t = t;
 605		/* Put either in kcov_task_exit() or in KCOV_DISABLE. */
 606		kcov_get(kcov);
 607		return 0;
 608	case KCOV_DISABLE:
 609		/* Disable coverage for the current task. */
 610		unused = arg;
 611		if (unused != 0 || current->kcov != kcov)
 612			return -EINVAL;
 613		t = current;
 614		if (WARN_ON(kcov->t != t))
 615			return -EINVAL;
 616		kcov_disable(t, kcov);
 617		kcov_put(kcov);
 618		return 0;
 619	case KCOV_REMOTE_ENABLE:
 620		if (kcov->mode != KCOV_MODE_INIT || !kcov->area)
 621			return -EINVAL;
 622		t = current;
 623		if (kcov->t != NULL || t->kcov != NULL)
 624			return -EBUSY;
 625		remote_arg = (struct kcov_remote_arg *)arg;
 626		mode = kcov_get_mode(remote_arg->trace_mode);
 627		if (mode < 0)
 628			return mode;
 629		if (remote_arg->area_size > LONG_MAX / sizeof(unsigned long))
 630			return -EINVAL;
 631		kcov->mode = mode;
 632		t->kcov = kcov;
 633		kcov->t = t;
 634		kcov->remote = true;
 635		kcov->remote_size = remote_arg->area_size;
 636		spin_lock_irqsave(&kcov_remote_lock, flags);
 637		for (i = 0; i < remote_arg->num_handles; i++) {
 638			if (!kcov_check_handle(remote_arg->handles[i],
 639						false, true, false)) {
 640				spin_unlock_irqrestore(&kcov_remote_lock,
 641							flags);
 642				kcov_disable(t, kcov);
 643				return -EINVAL;
 644			}
 645			remote = kcov_remote_add(kcov, remote_arg->handles[i]);
 646			if (IS_ERR(remote)) {
 647				spin_unlock_irqrestore(&kcov_remote_lock,
 648							flags);
 649				kcov_disable(t, kcov);
 650				return PTR_ERR(remote);
 651			}
 652		}
 653		if (remote_arg->common_handle) {
 654			if (!kcov_check_handle(remote_arg->common_handle,
 655						true, false, false)) {
 656				spin_unlock_irqrestore(&kcov_remote_lock,
 657							flags);
 658				kcov_disable(t, kcov);
 659				return -EINVAL;
 660			}
 661			remote = kcov_remote_add(kcov,
 662					remote_arg->common_handle);
 663			if (IS_ERR(remote)) {
 664				spin_unlock_irqrestore(&kcov_remote_lock,
 665							flags);
 666				kcov_disable(t, kcov);
 667				return PTR_ERR(remote);
 668			}
 669			t->kcov_handle = remote_arg->common_handle;
 670		}
 671		spin_unlock_irqrestore(&kcov_remote_lock, flags);
 672		/* Put either in kcov_task_exit() or in KCOV_DISABLE. */
 673		kcov_get(kcov);
 674		return 0;
 675	default:
 676		return -ENOTTY;
 677	}
 678}
 679
 680static long kcov_ioctl(struct file *filep, unsigned int cmd, unsigned long arg)
 681{
 682	struct kcov *kcov;
 683	int res;
 684	struct kcov_remote_arg *remote_arg = NULL;
 685	unsigned int remote_num_handles;
 686	unsigned long remote_arg_size;
 687	unsigned long size, flags;
 688	void *area;
 689
 690	kcov = filep->private_data;
 691	switch (cmd) {
 692	case KCOV_INIT_TRACE:
 693		/*
 694		 * Enable kcov in trace mode and setup buffer size.
 695		 * Must happen before anything else.
 696		 *
 697		 * First check the size argument - it must be at least 2
 698		 * to hold the current position and one PC.
 699		 */
 700		size = arg;
 701		if (size < 2 || size > INT_MAX / sizeof(unsigned long))
 702			return -EINVAL;
 703		area = vmalloc_user(size * sizeof(unsigned long));
 704		if (area == NULL)
 705			return -ENOMEM;
 706		spin_lock_irqsave(&kcov->lock, flags);
 707		if (kcov->mode != KCOV_MODE_DISABLED) {
 708			spin_unlock_irqrestore(&kcov->lock, flags);
 709			vfree(area);
 710			return -EBUSY;
 711		}
 712		kcov->area = area;
 713		kcov->size = size;
 714		kcov->mode = KCOV_MODE_INIT;
 715		spin_unlock_irqrestore(&kcov->lock, flags);
 716		return 0;
 717	case KCOV_REMOTE_ENABLE:
 718		if (get_user(remote_num_handles, (unsigned __user *)(arg +
 719				offsetof(struct kcov_remote_arg, num_handles))))
 720			return -EFAULT;
 721		if (remote_num_handles > KCOV_REMOTE_MAX_HANDLES)
 722			return -EINVAL;
 723		remote_arg_size = struct_size(remote_arg, handles,
 724					remote_num_handles);
 725		remote_arg = memdup_user((void __user *)arg, remote_arg_size);
 726		if (IS_ERR(remote_arg))
 727			return PTR_ERR(remote_arg);
 728		if (remote_arg->num_handles != remote_num_handles) {
 729			kfree(remote_arg);
 730			return -EINVAL;
 731		}
 732		arg = (unsigned long)remote_arg;
 733		fallthrough;
 734	default:
 735		/*
 736		 * All other commands can be normally executed under a spin lock, so we
 737		 * obtain and release it here in order to simplify kcov_ioctl_locked().
 738		 */
 739		spin_lock_irqsave(&kcov->lock, flags);
 740		res = kcov_ioctl_locked(kcov, cmd, arg);
 741		spin_unlock_irqrestore(&kcov->lock, flags);
 742		kfree(remote_arg);
 743		return res;
 744	}
 
 
 
 
 
 
 
 
 
 745}
 746
 747static const struct file_operations kcov_fops = {
 748	.open		= kcov_open,
 749	.unlocked_ioctl	= kcov_ioctl,
 750	.compat_ioctl	= kcov_ioctl,
 751	.mmap		= kcov_mmap,
 752	.release        = kcov_close,
 753};
 754
 755/*
 756 * kcov_remote_start() and kcov_remote_stop() can be used to annotate a section
 757 * of code in a kernel background thread or in a softirq to allow kcov to be
 758 * used to collect coverage from that part of code.
 759 *
 760 * The handle argument of kcov_remote_start() identifies a code section that is
 761 * used for coverage collection. A userspace process passes this handle to
 762 * KCOV_REMOTE_ENABLE ioctl to make the used kcov device start collecting
 763 * coverage for the code section identified by this handle.
 764 *
 765 * The usage of these annotations in the kernel code is different depending on
 766 * the type of the kernel thread whose code is being annotated.
 767 *
 768 * For global kernel threads that are spawned in a limited number of instances
 769 * (e.g. one USB hub_event() worker thread is spawned per USB HCD) and for
 770 * softirqs, each instance must be assigned a unique 4-byte instance id. The
 771 * instance id is then combined with a 1-byte subsystem id to get a handle via
 772 * kcov_remote_handle(subsystem_id, instance_id).
 773 *
 774 * For local kernel threads that are spawned from system calls handler when a
 775 * user interacts with some kernel interface (e.g. vhost workers), a handle is
 776 * passed from a userspace process as the common_handle field of the
 777 * kcov_remote_arg struct (note, that the user must generate a handle by using
 778 * kcov_remote_handle() with KCOV_SUBSYSTEM_COMMON as the subsystem id and an
 779 * arbitrary 4-byte non-zero number as the instance id). This common handle
 780 * then gets saved into the task_struct of the process that issued the
 781 * KCOV_REMOTE_ENABLE ioctl. When this process issues system calls that spawn
 782 * kernel threads, the common handle must be retrieved via kcov_common_handle()
 783 * and passed to the spawned threads via custom annotations. Those kernel
 784 * threads must in turn be annotated with kcov_remote_start(common_handle) and
 785 * kcov_remote_stop(). All of the threads that are spawned by the same process
 786 * obtain the same handle, hence the name "common".
 787 *
 788 * See Documentation/dev-tools/kcov.rst for more details.
 789 *
 790 * Internally, kcov_remote_start() looks up the kcov device associated with the
 791 * provided handle, allocates an area for coverage collection, and saves the
 792 * pointers to kcov and area into the current task_struct to allow coverage to
 793 * be collected via __sanitizer_cov_trace_pc().
 794 * In turns kcov_remote_stop() clears those pointers from task_struct to stop
 795 * collecting coverage and copies all collected coverage into the kcov area.
 796 */
 797
 798static inline bool kcov_mode_enabled(unsigned int mode)
 799{
 800	return (mode & ~KCOV_IN_CTXSW) != KCOV_MODE_DISABLED;
 801}
 802
 803static void kcov_remote_softirq_start(struct task_struct *t)
 804{
 805	struct kcov_percpu_data *data = this_cpu_ptr(&kcov_percpu_data);
 806	unsigned int mode;
 807
 808	mode = READ_ONCE(t->kcov_mode);
 809	barrier();
 810	if (kcov_mode_enabled(mode)) {
 811		data->saved_mode = mode;
 812		data->saved_size = t->kcov_size;
 813		data->saved_area = t->kcov_area;
 814		data->saved_sequence = t->kcov_sequence;
 815		data->saved_kcov = t->kcov;
 816		kcov_stop(t);
 817	}
 818}
 819
 820static void kcov_remote_softirq_stop(struct task_struct *t)
 821{
 822	struct kcov_percpu_data *data = this_cpu_ptr(&kcov_percpu_data);
 823
 824	if (data->saved_kcov) {
 825		kcov_start(t, data->saved_kcov, data->saved_size,
 826				data->saved_area, data->saved_mode,
 827				data->saved_sequence);
 828		data->saved_mode = 0;
 829		data->saved_size = 0;
 830		data->saved_area = NULL;
 831		data->saved_sequence = 0;
 832		data->saved_kcov = NULL;
 833	}
 834}
 835
 836void kcov_remote_start(u64 handle)
 837{
 838	struct task_struct *t = current;
 839	struct kcov_remote *remote;
 840	struct kcov *kcov;
 841	unsigned int mode;
 842	void *area;
 843	unsigned int size;
 844	int sequence;
 845	unsigned long flags;
 846
 847	if (WARN_ON(!kcov_check_handle(handle, true, true, true)))
 848		return;
 849	if (!in_task() && !in_serving_softirq())
 850		return;
 851
 852	local_lock_irqsave(&kcov_percpu_data.lock, flags);
 853
 854	/*
 855	 * Check that kcov_remote_start() is not called twice in background
 856	 * threads nor called by user tasks (with enabled kcov).
 857	 */
 858	mode = READ_ONCE(t->kcov_mode);
 859	if (WARN_ON(in_task() && kcov_mode_enabled(mode))) {
 860		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
 861		return;
 862	}
 863	/*
 864	 * Check that kcov_remote_start() is not called twice in softirqs.
 865	 * Note, that kcov_remote_start() can be called from a softirq that
 866	 * happened while collecting coverage from a background thread.
 867	 */
 868	if (WARN_ON(in_serving_softirq() && t->kcov_softirq)) {
 869		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
 870		return;
 871	}
 872
 873	spin_lock(&kcov_remote_lock);
 874	remote = kcov_remote_find(handle);
 875	if (!remote) {
 876		spin_unlock(&kcov_remote_lock);
 877		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
 878		return;
 879	}
 880	kcov_debug("handle = %llx, context: %s\n", handle,
 881			in_task() ? "task" : "softirq");
 882	kcov = remote->kcov;
 883	/* Put in kcov_remote_stop(). */
 884	kcov_get(kcov);
 885	/*
 886	 * Read kcov fields before unlock to prevent races with
 887	 * KCOV_DISABLE / kcov_remote_reset().
 888	 */
 889	mode = kcov->mode;
 890	sequence = kcov->sequence;
 891	if (in_task()) {
 892		size = kcov->remote_size;
 893		area = kcov_remote_area_get(size);
 894	} else {
 895		size = CONFIG_KCOV_IRQ_AREA_SIZE;
 896		area = this_cpu_ptr(&kcov_percpu_data)->irq_area;
 897	}
 898	spin_unlock(&kcov_remote_lock);
 899
 900	/* Can only happen when in_task(). */
 901	if (!area) {
 902		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
 903		area = vmalloc(size * sizeof(unsigned long));
 904		if (!area) {
 905			kcov_put(kcov);
 906			return;
 907		}
 908		local_lock_irqsave(&kcov_percpu_data.lock, flags);
 909	}
 910
 
 
 911	/* Reset coverage size. */
 912	*(u64 *)area = 0;
 913
 914	if (in_serving_softirq()) {
 915		kcov_remote_softirq_start(t);
 916		t->kcov_softirq = 1;
 917	}
 918	kcov_start(t, kcov, size, area, mode, sequence);
 919
 920	local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
 921
 922}
 923EXPORT_SYMBOL(kcov_remote_start);
 924
 925static void kcov_move_area(enum kcov_mode mode, void *dst_area,
 926				unsigned int dst_area_size, void *src_area)
 927{
 928	u64 word_size = sizeof(unsigned long);
 929	u64 count_size, entry_size_log;
 930	u64 dst_len, src_len;
 931	void *dst_entries, *src_entries;
 932	u64 dst_occupied, dst_free, bytes_to_move, entries_moved;
 933
 934	kcov_debug("%px %u <= %px %lu\n",
 935		dst_area, dst_area_size, src_area, *(unsigned long *)src_area);
 936
 937	switch (mode) {
 938	case KCOV_MODE_TRACE_PC:
 939		dst_len = READ_ONCE(*(unsigned long *)dst_area);
 940		src_len = *(unsigned long *)src_area;
 941		count_size = sizeof(unsigned long);
 942		entry_size_log = __ilog2_u64(sizeof(unsigned long));
 943		break;
 944	case KCOV_MODE_TRACE_CMP:
 945		dst_len = READ_ONCE(*(u64 *)dst_area);
 946		src_len = *(u64 *)src_area;
 947		count_size = sizeof(u64);
 948		BUILD_BUG_ON(!is_power_of_2(KCOV_WORDS_PER_CMP));
 949		entry_size_log = __ilog2_u64(sizeof(u64) * KCOV_WORDS_PER_CMP);
 950		break;
 951	default:
 952		WARN_ON(1);
 953		return;
 954	}
 955
 956	/* As arm can't divide u64 integers use log of entry size. */
 957	if (dst_len > ((dst_area_size * word_size - count_size) >>
 958				entry_size_log))
 959		return;
 960	dst_occupied = count_size + (dst_len << entry_size_log);
 961	dst_free = dst_area_size * word_size - dst_occupied;
 962	bytes_to_move = min(dst_free, src_len << entry_size_log);
 963	dst_entries = dst_area + dst_occupied;
 964	src_entries = src_area + count_size;
 965	memcpy(dst_entries, src_entries, bytes_to_move);
 966	entries_moved = bytes_to_move >> entry_size_log;
 967
 968	switch (mode) {
 969	case KCOV_MODE_TRACE_PC:
 970		WRITE_ONCE(*(unsigned long *)dst_area, dst_len + entries_moved);
 971		break;
 972	case KCOV_MODE_TRACE_CMP:
 973		WRITE_ONCE(*(u64 *)dst_area, dst_len + entries_moved);
 974		break;
 975	default:
 976		break;
 977	}
 978}
 979
 980/* See the comment before kcov_remote_start() for usage details. */
 981void kcov_remote_stop(void)
 982{
 983	struct task_struct *t = current;
 984	struct kcov *kcov;
 985	unsigned int mode;
 986	void *area;
 987	unsigned int size;
 988	int sequence;
 989	unsigned long flags;
 990
 991	if (!in_task() && !in_serving_softirq())
 992		return;
 993
 994	local_lock_irqsave(&kcov_percpu_data.lock, flags);
 995
 996	mode = READ_ONCE(t->kcov_mode);
 997	barrier();
 998	if (!kcov_mode_enabled(mode)) {
 999		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
1000		return;
1001	}
1002	/*
1003	 * When in softirq, check if the corresponding kcov_remote_start()
1004	 * actually found the remote handle and started collecting coverage.
1005	 */
1006	if (in_serving_softirq() && !t->kcov_softirq) {
1007		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
1008		return;
1009	}
1010	/* Make sure that kcov_softirq is only set when in softirq. */
1011	if (WARN_ON(!in_serving_softirq() && t->kcov_softirq)) {
1012		local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
1013		return;
1014	}
1015
1016	kcov = t->kcov;
1017	area = t->kcov_area;
1018	size = t->kcov_size;
1019	sequence = t->kcov_sequence;
1020
1021	kcov_stop(t);
1022	if (in_serving_softirq()) {
1023		t->kcov_softirq = 0;
1024		kcov_remote_softirq_stop(t);
1025	}
1026
1027	spin_lock(&kcov->lock);
1028	/*
1029	 * KCOV_DISABLE could have been called between kcov_remote_start()
1030	 * and kcov_remote_stop(), hence the sequence check.
1031	 */
1032	if (sequence == kcov->sequence && kcov->remote)
1033		kcov_move_area(kcov->mode, kcov->area, kcov->size, area);
1034	spin_unlock(&kcov->lock);
1035
1036	if (in_task()) {
1037		spin_lock(&kcov_remote_lock);
1038		kcov_remote_area_put(area, size);
1039		spin_unlock(&kcov_remote_lock);
1040	}
1041
1042	local_unlock_irqrestore(&kcov_percpu_data.lock, flags);
1043
1044	/* Get in kcov_remote_start(). */
1045	kcov_put(kcov);
1046}
1047EXPORT_SYMBOL(kcov_remote_stop);
1048
1049/* See the comment before kcov_remote_start() for usage details. */
1050u64 kcov_common_handle(void)
1051{
1052	if (!in_task())
1053		return 0;
1054	return current->kcov_handle;
1055}
1056EXPORT_SYMBOL(kcov_common_handle);
1057
1058static int __init kcov_init(void)
1059{
1060	int cpu;
1061
1062	for_each_possible_cpu(cpu) {
1063		void *area = vmalloc_node(CONFIG_KCOV_IRQ_AREA_SIZE *
1064				sizeof(unsigned long), cpu_to_node(cpu));
1065		if (!area)
1066			return -ENOMEM;
1067		per_cpu_ptr(&kcov_percpu_data, cpu)->irq_area = area;
1068	}
1069
1070	/*
1071	 * The kcov debugfs file won't ever get removed and thus,
1072	 * there is no need to protect it against removal races. The
1073	 * use of debugfs_create_file_unsafe() is actually safe here.
1074	 */
1075	debugfs_create_file_unsafe("kcov", 0600, NULL, NULL, &kcov_fops);
1076
1077	return 0;
1078}
1079
1080device_initcall(kcov_init);
v5.9
   1// SPDX-License-Identifier: GPL-2.0
   2#define pr_fmt(fmt) "kcov: " fmt
   3
   4#define DISABLE_BRANCH_PROFILING
   5#include <linux/atomic.h>
   6#include <linux/compiler.h>
   7#include <linux/errno.h>
   8#include <linux/export.h>
   9#include <linux/types.h>
  10#include <linux/file.h>
  11#include <linux/fs.h>
  12#include <linux/hashtable.h>
  13#include <linux/init.h>
 
  14#include <linux/mm.h>
  15#include <linux/preempt.h>
  16#include <linux/printk.h>
  17#include <linux/sched.h>
  18#include <linux/slab.h>
  19#include <linux/spinlock.h>
  20#include <linux/vmalloc.h>
  21#include <linux/debugfs.h>
  22#include <linux/uaccess.h>
  23#include <linux/kcov.h>
  24#include <linux/refcount.h>
  25#include <linux/log2.h>
  26#include <asm/setup.h>
  27
  28#define kcov_debug(fmt, ...) pr_debug("%s: " fmt, __func__, ##__VA_ARGS__)
  29
  30/* Number of 64-bit words written per one comparison: */
  31#define KCOV_WORDS_PER_CMP 4
  32
  33/*
  34 * kcov descriptor (one per opened debugfs file).
  35 * State transitions of the descriptor:
  36 *  - initial state after open()
  37 *  - then there must be a single ioctl(KCOV_INIT_TRACE) call
  38 *  - then, mmap() call (several calls are allowed but not useful)
  39 *  - then, ioctl(KCOV_ENABLE, arg), where arg is
  40 *	KCOV_TRACE_PC - to trace only the PCs
  41 *	or
  42 *	KCOV_TRACE_CMP - to trace only the comparison operands
  43 *  - then, ioctl(KCOV_DISABLE) to disable the task.
  44 * Enabling/disabling ioctls can be repeated (only one task a time allowed).
  45 */
  46struct kcov {
  47	/*
  48	 * Reference counter. We keep one for:
  49	 *  - opened file descriptor
  50	 *  - task with enabled coverage (we can't unwire it from another task)
  51	 *  - each code section for remote coverage collection
  52	 */
  53	refcount_t		refcount;
  54	/* The lock protects mode, size, area and t. */
  55	spinlock_t		lock;
  56	enum kcov_mode		mode;
  57	/* Size of arena (in long's). */
  58	unsigned int		size;
  59	/* Coverage buffer shared with user space. */
  60	void			*area;
  61	/* Task for which we collect coverage, or NULL. */
  62	struct task_struct	*t;
  63	/* Collecting coverage from remote (background) threads. */
  64	bool			remote;
  65	/* Size of remote area (in long's). */
  66	unsigned int		remote_size;
  67	/*
  68	 * Sequence is incremented each time kcov is reenabled, used by
  69	 * kcov_remote_stop(), see the comment there.
  70	 */
  71	int			sequence;
  72};
  73
  74struct kcov_remote_area {
  75	struct list_head	list;
  76	unsigned int		size;
  77};
  78
  79struct kcov_remote {
  80	u64			handle;
  81	struct kcov		*kcov;
  82	struct hlist_node	hnode;
  83};
  84
  85static DEFINE_SPINLOCK(kcov_remote_lock);
  86static DEFINE_HASHTABLE(kcov_remote_map, 4);
  87static struct list_head kcov_remote_areas = LIST_HEAD_INIT(kcov_remote_areas);
  88
  89struct kcov_percpu_data {
  90	void			*irq_area;
 
  91
  92	unsigned int		saved_mode;
  93	unsigned int		saved_size;
  94	void			*saved_area;
  95	struct kcov		*saved_kcov;
  96	int			saved_sequence;
  97};
  98
  99static DEFINE_PER_CPU(struct kcov_percpu_data, kcov_percpu_data);
 
 
 100
 101/* Must be called with kcov_remote_lock locked. */
 102static struct kcov_remote *kcov_remote_find(u64 handle)
 103{
 104	struct kcov_remote *remote;
 105
 106	hash_for_each_possible(kcov_remote_map, remote, hnode, handle) {
 107		if (remote->handle == handle)
 108			return remote;
 109	}
 110	return NULL;
 111}
 112
 113/* Must be called with kcov_remote_lock locked. */
 114static struct kcov_remote *kcov_remote_add(struct kcov *kcov, u64 handle)
 115{
 116	struct kcov_remote *remote;
 117
 118	if (kcov_remote_find(handle))
 119		return ERR_PTR(-EEXIST);
 120	remote = kmalloc(sizeof(*remote), GFP_ATOMIC);
 121	if (!remote)
 122		return ERR_PTR(-ENOMEM);
 123	remote->handle = handle;
 124	remote->kcov = kcov;
 125	hash_add(kcov_remote_map, &remote->hnode, handle);
 126	return remote;
 127}
 128
 129/* Must be called with kcov_remote_lock locked. */
 130static struct kcov_remote_area *kcov_remote_area_get(unsigned int size)
 131{
 132	struct kcov_remote_area *area;
 133	struct list_head *pos;
 134
 135	list_for_each(pos, &kcov_remote_areas) {
 136		area = list_entry(pos, struct kcov_remote_area, list);
 137		if (area->size == size) {
 138			list_del(&area->list);
 139			return area;
 140		}
 141	}
 142	return NULL;
 143}
 144
 145/* Must be called with kcov_remote_lock locked. */
 146static void kcov_remote_area_put(struct kcov_remote_area *area,
 147					unsigned int size)
 148{
 149	INIT_LIST_HEAD(&area->list);
 150	area->size = size;
 151	list_add(&area->list, &kcov_remote_areas);
 
 
 
 
 
 
 152}
 153
 154static notrace bool check_kcov_mode(enum kcov_mode needed_mode, struct task_struct *t)
 155{
 156	unsigned int mode;
 157
 158	/*
 159	 * We are interested in code coverage as a function of a syscall inputs,
 160	 * so we ignore code executed in interrupts, unless we are in a remote
 161	 * coverage collection section in a softirq.
 162	 */
 163	if (!in_task() && !(in_serving_softirq() && t->kcov_softirq))
 164		return false;
 165	mode = READ_ONCE(t->kcov_mode);
 166	/*
 167	 * There is some code that runs in interrupts but for which
 168	 * in_interrupt() returns false (e.g. preempt_schedule_irq()).
 169	 * READ_ONCE()/barrier() effectively provides load-acquire wrt
 170	 * interrupts, there are paired barrier()/WRITE_ONCE() in
 171	 * kcov_start().
 172	 */
 173	barrier();
 174	return mode == needed_mode;
 175}
 176
 177static notrace unsigned long canonicalize_ip(unsigned long ip)
 178{
 179#ifdef CONFIG_RANDOMIZE_BASE
 180	ip -= kaslr_offset();
 181#endif
 182	return ip;
 183}
 184
 185/*
 186 * Entry point from instrumented code.
 187 * This is called once per basic-block/edge.
 188 */
 189void notrace __sanitizer_cov_trace_pc(void)
 190{
 191	struct task_struct *t;
 192	unsigned long *area;
 193	unsigned long ip = canonicalize_ip(_RET_IP_);
 194	unsigned long pos;
 195
 196	t = current;
 197	if (!check_kcov_mode(KCOV_MODE_TRACE_PC, t))
 198		return;
 199
 200	area = t->kcov_area;
 201	/* The first 64-bit word is the number of subsequent PCs. */
 202	pos = READ_ONCE(area[0]) + 1;
 203	if (likely(pos < t->kcov_size)) {
 
 
 
 
 
 
 
 
 
 204		area[pos] = ip;
 205		WRITE_ONCE(area[0], pos);
 206	}
 207}
 208EXPORT_SYMBOL(__sanitizer_cov_trace_pc);
 209
 210#ifdef CONFIG_KCOV_ENABLE_COMPARISONS
 211static void notrace write_comp_data(u64 type, u64 arg1, u64 arg2, u64 ip)
 212{
 213	struct task_struct *t;
 214	u64 *area;
 215	u64 count, start_index, end_pos, max_pos;
 216
 217	t = current;
 218	if (!check_kcov_mode(KCOV_MODE_TRACE_CMP, t))
 219		return;
 220
 221	ip = canonicalize_ip(ip);
 222
 223	/*
 224	 * We write all comparison arguments and types as u64.
 225	 * The buffer was allocated for t->kcov_size unsigned longs.
 226	 */
 227	area = (u64 *)t->kcov_area;
 228	max_pos = t->kcov_size * sizeof(unsigned long);
 229
 230	count = READ_ONCE(area[0]);
 231
 232	/* Every record is KCOV_WORDS_PER_CMP 64-bit words. */
 233	start_index = 1 + count * KCOV_WORDS_PER_CMP;
 234	end_pos = (start_index + KCOV_WORDS_PER_CMP) * sizeof(u64);
 235	if (likely(end_pos <= max_pos)) {
 
 
 
 236		area[start_index] = type;
 237		area[start_index + 1] = arg1;
 238		area[start_index + 2] = arg2;
 239		area[start_index + 3] = ip;
 240		WRITE_ONCE(area[0], count + 1);
 241	}
 242}
 243
 244void notrace __sanitizer_cov_trace_cmp1(u8 arg1, u8 arg2)
 245{
 246	write_comp_data(KCOV_CMP_SIZE(0), arg1, arg2, _RET_IP_);
 247}
 248EXPORT_SYMBOL(__sanitizer_cov_trace_cmp1);
 249
 250void notrace __sanitizer_cov_trace_cmp2(u16 arg1, u16 arg2)
 251{
 252	write_comp_data(KCOV_CMP_SIZE(1), arg1, arg2, _RET_IP_);
 253}
 254EXPORT_SYMBOL(__sanitizer_cov_trace_cmp2);
 255
 256void notrace __sanitizer_cov_trace_cmp4(u32 arg1, u32 arg2)
 257{
 258	write_comp_data(KCOV_CMP_SIZE(2), arg1, arg2, _RET_IP_);
 259}
 260EXPORT_SYMBOL(__sanitizer_cov_trace_cmp4);
 261
 262void notrace __sanitizer_cov_trace_cmp8(u64 arg1, u64 arg2)
 263{
 264	write_comp_data(KCOV_CMP_SIZE(3), arg1, arg2, _RET_IP_);
 265}
 266EXPORT_SYMBOL(__sanitizer_cov_trace_cmp8);
 267
 268void notrace __sanitizer_cov_trace_const_cmp1(u8 arg1, u8 arg2)
 269{
 270	write_comp_data(KCOV_CMP_SIZE(0) | KCOV_CMP_CONST, arg1, arg2,
 271			_RET_IP_);
 272}
 273EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp1);
 274
 275void notrace __sanitizer_cov_trace_const_cmp2(u16 arg1, u16 arg2)
 276{
 277	write_comp_data(KCOV_CMP_SIZE(1) | KCOV_CMP_CONST, arg1, arg2,
 278			_RET_IP_);
 279}
 280EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp2);
 281
 282void notrace __sanitizer_cov_trace_const_cmp4(u32 arg1, u32 arg2)
 283{
 284	write_comp_data(KCOV_CMP_SIZE(2) | KCOV_CMP_CONST, arg1, arg2,
 285			_RET_IP_);
 286}
 287EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp4);
 288
 289void notrace __sanitizer_cov_trace_const_cmp8(u64 arg1, u64 arg2)
 290{
 291	write_comp_data(KCOV_CMP_SIZE(3) | KCOV_CMP_CONST, arg1, arg2,
 292			_RET_IP_);
 293}
 294EXPORT_SYMBOL(__sanitizer_cov_trace_const_cmp8);
 295
 296void notrace __sanitizer_cov_trace_switch(u64 val, u64 *cases)
 297{
 298	u64 i;
 299	u64 count = cases[0];
 300	u64 size = cases[1];
 301	u64 type = KCOV_CMP_CONST;
 302
 303	switch (size) {
 304	case 8:
 305		type |= KCOV_CMP_SIZE(0);
 306		break;
 307	case 16:
 308		type |= KCOV_CMP_SIZE(1);
 309		break;
 310	case 32:
 311		type |= KCOV_CMP_SIZE(2);
 312		break;
 313	case 64:
 314		type |= KCOV_CMP_SIZE(3);
 315		break;
 316	default:
 317		return;
 318	}
 319	for (i = 0; i < count; i++)
 320		write_comp_data(type, cases[i + 2], val, _RET_IP_);
 321}
 322EXPORT_SYMBOL(__sanitizer_cov_trace_switch);
 323#endif /* ifdef CONFIG_KCOV_ENABLE_COMPARISONS */
 324
 325static void kcov_start(struct task_struct *t, struct kcov *kcov,
 326			unsigned int size, void *area, enum kcov_mode mode,
 327			int sequence)
 328{
 329	kcov_debug("t = %px, size = %u, area = %px\n", t, size, area);
 330	t->kcov = kcov;
 331	/* Cache in task struct for performance. */
 332	t->kcov_size = size;
 333	t->kcov_area = area;
 334	t->kcov_sequence = sequence;
 335	/* See comment in check_kcov_mode(). */
 336	barrier();
 337	WRITE_ONCE(t->kcov_mode, mode);
 338}
 339
 340static void kcov_stop(struct task_struct *t)
 341{
 342	WRITE_ONCE(t->kcov_mode, KCOV_MODE_DISABLED);
 343	barrier();
 344	t->kcov = NULL;
 345	t->kcov_size = 0;
 346	t->kcov_area = NULL;
 347}
 348
 349static void kcov_task_reset(struct task_struct *t)
 350{
 351	kcov_stop(t);
 352	t->kcov_sequence = 0;
 353	t->kcov_handle = 0;
 354}
 355
 356void kcov_task_init(struct task_struct *t)
 357{
 358	kcov_task_reset(t);
 359	t->kcov_handle = current->kcov_handle;
 360}
 361
 362static void kcov_reset(struct kcov *kcov)
 363{
 364	kcov->t = NULL;
 365	kcov->mode = KCOV_MODE_INIT;
 366	kcov->remote = false;
 367	kcov->remote_size = 0;
 368	kcov->sequence++;
 369}
 370
 371static void kcov_remote_reset(struct kcov *kcov)
 372{
 373	int bkt;
 374	struct kcov_remote *remote;
 375	struct hlist_node *tmp;
 376	unsigned long flags;
 377
 378	spin_lock_irqsave(&kcov_remote_lock, flags);
 379	hash_for_each_safe(kcov_remote_map, bkt, tmp, remote, hnode) {
 380		if (remote->kcov != kcov)
 381			continue;
 382		hash_del(&remote->hnode);
 383		kfree(remote);
 384	}
 385	/* Do reset before unlock to prevent races with kcov_remote_start(). */
 386	kcov_reset(kcov);
 387	spin_unlock_irqrestore(&kcov_remote_lock, flags);
 388}
 389
 390static void kcov_disable(struct task_struct *t, struct kcov *kcov)
 391{
 392	kcov_task_reset(t);
 393	if (kcov->remote)
 394		kcov_remote_reset(kcov);
 395	else
 396		kcov_reset(kcov);
 397}
 398
 399static void kcov_get(struct kcov *kcov)
 400{
 401	refcount_inc(&kcov->refcount);
 402}
 403
 404static void kcov_put(struct kcov *kcov)
 405{
 406	if (refcount_dec_and_test(&kcov->refcount)) {
 407		kcov_remote_reset(kcov);
 408		vfree(kcov->area);
 409		kfree(kcov);
 410	}
 411}
 412
 413void kcov_task_exit(struct task_struct *t)
 414{
 415	struct kcov *kcov;
 416	unsigned long flags;
 417
 418	kcov = t->kcov;
 419	if (kcov == NULL)
 420		return;
 421
 422	spin_lock_irqsave(&kcov->lock, flags);
 423	kcov_debug("t = %px, kcov->t = %px\n", t, kcov->t);
 424	/*
 425	 * For KCOV_ENABLE devices we want to make sure that t->kcov->t == t,
 426	 * which comes down to:
 427	 *        WARN_ON(!kcov->remote && kcov->t != t);
 428	 *
 429	 * For KCOV_REMOTE_ENABLE devices, the exiting task is either:
 430	 *
 431	 * 1. A remote task between kcov_remote_start() and kcov_remote_stop().
 432	 *    In this case we should print a warning right away, since a task
 433	 *    shouldn't be exiting when it's in a kcov coverage collection
 434	 *    section. Here t points to the task that is collecting remote
 435	 *    coverage, and t->kcov->t points to the thread that created the
 436	 *    kcov device. Which means that to detect this case we need to
 437	 *    check that t != t->kcov->t, and this gives us the following:
 438	 *        WARN_ON(kcov->remote && kcov->t != t);
 439	 *
 440	 * 2. The task that created kcov exiting without calling KCOV_DISABLE,
 441	 *    and then again we make sure that t->kcov->t == t:
 442	 *        WARN_ON(kcov->remote && kcov->t != t);
 443	 *
 444	 * By combining all three checks into one we get:
 445	 */
 446	if (WARN_ON(kcov->t != t)) {
 447		spin_unlock_irqrestore(&kcov->lock, flags);
 448		return;
 449	}
 450	/* Just to not leave dangling references behind. */
 451	kcov_disable(t, kcov);
 452	spin_unlock_irqrestore(&kcov->lock, flags);
 453	kcov_put(kcov);
 454}
 455
 456static int kcov_mmap(struct file *filep, struct vm_area_struct *vma)
 457{
 458	int res = 0;
 459	void *area;
 460	struct kcov *kcov = vma->vm_file->private_data;
 461	unsigned long size, off;
 462	struct page *page;
 463	unsigned long flags;
 464
 465	area = vmalloc_user(vma->vm_end - vma->vm_start);
 466	if (!area)
 467		return -ENOMEM;
 468
 469	spin_lock_irqsave(&kcov->lock, flags);
 470	size = kcov->size * sizeof(unsigned long);
 471	if (kcov->mode != KCOV_MODE_INIT || vma->vm_pgoff != 0 ||
 472	    vma->vm_end - vma->vm_start != size) {
 473		res = -EINVAL;
 474		goto exit;
 475	}
 476	if (!kcov->area) {
 477		kcov->area = area;
 478		vma->vm_flags |= VM_DONTEXPAND;
 479		spin_unlock_irqrestore(&kcov->lock, flags);
 480		for (off = 0; off < size; off += PAGE_SIZE) {
 481			page = vmalloc_to_page(kcov->area + off);
 482			if (vm_insert_page(vma, vma->vm_start + off, page))
 483				WARN_ONCE(1, "vm_insert_page() failed");
 484		}
 485		return 0;
 486	}
 
 487exit:
 488	spin_unlock_irqrestore(&kcov->lock, flags);
 489	vfree(area);
 490	return res;
 491}
 492
 493static int kcov_open(struct inode *inode, struct file *filep)
 494{
 495	struct kcov *kcov;
 496
 497	kcov = kzalloc(sizeof(*kcov), GFP_KERNEL);
 498	if (!kcov)
 499		return -ENOMEM;
 500	kcov->mode = KCOV_MODE_DISABLED;
 501	kcov->sequence = 1;
 502	refcount_set(&kcov->refcount, 1);
 503	spin_lock_init(&kcov->lock);
 504	filep->private_data = kcov;
 505	return nonseekable_open(inode, filep);
 506}
 507
 508static int kcov_close(struct inode *inode, struct file *filep)
 509{
 510	kcov_put(filep->private_data);
 511	return 0;
 512}
 513
 514static int kcov_get_mode(unsigned long arg)
 515{
 516	if (arg == KCOV_TRACE_PC)
 517		return KCOV_MODE_TRACE_PC;
 518	else if (arg == KCOV_TRACE_CMP)
 519#ifdef CONFIG_KCOV_ENABLE_COMPARISONS
 520		return KCOV_MODE_TRACE_CMP;
 521#else
 522		return -ENOTSUPP;
 523#endif
 524	else
 525		return -EINVAL;
 526}
 527
 528/*
 529 * Fault in a lazily-faulted vmalloc area before it can be used by
 530 * __santizer_cov_trace_pc(), to avoid recursion issues if any code on the
 531 * vmalloc fault handling path is instrumented.
 532 */
 533static void kcov_fault_in_area(struct kcov *kcov)
 534{
 535	unsigned long stride = PAGE_SIZE / sizeof(unsigned long);
 536	unsigned long *area = kcov->area;
 537	unsigned long offset;
 538
 539	for (offset = 0; offset < kcov->size; offset += stride)
 540		READ_ONCE(area[offset]);
 541}
 542
 543static inline bool kcov_check_handle(u64 handle, bool common_valid,
 544				bool uncommon_valid, bool zero_valid)
 545{
 546	if (handle & ~(KCOV_SUBSYSTEM_MASK | KCOV_INSTANCE_MASK))
 547		return false;
 548	switch (handle & KCOV_SUBSYSTEM_MASK) {
 549	case KCOV_SUBSYSTEM_COMMON:
 550		return (handle & KCOV_INSTANCE_MASK) ?
 551			common_valid : zero_valid;
 552	case KCOV_SUBSYSTEM_USB:
 553		return uncommon_valid;
 554	default:
 555		return false;
 556	}
 557	return false;
 558}
 559
 560static int kcov_ioctl_locked(struct kcov *kcov, unsigned int cmd,
 561			     unsigned long arg)
 562{
 563	struct task_struct *t;
 564	unsigned long size, unused;
 565	int mode, i;
 566	struct kcov_remote_arg *remote_arg;
 567	struct kcov_remote *remote;
 568	unsigned long flags;
 569
 570	switch (cmd) {
 571	case KCOV_INIT_TRACE:
 572		/*
 573		 * Enable kcov in trace mode and setup buffer size.
 574		 * Must happen before anything else.
 575		 */
 576		if (kcov->mode != KCOV_MODE_DISABLED)
 577			return -EBUSY;
 578		/*
 579		 * Size must be at least 2 to hold current position and one PC.
 580		 * Later we allocate size * sizeof(unsigned long) memory,
 581		 * that must not overflow.
 582		 */
 583		size = arg;
 584		if (size < 2 || size > INT_MAX / sizeof(unsigned long))
 585			return -EINVAL;
 586		kcov->size = size;
 587		kcov->mode = KCOV_MODE_INIT;
 588		return 0;
 589	case KCOV_ENABLE:
 590		/*
 591		 * Enable coverage for the current task.
 592		 * At this point user must have been enabled trace mode,
 593		 * and mmapped the file. Coverage collection is disabled only
 594		 * at task exit or voluntary by KCOV_DISABLE. After that it can
 595		 * be enabled for another task.
 596		 */
 597		if (kcov->mode != KCOV_MODE_INIT || !kcov->area)
 598			return -EINVAL;
 599		t = current;
 600		if (kcov->t != NULL || t->kcov != NULL)
 601			return -EBUSY;
 602		mode = kcov_get_mode(arg);
 603		if (mode < 0)
 604			return mode;
 605		kcov_fault_in_area(kcov);
 606		kcov->mode = mode;
 607		kcov_start(t, kcov, kcov->size, kcov->area, kcov->mode,
 608				kcov->sequence);
 609		kcov->t = t;
 610		/* Put either in kcov_task_exit() or in KCOV_DISABLE. */
 611		kcov_get(kcov);
 612		return 0;
 613	case KCOV_DISABLE:
 614		/* Disable coverage for the current task. */
 615		unused = arg;
 616		if (unused != 0 || current->kcov != kcov)
 617			return -EINVAL;
 618		t = current;
 619		if (WARN_ON(kcov->t != t))
 620			return -EINVAL;
 621		kcov_disable(t, kcov);
 622		kcov_put(kcov);
 623		return 0;
 624	case KCOV_REMOTE_ENABLE:
 625		if (kcov->mode != KCOV_MODE_INIT || !kcov->area)
 626			return -EINVAL;
 627		t = current;
 628		if (kcov->t != NULL || t->kcov != NULL)
 629			return -EBUSY;
 630		remote_arg = (struct kcov_remote_arg *)arg;
 631		mode = kcov_get_mode(remote_arg->trace_mode);
 632		if (mode < 0)
 633			return mode;
 634		if (remote_arg->area_size > LONG_MAX / sizeof(unsigned long))
 635			return -EINVAL;
 636		kcov->mode = mode;
 637		t->kcov = kcov;
 638		kcov->t = t;
 639		kcov->remote = true;
 640		kcov->remote_size = remote_arg->area_size;
 641		spin_lock_irqsave(&kcov_remote_lock, flags);
 642		for (i = 0; i < remote_arg->num_handles; i++) {
 643			if (!kcov_check_handle(remote_arg->handles[i],
 644						false, true, false)) {
 645				spin_unlock_irqrestore(&kcov_remote_lock,
 646							flags);
 647				kcov_disable(t, kcov);
 648				return -EINVAL;
 649			}
 650			remote = kcov_remote_add(kcov, remote_arg->handles[i]);
 651			if (IS_ERR(remote)) {
 652				spin_unlock_irqrestore(&kcov_remote_lock,
 653							flags);
 654				kcov_disable(t, kcov);
 655				return PTR_ERR(remote);
 656			}
 657		}
 658		if (remote_arg->common_handle) {
 659			if (!kcov_check_handle(remote_arg->common_handle,
 660						true, false, false)) {
 661				spin_unlock_irqrestore(&kcov_remote_lock,
 662							flags);
 663				kcov_disable(t, kcov);
 664				return -EINVAL;
 665			}
 666			remote = kcov_remote_add(kcov,
 667					remote_arg->common_handle);
 668			if (IS_ERR(remote)) {
 669				spin_unlock_irqrestore(&kcov_remote_lock,
 670							flags);
 671				kcov_disable(t, kcov);
 672				return PTR_ERR(remote);
 673			}
 674			t->kcov_handle = remote_arg->common_handle;
 675		}
 676		spin_unlock_irqrestore(&kcov_remote_lock, flags);
 677		/* Put either in kcov_task_exit() or in KCOV_DISABLE. */
 678		kcov_get(kcov);
 679		return 0;
 680	default:
 681		return -ENOTTY;
 682	}
 683}
 684
 685static long kcov_ioctl(struct file *filep, unsigned int cmd, unsigned long arg)
 686{
 687	struct kcov *kcov;
 688	int res;
 689	struct kcov_remote_arg *remote_arg = NULL;
 690	unsigned int remote_num_handles;
 691	unsigned long remote_arg_size;
 692	unsigned long flags;
 
 693
 694	if (cmd == KCOV_REMOTE_ENABLE) {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 695		if (get_user(remote_num_handles, (unsigned __user *)(arg +
 696				offsetof(struct kcov_remote_arg, num_handles))))
 697			return -EFAULT;
 698		if (remote_num_handles > KCOV_REMOTE_MAX_HANDLES)
 699			return -EINVAL;
 700		remote_arg_size = struct_size(remote_arg, handles,
 701					remote_num_handles);
 702		remote_arg = memdup_user((void __user *)arg, remote_arg_size);
 703		if (IS_ERR(remote_arg))
 704			return PTR_ERR(remote_arg);
 705		if (remote_arg->num_handles != remote_num_handles) {
 706			kfree(remote_arg);
 707			return -EINVAL;
 708		}
 709		arg = (unsigned long)remote_arg;
 
 
 
 
 
 
 
 
 
 
 
 710	}
 711
 712	kcov = filep->private_data;
 713	spin_lock_irqsave(&kcov->lock, flags);
 714	res = kcov_ioctl_locked(kcov, cmd, arg);
 715	spin_unlock_irqrestore(&kcov->lock, flags);
 716
 717	kfree(remote_arg);
 718
 719	return res;
 720}
 721
 722static const struct file_operations kcov_fops = {
 723	.open		= kcov_open,
 724	.unlocked_ioctl	= kcov_ioctl,
 725	.compat_ioctl	= kcov_ioctl,
 726	.mmap		= kcov_mmap,
 727	.release        = kcov_close,
 728};
 729
 730/*
 731 * kcov_remote_start() and kcov_remote_stop() can be used to annotate a section
 732 * of code in a kernel background thread or in a softirq to allow kcov to be
 733 * used to collect coverage from that part of code.
 734 *
 735 * The handle argument of kcov_remote_start() identifies a code section that is
 736 * used for coverage collection. A userspace process passes this handle to
 737 * KCOV_REMOTE_ENABLE ioctl to make the used kcov device start collecting
 738 * coverage for the code section identified by this handle.
 739 *
 740 * The usage of these annotations in the kernel code is different depending on
 741 * the type of the kernel thread whose code is being annotated.
 742 *
 743 * For global kernel threads that are spawned in a limited number of instances
 744 * (e.g. one USB hub_event() worker thread is spawned per USB HCD) and for
 745 * softirqs, each instance must be assigned a unique 4-byte instance id. The
 746 * instance id is then combined with a 1-byte subsystem id to get a handle via
 747 * kcov_remote_handle(subsystem_id, instance_id).
 748 *
 749 * For local kernel threads that are spawned from system calls handler when a
 750 * user interacts with some kernel interface (e.g. vhost workers), a handle is
 751 * passed from a userspace process as the common_handle field of the
 752 * kcov_remote_arg struct (note, that the user must generate a handle by using
 753 * kcov_remote_handle() with KCOV_SUBSYSTEM_COMMON as the subsystem id and an
 754 * arbitrary 4-byte non-zero number as the instance id). This common handle
 755 * then gets saved into the task_struct of the process that issued the
 756 * KCOV_REMOTE_ENABLE ioctl. When this process issues system calls that spawn
 757 * kernel threads, the common handle must be retrieved via kcov_common_handle()
 758 * and passed to the spawned threads via custom annotations. Those kernel
 759 * threads must in turn be annotated with kcov_remote_start(common_handle) and
 760 * kcov_remote_stop(). All of the threads that are spawned by the same process
 761 * obtain the same handle, hence the name "common".
 762 *
 763 * See Documentation/dev-tools/kcov.rst for more details.
 764 *
 765 * Internally, kcov_remote_start() looks up the kcov device associated with the
 766 * provided handle, allocates an area for coverage collection, and saves the
 767 * pointers to kcov and area into the current task_struct to allow coverage to
 768 * be collected via __sanitizer_cov_trace_pc().
 769 * In turns kcov_remote_stop() clears those pointers from task_struct to stop
 770 * collecting coverage and copies all collected coverage into the kcov area.
 771 */
 772
 773static inline bool kcov_mode_enabled(unsigned int mode)
 774{
 775	return (mode & ~KCOV_IN_CTXSW) != KCOV_MODE_DISABLED;
 776}
 777
 778static void kcov_remote_softirq_start(struct task_struct *t)
 779{
 780	struct kcov_percpu_data *data = this_cpu_ptr(&kcov_percpu_data);
 781	unsigned int mode;
 782
 783	mode = READ_ONCE(t->kcov_mode);
 784	barrier();
 785	if (kcov_mode_enabled(mode)) {
 786		data->saved_mode = mode;
 787		data->saved_size = t->kcov_size;
 788		data->saved_area = t->kcov_area;
 789		data->saved_sequence = t->kcov_sequence;
 790		data->saved_kcov = t->kcov;
 791		kcov_stop(t);
 792	}
 793}
 794
 795static void kcov_remote_softirq_stop(struct task_struct *t)
 796{
 797	struct kcov_percpu_data *data = this_cpu_ptr(&kcov_percpu_data);
 798
 799	if (data->saved_kcov) {
 800		kcov_start(t, data->saved_kcov, data->saved_size,
 801				data->saved_area, data->saved_mode,
 802				data->saved_sequence);
 803		data->saved_mode = 0;
 804		data->saved_size = 0;
 805		data->saved_area = NULL;
 806		data->saved_sequence = 0;
 807		data->saved_kcov = NULL;
 808	}
 809}
 810
 811void kcov_remote_start(u64 handle)
 812{
 813	struct task_struct *t = current;
 814	struct kcov_remote *remote;
 815	struct kcov *kcov;
 816	unsigned int mode;
 817	void *area;
 818	unsigned int size;
 819	int sequence;
 820	unsigned long flags;
 821
 822	if (WARN_ON(!kcov_check_handle(handle, true, true, true)))
 823		return;
 824	if (!in_task() && !in_serving_softirq())
 825		return;
 826
 827	local_irq_save(flags);
 828
 829	/*
 830	 * Check that kcov_remote_start() is not called twice in background
 831	 * threads nor called by user tasks (with enabled kcov).
 832	 */
 833	mode = READ_ONCE(t->kcov_mode);
 834	if (WARN_ON(in_task() && kcov_mode_enabled(mode))) {
 835		local_irq_restore(flags);
 836		return;
 837	}
 838	/*
 839	 * Check that kcov_remote_start() is not called twice in softirqs.
 840	 * Note, that kcov_remote_start() can be called from a softirq that
 841	 * happened while collecting coverage from a background thread.
 842	 */
 843	if (WARN_ON(in_serving_softirq() && t->kcov_softirq)) {
 844		local_irq_restore(flags);
 845		return;
 846	}
 847
 848	spin_lock(&kcov_remote_lock);
 849	remote = kcov_remote_find(handle);
 850	if (!remote) {
 851		spin_unlock_irqrestore(&kcov_remote_lock, flags);
 
 852		return;
 853	}
 854	kcov_debug("handle = %llx, context: %s\n", handle,
 855			in_task() ? "task" : "softirq");
 856	kcov = remote->kcov;
 857	/* Put in kcov_remote_stop(). */
 858	kcov_get(kcov);
 859	/*
 860	 * Read kcov fields before unlock to prevent races with
 861	 * KCOV_DISABLE / kcov_remote_reset().
 862	 */
 863	mode = kcov->mode;
 864	sequence = kcov->sequence;
 865	if (in_task()) {
 866		size = kcov->remote_size;
 867		area = kcov_remote_area_get(size);
 868	} else {
 869		size = CONFIG_KCOV_IRQ_AREA_SIZE;
 870		area = this_cpu_ptr(&kcov_percpu_data)->irq_area;
 871	}
 872	spin_unlock_irqrestore(&kcov_remote_lock, flags);
 873
 874	/* Can only happen when in_task(). */
 875	if (!area) {
 
 876		area = vmalloc(size * sizeof(unsigned long));
 877		if (!area) {
 878			kcov_put(kcov);
 879			return;
 880		}
 
 881	}
 882
 883	local_irq_save(flags);
 884
 885	/* Reset coverage size. */
 886	*(u64 *)area = 0;
 887
 888	if (in_serving_softirq()) {
 889		kcov_remote_softirq_start(t);
 890		t->kcov_softirq = 1;
 891	}
 892	kcov_start(t, kcov, size, area, mode, sequence);
 893
 894	local_irq_restore(flags);
 895
 896}
 897EXPORT_SYMBOL(kcov_remote_start);
 898
 899static void kcov_move_area(enum kcov_mode mode, void *dst_area,
 900				unsigned int dst_area_size, void *src_area)
 901{
 902	u64 word_size = sizeof(unsigned long);
 903	u64 count_size, entry_size_log;
 904	u64 dst_len, src_len;
 905	void *dst_entries, *src_entries;
 906	u64 dst_occupied, dst_free, bytes_to_move, entries_moved;
 907
 908	kcov_debug("%px %u <= %px %lu\n",
 909		dst_area, dst_area_size, src_area, *(unsigned long *)src_area);
 910
 911	switch (mode) {
 912	case KCOV_MODE_TRACE_PC:
 913		dst_len = READ_ONCE(*(unsigned long *)dst_area);
 914		src_len = *(unsigned long *)src_area;
 915		count_size = sizeof(unsigned long);
 916		entry_size_log = __ilog2_u64(sizeof(unsigned long));
 917		break;
 918	case KCOV_MODE_TRACE_CMP:
 919		dst_len = READ_ONCE(*(u64 *)dst_area);
 920		src_len = *(u64 *)src_area;
 921		count_size = sizeof(u64);
 922		BUILD_BUG_ON(!is_power_of_2(KCOV_WORDS_PER_CMP));
 923		entry_size_log = __ilog2_u64(sizeof(u64) * KCOV_WORDS_PER_CMP);
 924		break;
 925	default:
 926		WARN_ON(1);
 927		return;
 928	}
 929
 930	/* As arm can't divide u64 integers use log of entry size. */
 931	if (dst_len > ((dst_area_size * word_size - count_size) >>
 932				entry_size_log))
 933		return;
 934	dst_occupied = count_size + (dst_len << entry_size_log);
 935	dst_free = dst_area_size * word_size - dst_occupied;
 936	bytes_to_move = min(dst_free, src_len << entry_size_log);
 937	dst_entries = dst_area + dst_occupied;
 938	src_entries = src_area + count_size;
 939	memcpy(dst_entries, src_entries, bytes_to_move);
 940	entries_moved = bytes_to_move >> entry_size_log;
 941
 942	switch (mode) {
 943	case KCOV_MODE_TRACE_PC:
 944		WRITE_ONCE(*(unsigned long *)dst_area, dst_len + entries_moved);
 945		break;
 946	case KCOV_MODE_TRACE_CMP:
 947		WRITE_ONCE(*(u64 *)dst_area, dst_len + entries_moved);
 948		break;
 949	default:
 950		break;
 951	}
 952}
 953
 954/* See the comment before kcov_remote_start() for usage details. */
 955void kcov_remote_stop(void)
 956{
 957	struct task_struct *t = current;
 958	struct kcov *kcov;
 959	unsigned int mode;
 960	void *area;
 961	unsigned int size;
 962	int sequence;
 963	unsigned long flags;
 964
 965	if (!in_task() && !in_serving_softirq())
 966		return;
 967
 968	local_irq_save(flags);
 969
 970	mode = READ_ONCE(t->kcov_mode);
 971	barrier();
 972	if (!kcov_mode_enabled(mode)) {
 973		local_irq_restore(flags);
 974		return;
 975	}
 976	/*
 977	 * When in softirq, check if the corresponding kcov_remote_start()
 978	 * actually found the remote handle and started collecting coverage.
 979	 */
 980	if (in_serving_softirq() && !t->kcov_softirq) {
 981		local_irq_restore(flags);
 982		return;
 983	}
 984	/* Make sure that kcov_softirq is only set when in softirq. */
 985	if (WARN_ON(!in_serving_softirq() && t->kcov_softirq)) {
 986		local_irq_restore(flags);
 987		return;
 988	}
 989
 990	kcov = t->kcov;
 991	area = t->kcov_area;
 992	size = t->kcov_size;
 993	sequence = t->kcov_sequence;
 994
 995	kcov_stop(t);
 996	if (in_serving_softirq()) {
 997		t->kcov_softirq = 0;
 998		kcov_remote_softirq_stop(t);
 999	}
1000
1001	spin_lock(&kcov->lock);
1002	/*
1003	 * KCOV_DISABLE could have been called between kcov_remote_start()
1004	 * and kcov_remote_stop(), hence the sequence check.
1005	 */
1006	if (sequence == kcov->sequence && kcov->remote)
1007		kcov_move_area(kcov->mode, kcov->area, kcov->size, area);
1008	spin_unlock(&kcov->lock);
1009
1010	if (in_task()) {
1011		spin_lock(&kcov_remote_lock);
1012		kcov_remote_area_put(area, size);
1013		spin_unlock(&kcov_remote_lock);
1014	}
1015
1016	local_irq_restore(flags);
1017
1018	/* Get in kcov_remote_start(). */
1019	kcov_put(kcov);
1020}
1021EXPORT_SYMBOL(kcov_remote_stop);
1022
1023/* See the comment before kcov_remote_start() for usage details. */
1024u64 kcov_common_handle(void)
1025{
 
 
1026	return current->kcov_handle;
1027}
1028EXPORT_SYMBOL(kcov_common_handle);
1029
1030static int __init kcov_init(void)
1031{
1032	int cpu;
1033
1034	for_each_possible_cpu(cpu) {
1035		void *area = vmalloc(CONFIG_KCOV_IRQ_AREA_SIZE *
1036				sizeof(unsigned long));
1037		if (!area)
1038			return -ENOMEM;
1039		per_cpu_ptr(&kcov_percpu_data, cpu)->irq_area = area;
1040	}
1041
1042	/*
1043	 * The kcov debugfs file won't ever get removed and thus,
1044	 * there is no need to protect it against removal races. The
1045	 * use of debugfs_create_file_unsafe() is actually safe here.
1046	 */
1047	debugfs_create_file_unsafe("kcov", 0600, NULL, NULL, &kcov_fops);
1048
1049	return 0;
1050}
1051
1052device_initcall(kcov_init);