xref: /linux-6.15/arch/arm64/kernel/mte.c (revision 38ddf7da)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright (C) 2020 ARM Ltd.
4  */
5 
6 #include <linux/bitops.h>
7 #include <linux/cpu.h>
8 #include <linux/kernel.h>
9 #include <linux/mm.h>
10 #include <linux/prctl.h>
11 #include <linux/sched.h>
12 #include <linux/sched/mm.h>
13 #include <linux/string.h>
14 #include <linux/swap.h>
15 #include <linux/swapops.h>
16 #include <linux/thread_info.h>
17 #include <linux/types.h>
18 #include <linux/uio.h>
19 
20 #include <asm/barrier.h>
21 #include <asm/cpufeature.h>
22 #include <asm/mte.h>
23 #include <asm/ptrace.h>
24 #include <asm/sysreg.h>
25 
26 static DEFINE_PER_CPU_READ_MOSTLY(u64, mte_tcf_preferred);
27 
28 #ifdef CONFIG_KASAN_HW_TAGS
29 /*
30  * The asynchronous and asymmetric MTE modes have the same behavior for
31  * store operations. This flag is set when either of these modes is enabled.
32  */
33 DEFINE_STATIC_KEY_FALSE(mte_async_or_asymm_mode);
34 EXPORT_SYMBOL_GPL(mte_async_or_asymm_mode);
35 #endif
36 
37 static void mte_sync_page_tags(struct page *page, pte_t old_pte,
38 			       bool check_swap, bool pte_is_tagged)
39 {
40 	if (check_swap && is_swap_pte(old_pte)) {
41 		swp_entry_t entry = pte_to_swp_entry(old_pte);
42 
43 		if (!non_swap_entry(entry) && mte_restore_tags(entry, page))
44 			return;
45 	}
46 
47 	if (!pte_is_tagged)
48 		return;
49 
50 	page_kasan_tag_reset(page);
51 	/*
52 	 * We need smp_wmb() in between setting the flags and clearing the
53 	 * tags because if another thread reads page->flags and builds a
54 	 * tagged address out of it, there is an actual dependency to the
55 	 * memory access, but on the current thread we do not guarantee that
56 	 * the new page->flags are visible before the tags were updated.
57 	 */
58 	smp_wmb();
59 	mte_clear_page_tags(page_address(page));
60 }
61 
62 void mte_sync_tags(pte_t old_pte, pte_t pte)
63 {
64 	struct page *page = pte_page(pte);
65 	long i, nr_pages = compound_nr(page);
66 	bool check_swap = nr_pages == 1;
67 	bool pte_is_tagged = pte_tagged(pte);
68 
69 	/* Early out if there's nothing to do */
70 	if (!check_swap && !pte_is_tagged)
71 		return;
72 
73 	/* if PG_mte_tagged is set, tags have already been initialised */
74 	for (i = 0; i < nr_pages; i++, page++) {
75 		if (!test_and_set_bit(PG_mte_tagged, &page->flags))
76 			mte_sync_page_tags(page, old_pte, check_swap,
77 					   pte_is_tagged);
78 	}
79 }
80 
81 int memcmp_pages(struct page *page1, struct page *page2)
82 {
83 	char *addr1, *addr2;
84 	int ret;
85 
86 	addr1 = page_address(page1);
87 	addr2 = page_address(page2);
88 	ret = memcmp(addr1, addr2, PAGE_SIZE);
89 
90 	if (!system_supports_mte() || ret)
91 		return ret;
92 
93 	/*
94 	 * If the page content is identical but at least one of the pages is
95 	 * tagged, return non-zero to avoid KSM merging. If only one of the
96 	 * pages is tagged, set_pte_at() may zero or change the tags of the
97 	 * other page via mte_sync_tags().
98 	 */
99 	if (test_bit(PG_mte_tagged, &page1->flags) ||
100 	    test_bit(PG_mte_tagged, &page2->flags))
101 		return addr1 != addr2;
102 
103 	return ret;
104 }
105 
106 static inline void __mte_enable_kernel(const char *mode, unsigned long tcf)
107 {
108 	/* Enable MTE Sync Mode for EL1. */
109 	sysreg_clear_set(sctlr_el1, SCTLR_ELx_TCF_MASK, tcf);
110 	isb();
111 
112 	pr_info_once("MTE: enabled in %s mode at EL1\n", mode);
113 }
114 
115 #ifdef CONFIG_KASAN_HW_TAGS
116 void mte_enable_kernel_sync(void)
117 {
118 	/*
119 	 * Make sure we enter this function when no PE has set
120 	 * async mode previously.
121 	 */
122 	WARN_ONCE(system_uses_mte_async_or_asymm_mode(),
123 			"MTE async mode enabled system wide!");
124 
125 	__mte_enable_kernel("synchronous", SCTLR_ELx_TCF_SYNC);
126 }
127 
128 void mte_enable_kernel_async(void)
129 {
130 	__mte_enable_kernel("asynchronous", SCTLR_ELx_TCF_ASYNC);
131 
132 	/*
133 	 * MTE async mode is set system wide by the first PE that
134 	 * executes this function.
135 	 *
136 	 * Note: If in future KASAN acquires a runtime switching
137 	 * mode in between sync and async, this strategy needs
138 	 * to be reviewed.
139 	 */
140 	if (!system_uses_mte_async_or_asymm_mode())
141 		static_branch_enable(&mte_async_or_asymm_mode);
142 }
143 
144 void mte_enable_kernel_asymm(void)
145 {
146 	if (cpus_have_cap(ARM64_MTE_ASYMM)) {
147 		__mte_enable_kernel("asymmetric", SCTLR_ELx_TCF_ASYMM);
148 
149 		/*
150 		 * MTE asymm mode behaves as async mode for store
151 		 * operations. The mode is set system wide by the
152 		 * first PE that executes this function.
153 		 *
154 		 * Note: If in future KASAN acquires a runtime switching
155 		 * mode in between sync and async, this strategy needs
156 		 * to be reviewed.
157 		 */
158 		if (!system_uses_mte_async_or_asymm_mode())
159 			static_branch_enable(&mte_async_or_asymm_mode);
160 	} else {
161 		/*
162 		 * If the CPU does not support MTE asymmetric mode the
163 		 * kernel falls back on synchronous mode which is the
164 		 * default for kasan=on.
165 		 */
166 		mte_enable_kernel_sync();
167 	}
168 }
169 #endif
170 
171 #ifdef CONFIG_KASAN_HW_TAGS
172 void mte_check_tfsr_el1(void)
173 {
174 	u64 tfsr_el1 = read_sysreg_s(SYS_TFSR_EL1);
175 
176 	if (unlikely(tfsr_el1 & SYS_TFSR_EL1_TF1)) {
177 		/*
178 		 * Note: isb() is not required after this direct write
179 		 * because there is no indirect read subsequent to it
180 		 * (per ARM DDI 0487F.c table D13-1).
181 		 */
182 		write_sysreg_s(0, SYS_TFSR_EL1);
183 
184 		kasan_report_async();
185 	}
186 }
187 #endif
188 
189 static void mte_update_sctlr_user(struct task_struct *task)
190 {
191 	/*
192 	 * This must be called with preemption disabled and can only be called
193 	 * on the current or next task since the CPU must match where the thread
194 	 * is going to run. The caller is responsible for calling
195 	 * update_sctlr_el1() later in the same preemption disabled block.
196 	 */
197 	unsigned long sctlr = task->thread.sctlr_user;
198 	unsigned long mte_ctrl = task->thread.mte_ctrl;
199 	unsigned long pref, resolved_mte_tcf;
200 
201 	pref = __this_cpu_read(mte_tcf_preferred);
202 	resolved_mte_tcf = (mte_ctrl & pref) ? pref : mte_ctrl;
203 	sctlr &= ~SCTLR_EL1_TCF0_MASK;
204 	if (resolved_mte_tcf & MTE_CTRL_TCF_ASYNC)
205 		sctlr |= SCTLR_EL1_TCF0_ASYNC;
206 	else if (resolved_mte_tcf & MTE_CTRL_TCF_SYNC)
207 		sctlr |= SCTLR_EL1_TCF0_SYNC;
208 	task->thread.sctlr_user = sctlr;
209 }
210 
211 static void mte_update_gcr_excl(struct task_struct *task)
212 {
213 	/*
214 	 * SYS_GCR_EL1 will be set to current->thread.mte_ctrl value by
215 	 * mte_set_user_gcr() in kernel_exit, but only if KASAN is enabled.
216 	 */
217 	if (kasan_hw_tags_enabled())
218 		return;
219 
220 	write_sysreg_s(
221 		((task->thread.mte_ctrl >> MTE_CTRL_GCR_USER_EXCL_SHIFT) &
222 		 SYS_GCR_EL1_EXCL_MASK) | SYS_GCR_EL1_RRND,
223 		SYS_GCR_EL1);
224 }
225 
226 void __init kasan_hw_tags_enable(struct alt_instr *alt, __le32 *origptr,
227 				 __le32 *updptr, int nr_inst)
228 {
229 	BUG_ON(nr_inst != 1); /* Branch -> NOP */
230 
231 	if (kasan_hw_tags_enabled())
232 		*updptr = cpu_to_le32(aarch64_insn_gen_nop());
233 }
234 
235 void mte_thread_init_user(void)
236 {
237 	if (!system_supports_mte())
238 		return;
239 
240 	/* clear any pending asynchronous tag fault */
241 	dsb(ish);
242 	write_sysreg_s(0, SYS_TFSRE0_EL1);
243 	clear_thread_flag(TIF_MTE_ASYNC_FAULT);
244 	/* disable tag checking and reset tag generation mask */
245 	set_mte_ctrl(current, 0);
246 }
247 
248 void mte_thread_switch(struct task_struct *next)
249 {
250 	if (!system_supports_mte())
251 		return;
252 
253 	mte_update_sctlr_user(next);
254 	mte_update_gcr_excl(next);
255 
256 	/* TCO may not have been disabled on exception entry for the current task. */
257 	mte_disable_tco_entry(next);
258 
259 	/*
260 	 * Check if an async tag exception occurred at EL1.
261 	 *
262 	 * Note: On the context switch path we rely on the dsb() present
263 	 * in __switch_to() to guarantee that the indirect writes to TFSR_EL1
264 	 * are synchronized before this point.
265 	 */
266 	isb();
267 	mte_check_tfsr_el1();
268 }
269 
270 void mte_suspend_enter(void)
271 {
272 	if (!system_supports_mte())
273 		return;
274 
275 	/*
276 	 * The barriers are required to guarantee that the indirect writes
277 	 * to TFSR_EL1 are synchronized before we report the state.
278 	 */
279 	dsb(nsh);
280 	isb();
281 
282 	/* Report SYS_TFSR_EL1 before suspend entry */
283 	mte_check_tfsr_el1();
284 }
285 
286 long set_mte_ctrl(struct task_struct *task, unsigned long arg)
287 {
288 	u64 mte_ctrl = (~((arg & PR_MTE_TAG_MASK) >> PR_MTE_TAG_SHIFT) &
289 			SYS_GCR_EL1_EXCL_MASK) << MTE_CTRL_GCR_USER_EXCL_SHIFT;
290 
291 	if (!system_supports_mte())
292 		return 0;
293 
294 	if (arg & PR_MTE_TCF_ASYNC)
295 		mte_ctrl |= MTE_CTRL_TCF_ASYNC;
296 	if (arg & PR_MTE_TCF_SYNC)
297 		mte_ctrl |= MTE_CTRL_TCF_SYNC;
298 
299 	task->thread.mte_ctrl = mte_ctrl;
300 	if (task == current) {
301 		preempt_disable();
302 		mte_update_sctlr_user(task);
303 		mte_update_gcr_excl(task);
304 		update_sctlr_el1(task->thread.sctlr_user);
305 		preempt_enable();
306 	}
307 
308 	return 0;
309 }
310 
311 long get_mte_ctrl(struct task_struct *task)
312 {
313 	unsigned long ret;
314 	u64 mte_ctrl = task->thread.mte_ctrl;
315 	u64 incl = (~mte_ctrl >> MTE_CTRL_GCR_USER_EXCL_SHIFT) &
316 		   SYS_GCR_EL1_EXCL_MASK;
317 
318 	if (!system_supports_mte())
319 		return 0;
320 
321 	ret = incl << PR_MTE_TAG_SHIFT;
322 	if (mte_ctrl & MTE_CTRL_TCF_ASYNC)
323 		ret |= PR_MTE_TCF_ASYNC;
324 	if (mte_ctrl & MTE_CTRL_TCF_SYNC)
325 		ret |= PR_MTE_TCF_SYNC;
326 
327 	return ret;
328 }
329 
330 /*
331  * Access MTE tags in another process' address space as given in mm. Update
332  * the number of tags copied. Return 0 if any tags copied, error otherwise.
333  * Inspired by __access_remote_vm().
334  */
335 static int __access_remote_tags(struct mm_struct *mm, unsigned long addr,
336 				struct iovec *kiov, unsigned int gup_flags)
337 {
338 	struct vm_area_struct *vma;
339 	void __user *buf = kiov->iov_base;
340 	size_t len = kiov->iov_len;
341 	int ret;
342 	int write = gup_flags & FOLL_WRITE;
343 
344 	if (!access_ok(buf, len))
345 		return -EFAULT;
346 
347 	if (mmap_read_lock_killable(mm))
348 		return -EIO;
349 
350 	while (len) {
351 		unsigned long tags, offset;
352 		void *maddr;
353 		struct page *page = NULL;
354 
355 		ret = get_user_pages_remote(mm, addr, 1, gup_flags, &page,
356 					    &vma, NULL);
357 		if (ret <= 0)
358 			break;
359 
360 		/*
361 		 * Only copy tags if the page has been mapped as PROT_MTE
362 		 * (PG_mte_tagged set). Otherwise the tags are not valid and
363 		 * not accessible to user. Moreover, an mprotect(PROT_MTE)
364 		 * would cause the existing tags to be cleared if the page
365 		 * was never mapped with PROT_MTE.
366 		 */
367 		if (!(vma->vm_flags & VM_MTE)) {
368 			ret = -EOPNOTSUPP;
369 			put_page(page);
370 			break;
371 		}
372 		WARN_ON_ONCE(!test_bit(PG_mte_tagged, &page->flags));
373 
374 		/* limit access to the end of the page */
375 		offset = offset_in_page(addr);
376 		tags = min(len, (PAGE_SIZE - offset) / MTE_GRANULE_SIZE);
377 
378 		maddr = page_address(page);
379 		if (write) {
380 			tags = mte_copy_tags_from_user(maddr + offset, buf, tags);
381 			set_page_dirty_lock(page);
382 		} else {
383 			tags = mte_copy_tags_to_user(buf, maddr + offset, tags);
384 		}
385 		put_page(page);
386 
387 		/* error accessing the tracer's buffer */
388 		if (!tags)
389 			break;
390 
391 		len -= tags;
392 		buf += tags;
393 		addr += tags * MTE_GRANULE_SIZE;
394 	}
395 	mmap_read_unlock(mm);
396 
397 	/* return an error if no tags copied */
398 	kiov->iov_len = buf - kiov->iov_base;
399 	if (!kiov->iov_len) {
400 		/* check for error accessing the tracee's address space */
401 		if (ret <= 0)
402 			return -EIO;
403 		else
404 			return -EFAULT;
405 	}
406 
407 	return 0;
408 }
409 
410 /*
411  * Copy MTE tags in another process' address space at 'addr' to/from tracer's
412  * iovec buffer. Return 0 on success. Inspired by ptrace_access_vm().
413  */
414 static int access_remote_tags(struct task_struct *tsk, unsigned long addr,
415 			      struct iovec *kiov, unsigned int gup_flags)
416 {
417 	struct mm_struct *mm;
418 	int ret;
419 
420 	mm = get_task_mm(tsk);
421 	if (!mm)
422 		return -EPERM;
423 
424 	if (!tsk->ptrace || (current != tsk->parent) ||
425 	    ((get_dumpable(mm) != SUID_DUMP_USER) &&
426 	     !ptracer_capable(tsk, mm->user_ns))) {
427 		mmput(mm);
428 		return -EPERM;
429 	}
430 
431 	ret = __access_remote_tags(mm, addr, kiov, gup_flags);
432 	mmput(mm);
433 
434 	return ret;
435 }
436 
437 int mte_ptrace_copy_tags(struct task_struct *child, long request,
438 			 unsigned long addr, unsigned long data)
439 {
440 	int ret;
441 	struct iovec kiov;
442 	struct iovec __user *uiov = (void __user *)data;
443 	unsigned int gup_flags = FOLL_FORCE;
444 
445 	if (!system_supports_mte())
446 		return -EIO;
447 
448 	if (get_user(kiov.iov_base, &uiov->iov_base) ||
449 	    get_user(kiov.iov_len, &uiov->iov_len))
450 		return -EFAULT;
451 
452 	if (request == PTRACE_POKEMTETAGS)
453 		gup_flags |= FOLL_WRITE;
454 
455 	/* align addr to the MTE tag granule */
456 	addr &= MTE_GRANULE_MASK;
457 
458 	ret = access_remote_tags(child, addr, &kiov, gup_flags);
459 	if (!ret)
460 		ret = put_user(kiov.iov_len, &uiov->iov_len);
461 
462 	return ret;
463 }
464 
465 static ssize_t mte_tcf_preferred_show(struct device *dev,
466 				      struct device_attribute *attr, char *buf)
467 {
468 	switch (per_cpu(mte_tcf_preferred, dev->id)) {
469 	case MTE_CTRL_TCF_ASYNC:
470 		return sysfs_emit(buf, "async\n");
471 	case MTE_CTRL_TCF_SYNC:
472 		return sysfs_emit(buf, "sync\n");
473 	default:
474 		return sysfs_emit(buf, "???\n");
475 	}
476 }
477 
478 static ssize_t mte_tcf_preferred_store(struct device *dev,
479 				       struct device_attribute *attr,
480 				       const char *buf, size_t count)
481 {
482 	u64 tcf;
483 
484 	if (sysfs_streq(buf, "async"))
485 		tcf = MTE_CTRL_TCF_ASYNC;
486 	else if (sysfs_streq(buf, "sync"))
487 		tcf = MTE_CTRL_TCF_SYNC;
488 	else
489 		return -EINVAL;
490 
491 	device_lock(dev);
492 	per_cpu(mte_tcf_preferred, dev->id) = tcf;
493 	device_unlock(dev);
494 
495 	return count;
496 }
497 static DEVICE_ATTR_RW(mte_tcf_preferred);
498 
499 static int register_mte_tcf_preferred_sysctl(void)
500 {
501 	unsigned int cpu;
502 
503 	if (!system_supports_mte())
504 		return 0;
505 
506 	for_each_possible_cpu(cpu) {
507 		per_cpu(mte_tcf_preferred, cpu) = MTE_CTRL_TCF_ASYNC;
508 		device_create_file(get_cpu_device(cpu),
509 				   &dev_attr_mte_tcf_preferred);
510 	}
511 
512 	return 0;
513 }
514 subsys_initcall(register_mte_tcf_preferred_sysctl);
515