task_mmu.c 44.7 KB
Newer Older
1
// SPDX-License-Identifier: GPL-2.0
L
Linus Torvalds 已提交
2
#include <linux/mm.h>
D
Davidlohr Bueso 已提交
3
#include <linux/vmacache.h>
L
Linus Torvalds 已提交
4
#include <linux/hugetlb.h>
5
#include <linux/huge_mm.h>
L
Linus Torvalds 已提交
6 7
#include <linux/mount.h>
#include <linux/seq_file.h>
M
Mauricio Lin 已提交
8
#include <linux/highmem.h>
K
Kees Cook 已提交
9
#include <linux/ptrace.h>
10
#include <linux/slab.h>
11 12
#include <linux/pagemap.h>
#include <linux/mempolicy.h>
13
#include <linux/rmap.h>
14
#include <linux/swap.h>
15
#include <linux/sched/mm.h>
16
#include <linux/swapops.h>
17
#include <linux/mmu_notifier.h>
18
#include <linux/page_idle.h>
19
#include <linux/shmem_fs.h>
M
Minchan Kim 已提交
20
#include <linux/uaccess.h>
21
#include <linux/pkeys.h>
M
Mauricio Lin 已提交
22

L
Linus Torvalds 已提交
23
#include <asm/elf.h>
M
Minchan Kim 已提交
24
#include <asm/tlb.h>
M
Mauricio Lin 已提交
25
#include <asm/tlbflush.h>
L
Linus Torvalds 已提交
26 27
#include "internal.h"

28 29
#define SEQ_PUT_DEC(str, val) \
		seq_put_decimal_ull_width(m, str, (val) << (PAGE_SHIFT-10), 8)
30
void task_mem(struct seq_file *m, struct mm_struct *mm)
L
Linus Torvalds 已提交
31
{
32
	unsigned long text, lib, swap, anon, file, shmem;
33 34
	unsigned long hiwater_vm, total_vm, hiwater_rss, total_rss;

35 36 37 38
	anon = get_mm_counter(mm, MM_ANONPAGES);
	file = get_mm_counter(mm, MM_FILEPAGES);
	shmem = get_mm_counter(mm, MM_SHMEMPAGES);

39 40 41 42 43 44 45 46 47 48
	/*
	 * Note: to minimize their overhead, mm maintains hiwater_vm and
	 * hiwater_rss only when about to *lower* total_vm or rss.  Any
	 * collector of these hiwater stats must therefore get total_vm
	 * and rss too, which will usually be the higher.  Barriers? not
	 * worth the effort, such snapshots can always be inconsistent.
	 */
	hiwater_vm = total_vm = mm->total_vm;
	if (hiwater_vm < mm->hiwater_vm)
		hiwater_vm = mm->hiwater_vm;
49
	hiwater_rss = total_rss = anon + file + shmem;
50 51
	if (hiwater_rss < mm->hiwater_rss)
		hiwater_rss = mm->hiwater_rss;
L
Linus Torvalds 已提交
52

53 54 55 56 57
	/* split executable areas between text and lib */
	text = PAGE_ALIGN(mm->end_code) - (mm->start_code & PAGE_MASK);
	text = min(text, mm->exec_vm << PAGE_SHIFT);
	lib = (mm->exec_vm << PAGE_SHIFT) - text;

K
KAMEZAWA Hiroyuki 已提交
58
	swap = get_mm_counter(mm, MM_SWAPENTS);
59 60 61
	SEQ_PUT_DEC("VmPeak:\t", hiwater_vm);
	SEQ_PUT_DEC(" kB\nVmSize:\t", total_vm);
	SEQ_PUT_DEC(" kB\nVmLck:\t", mm->locked_vm);
62
	SEQ_PUT_DEC(" kB\nVmPin:\t", atomic64_read(&mm->pinned_vm));
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
	SEQ_PUT_DEC(" kB\nVmHWM:\t", hiwater_rss);
	SEQ_PUT_DEC(" kB\nVmRSS:\t", total_rss);
	SEQ_PUT_DEC(" kB\nRssAnon:\t", anon);
	SEQ_PUT_DEC(" kB\nRssFile:\t", file);
	SEQ_PUT_DEC(" kB\nRssShmem:\t", shmem);
	SEQ_PUT_DEC(" kB\nVmData:\t", mm->data_vm);
	SEQ_PUT_DEC(" kB\nVmStk:\t", mm->stack_vm);
	seq_put_decimal_ull_width(m,
		    " kB\nVmExe:\t", text >> 10, 8);
	seq_put_decimal_ull_width(m,
		    " kB\nVmLib:\t", lib >> 10, 8);
	seq_put_decimal_ull_width(m,
		    " kB\nVmPTE:\t", mm_pgtables_bytes(mm) >> 10, 8);
	SEQ_PUT_DEC(" kB\nVmSwap:\t", swap);
	seq_puts(m, " kB\n");
78
	hugetlb_report_usage(m, mm);
L
Linus Torvalds 已提交
79
}
80
#undef SEQ_PUT_DEC
L
Linus Torvalds 已提交
81 82 83 84 85 86

unsigned long task_vsize(struct mm_struct *mm)
{
	return PAGE_SIZE * mm->total_vm;
}

87 88 89
unsigned long task_statm(struct mm_struct *mm,
			 unsigned long *shared, unsigned long *text,
			 unsigned long *data, unsigned long *resident)
L
Linus Torvalds 已提交
90
{
91 92
	*shared = get_mm_counter(mm, MM_FILEPAGES) +
			get_mm_counter(mm, MM_SHMEMPAGES);
L
Linus Torvalds 已提交
93 94
	*text = (PAGE_ALIGN(mm->end_code) - (mm->start_code & PAGE_MASK))
								>> PAGE_SHIFT;
95
	*data = mm->data_vm + mm->stack_vm;
K
KAMEZAWA Hiroyuki 已提交
96
	*resident = *shared + get_mm_counter(mm, MM_ANONPAGES);
L
Linus Torvalds 已提交
97 98 99
	return mm->total_vm;
}

100 101
#ifdef CONFIG_NUMA
/*
102
 * Save get_task_policy() for show_numa_map().
103 104 105 106 107 108
 */
static void hold_task_mempolicy(struct proc_maps_private *priv)
{
	struct task_struct *task = priv->task;

	task_lock(task);
109
	priv->task_mempolicy = get_task_policy(task);
110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
	mpol_get(priv->task_mempolicy);
	task_unlock(task);
}
static void release_task_mempolicy(struct proc_maps_private *priv)
{
	mpol_put(priv->task_mempolicy);
}
#else
static void hold_task_mempolicy(struct proc_maps_private *priv)
{
}
static void release_task_mempolicy(struct proc_maps_private *priv)
{
}
#endif

126
static void vma_stop(struct proc_maps_private *priv)
127
{
128 129 130 131 132
	struct mm_struct *mm = priv->mm;

	release_task_mempolicy(priv);
	up_read(&mm->mmap_sem);
	mmput(mm);
133
}
134

135 136 137 138 139 140 141 142
static struct vm_area_struct *
m_next_vma(struct proc_maps_private *priv, struct vm_area_struct *vma)
{
	if (vma == priv->tail_vma)
		return NULL;
	return vma->vm_next ?: priv->tail_vma;
}

143 144 145
static void m_cache_vma(struct seq_file *m, struct vm_area_struct *vma)
{
	if (m->count < m->size)	/* vma is copied successfully */
146
		m->version = m_next_vma(m->private, vma) ? vma->vm_end : -1UL;
147 148
}

149
static void *m_start(struct seq_file *m, loff_t *ppos)
M
Mauricio Lin 已提交
150
{
151
	struct proc_maps_private *priv = m->private;
152
	unsigned long last_addr = m->version;
153
	struct mm_struct *mm;
154 155
	struct vm_area_struct *vma;
	unsigned int pos = *ppos;
156

157 158 159 160
	/* See m_cache_vma(). Zero at the start or after lseek. */
	if (last_addr == -1UL)
		return NULL;

161
	priv->task = get_proc_task(priv->inode);
162
	if (!priv->task)
A
Al Viro 已提交
163
		return ERR_PTR(-ESRCH);
164

165
	mm = priv->mm;
V
Vegard Nossum 已提交
166
	if (!mm || !mmget_not_zero(mm))
167
		return NULL;
168

169 170 171 172 173
	if (down_read_killable(&mm->mmap_sem)) {
		mmput(mm);
		return ERR_PTR(-EINTR);
	}

174
	hold_task_mempolicy(priv);
175
	priv->tail_vma = get_gate_vma(mm);
176

177
	if (last_addr) {
178 179 180 181
		vma = find_vma(mm, last_addr - 1);
		if (vma && vma->vm_start <= last_addr)
			vma = m_next_vma(priv, vma);
		if (vma)
182 183 184 185
			return vma;
	}

	m->version = 0;
186
	if (pos < mm->map_count) {
187 188
		for (vma = mm->mmap; pos; pos--) {
			m->version = vma->vm_start;
189
			vma = vma->vm_next;
190
		}
191
		return vma;
192
	}
193

194
	/* we do not bother to update m->version in this case */
195 196
	if (pos == mm->map_count && priv->tail_vma)
		return priv->tail_vma;
197 198 199

	vma_stop(priv);
	return NULL;
200 201 202 203 204
}

static void *m_next(struct seq_file *m, void *v, loff_t *pos)
{
	struct proc_maps_private *priv = m->private;
205
	struct vm_area_struct *next;
206 207

	(*pos)++;
208
	next = m_next_vma(priv, v);
209 210 211
	if (!next)
		vma_stop(priv);
	return next;
212 213 214 215 216 217
}

static void m_stop(struct seq_file *m, void *v)
{
	struct proc_maps_private *priv = m->private;

218 219
	if (!IS_ERR_OR_NULL(v))
		vma_stop(priv);
220
	if (priv->task) {
221
		put_task_struct(priv->task);
222 223
		priv->task = NULL;
	}
224 225
}

226 227 228 229 230 231 232 233
static int proc_maps_open(struct inode *inode, struct file *file,
			const struct seq_operations *ops, int psize)
{
	struct proc_maps_private *priv = __seq_open_private(file, ops, psize);

	if (!priv)
		return -ENOMEM;

234
	priv->inode = inode;
235 236 237 238 239 240 241 242
	priv->mm = proc_mem_open(inode, PTRACE_MODE_READ);
	if (IS_ERR(priv->mm)) {
		int err = PTR_ERR(priv->mm);

		seq_release_private(inode, file);
		return err;
	}

243 244 245
	return 0;
}

246 247 248 249 250 251 252 253 254 255 256
static int proc_map_release(struct inode *inode, struct file *file)
{
	struct seq_file *seq = file->private_data;
	struct proc_maps_private *priv = seq->private;

	if (priv->mm)
		mmdrop(priv->mm);

	return seq_release_private(inode, file);
}

257
static int do_maps_open(struct inode *inode, struct file *file,
258
			const struct seq_operations *ops)
259
{
260 261
	return proc_maps_open(inode, file, ops,
				sizeof(struct proc_maps_private));
262
}
M
Mauricio Lin 已提交
263

264 265 266 267
/*
 * Indicate if the VMA is a stack for the given task; for
 * /proc/PID/maps that is the stack of the main task.
 */
268
static int is_stack(struct vm_area_struct *vma)
269
{
270 271 272 273 274 275 276
	/*
	 * We make no effort to guess what a given thread considers to be
	 * its "stack".  It's not even well-defined for programs written
	 * languages like Go.
	 */
	return vma->vm_start <= vma->vm_mm->start_stack &&
		vma->vm_end >= vma->vm_mm->start_stack;
277 278
}

279 280 281 282 283 284
static void show_vma_header_prefix(struct seq_file *m,
				   unsigned long start, unsigned long end,
				   vm_flags_t flags, unsigned long long pgoff,
				   dev_t dev, unsigned long ino)
{
	seq_setwidth(m, 25 + sizeof(void *) * 6 - 1);
285 286 287 288 289 290 291 292 293 294 295 296
	seq_put_hex_ll(m, NULL, start, 8);
	seq_put_hex_ll(m, "-", end, 8);
	seq_putc(m, ' ');
	seq_putc(m, flags & VM_READ ? 'r' : '-');
	seq_putc(m, flags & VM_WRITE ? 'w' : '-');
	seq_putc(m, flags & VM_EXEC ? 'x' : '-');
	seq_putc(m, flags & VM_MAYSHARE ? 's' : 'p');
	seq_put_hex_ll(m, " ", pgoff, 8);
	seq_put_hex_ll(m, " ", MAJOR(dev), 2);
	seq_put_hex_ll(m, ":", MINOR(dev), 2);
	seq_put_decimal_ull(m, " ", ino);
	seq_putc(m, ' ');
297 298
}

299
static void
300
show_map_vma(struct seq_file *m, struct vm_area_struct *vma)
L
Linus Torvalds 已提交
301
{
M
Mauricio Lin 已提交
302 303
	struct mm_struct *mm = vma->vm_mm;
	struct file *file = vma->vm_file;
304
	vm_flags_t flags = vma->vm_flags;
L
Linus Torvalds 已提交
305
	unsigned long ino = 0;
306
	unsigned long long pgoff = 0;
307
	unsigned long start, end;
L
Linus Torvalds 已提交
308
	dev_t dev = 0;
309
	const char *name = NULL;
L
Linus Torvalds 已提交
310 311

	if (file) {
A
Al Viro 已提交
312
		struct inode *inode = file_inode(vma->vm_file);
L
Linus Torvalds 已提交
313 314
		dev = inode->i_sb->s_dev;
		ino = inode->i_ino;
315
		pgoff = ((loff_t)vma->vm_pgoff) << PAGE_SHIFT;
L
Linus Torvalds 已提交
316 317
	}

318
	start = vma->vm_start;
319
	end = vma->vm_end;
320
	show_vma_header_prefix(m, start, end, flags, pgoff, dev, ino);
L
Linus Torvalds 已提交
321 322 323 324 325

	/*
	 * Print the dentry name for named mappings, and a
	 * special [heap] marker for the heap:
	 */
M
Mauricio Lin 已提交
326
	if (file) {
327
		seq_pad(m, ' ');
M
Miklos Szeredi 已提交
328
		seq_file_path(m, file, "\n");
329 330 331
		goto done;
	}

332 333 334 335 336 337
	if (vma->vm_ops && vma->vm_ops->name) {
		name = vma->vm_ops->name(vma);
		if (name)
			goto done;
	}

338 339 340 341 342 343 344 345 346 347 348 349 350
	name = arch_vma_name(vma);
	if (!name) {
		if (!mm) {
			name = "[vdso]";
			goto done;
		}

		if (vma->vm_start <= mm->brk &&
		    vma->vm_end >= mm->start_brk) {
			name = "[heap]";
			goto done;
		}

351
		if (is_stack(vma))
352
			name = "[stack]";
353 354 355 356
	}

done:
	if (name) {
357
		seq_pad(m, ' ');
358
		seq_puts(m, name);
L
Linus Torvalds 已提交
359 360
	}
	seq_putc(m, '\n');
361 362
}

363
static int show_map(struct seq_file *m, void *v)
364
{
365
	show_map_vma(m, v);
366
	m_cache_vma(m, v);
L
Linus Torvalds 已提交
367 368 369
	return 0;
}

370
static const struct seq_operations proc_pid_maps_op = {
371 372 373
	.start	= m_start,
	.next	= m_next,
	.stop	= m_stop,
374
	.show	= show_map
375 376
};

377
static int pid_maps_open(struct inode *inode, struct file *file)
378 379 380 381
{
	return do_maps_open(inode, file, &proc_pid_maps_op);
}

382 383 384 385
const struct file_operations proc_pid_maps_operations = {
	.open		= pid_maps_open,
	.read		= seq_read,
	.llseek		= seq_lseek,
386
	.release	= proc_map_release,
387 388
};

389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407
/*
 * Proportional Set Size(PSS): my share of RSS.
 *
 * PSS of a process is the count of pages it has in memory, where each
 * page is divided by the number of processes sharing it.  So if a
 * process has 1000 pages all to itself, and 1000 shared with one other
 * process, its PSS will be 1500.
 *
 * To keep (accumulated) division errors low, we adopt a 64bit
 * fixed-point pss counter to minimize division errors. So (pss >>
 * PSS_SHIFT) would be the real byte count.
 *
 * A shift of 12 before division means (assuming 4K page size):
 * 	- 1M 3-user-pages add up to 8KB errors;
 * 	- supports mapcount up to 2^24, or 16M;
 * 	- supports PSS up to 2^52 bytes, or 4PB.
 */
#define PSS_SHIFT 12

408
#ifdef CONFIG_PROC_PAGE_MONITOR
P
Peter Zijlstra 已提交
409
struct mem_size_stats {
410 411 412 413 414 415
	unsigned long resident;
	unsigned long shared_clean;
	unsigned long shared_dirty;
	unsigned long private_clean;
	unsigned long private_dirty;
	unsigned long referenced;
416
	unsigned long anonymous;
417
	unsigned long lazyfree;
418
	unsigned long anonymous_thp;
419
	unsigned long shmem_thp;
P
Peter Zijlstra 已提交
420
	unsigned long swap;
421 422
	unsigned long shared_hugetlb;
	unsigned long private_hugetlb;
423
	u64 pss;
424
	u64 pss_locked;
425
	u64 swap_pss;
426
	bool check_shmem_swap;
427 428
};

429
static void smaps_account(struct mem_size_stats *mss, struct page *page,
430
		bool compound, bool young, bool dirty, bool locked)
431
{
432
	int i, nr = compound ? 1 << compound_order(page) : 1;
433
	unsigned long size = nr * PAGE_SIZE;
434

435
	if (PageAnon(page)) {
436
		mss->anonymous += size;
437 438 439
		if (!PageSwapBacked(page) && !dirty && !PageDirty(page))
			mss->lazyfree += size;
	}
440 441 442

	mss->resident += size;
	/* Accumulate the size in pages that have been accessed. */
443
	if (young || page_is_young(page) || PageReferenced(page))
444 445
		mss->referenced += size;

446 447 448 449 450 451
	/*
	 * page_count(page) == 1 guarantees the page is mapped exactly once.
	 * If any subpage of the compound page mapped with PTE it would elevate
	 * page_count().
	 */
	if (page_count(page) == 1) {
452 453 454 455 456
		if (dirty || PageDirty(page))
			mss->private_dirty += size;
		else
			mss->private_clean += size;
		mss->pss += (u64)size << PSS_SHIFT;
457 458
		if (locked)
			mss->pss_locked += (u64)size << PSS_SHIFT;
459 460 461 462 463
		return;
	}

	for (i = 0; i < nr; i++, page++) {
		int mapcount = page_mapcount(page);
464
		unsigned long pss = (PAGE_SIZE << PSS_SHIFT);
465 466 467 468 469 470

		if (mapcount >= 2) {
			if (dirty || PageDirty(page))
				mss->shared_dirty += PAGE_SIZE;
			else
				mss->shared_clean += PAGE_SIZE;
471 472 473
			mss->pss += pss / mapcount;
			if (locked)
				mss->pss_locked += pss / mapcount;
474 475 476 477 478
		} else {
			if (dirty || PageDirty(page))
				mss->private_dirty += PAGE_SIZE;
			else
				mss->private_clean += PAGE_SIZE;
479 480 481
			mss->pss += pss;
			if (locked)
				mss->pss_locked += pss;
482
		}
483 484
	}
}
485

486 487 488 489 490 491
#ifdef CONFIG_SHMEM
static int smaps_pte_hole(unsigned long addr, unsigned long end,
		struct mm_walk *walk)
{
	struct mem_size_stats *mss = walk->private;

492 493
	mss->swap += shmem_partial_swap_usage(
			walk->vma->vm_file->f_mapping, addr, end);
494 495 496 497 498

	return 0;
}
#endif

499 500
static void smaps_pte_entry(pte_t *pte, unsigned long addr,
		struct mm_walk *walk)
501 502
{
	struct mem_size_stats *mss = walk->private;
503
	struct vm_area_struct *vma = walk->vma;
504
	bool locked = !!(vma->vm_flags & VM_LOCKED);
505
	struct page *page = NULL;
506

507 508 509 510
	if (pte_present(*pte)) {
		page = vm_normal_page(vma, addr, *pte);
	} else if (is_swap_pte(*pte)) {
		swp_entry_t swpent = pte_to_swp_entry(*pte);
511

512 513 514
		if (!non_swap_entry(swpent)) {
			int mapcount;

515
			mss->swap += PAGE_SIZE;
516 517 518 519 520 521 522 523 524 525
			mapcount = swp_swapcount(swpent);
			if (mapcount >= 2) {
				u64 pss_delta = (u64)PAGE_SIZE << PSS_SHIFT;

				do_div(pss_delta, mapcount);
				mss->swap_pss += pss_delta;
			} else {
				mss->swap_pss += (u64)PAGE_SIZE << PSS_SHIFT;
			}
		} else if (is_migration_entry(swpent))
526
			page = migration_entry_to_page(swpent);
527 528
		else if (is_device_private_entry(swpent))
			page = device_private_entry_to_page(swpent);
529 530
	} else if (unlikely(IS_ENABLED(CONFIG_SHMEM) && mss->check_shmem_swap
							&& pte_none(*pte))) {
531 532 533 534 535
		page = find_get_entry(vma->vm_file->f_mapping,
						linear_page_index(vma, addr));
		if (!page)
			return;

536
		if (xa_is_value(page))
537 538
			mss->swap += PAGE_SIZE;
		else
539
			put_page(page);
540 541

		return;
542
	}
543 544 545

	if (!page)
		return;
546

547
	smaps_account(mss, page, false, pte_young(*pte), pte_dirty(*pte), locked);
548 549
}

550 551 552 553 554
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
static void smaps_pmd_entry(pmd_t *pmd, unsigned long addr,
		struct mm_walk *walk)
{
	struct mem_size_stats *mss = walk->private;
555
	struct vm_area_struct *vma = walk->vma;
556
	bool locked = !!(vma->vm_flags & VM_LOCKED);
557 558 559 560 561 562
	struct page *page;

	/* FOLL_DUMP will return -EFAULT on huge zero page */
	page = follow_trans_huge_pmd(vma, addr, pmd, FOLL_DUMP);
	if (IS_ERR_OR_NULL(page))
		return;
563 564 565 566
	if (PageAnon(page))
		mss->anonymous_thp += HPAGE_PMD_SIZE;
	else if (PageSwapBacked(page))
		mss->shmem_thp += HPAGE_PMD_SIZE;
567 568
	else if (is_zone_device_page(page))
		/* pass */;
569 570
	else
		VM_BUG_ON_PAGE(1, page);
571
	smaps_account(mss, page, true, pmd_young(*pmd), pmd_dirty(*pmd), locked);
572 573 574 575 576 577 578 579
}
#else
static void smaps_pmd_entry(pmd_t *pmd, unsigned long addr,
		struct mm_walk *walk)
{
}
#endif

580
static int smaps_pte_range(pmd_t *pmd, unsigned long addr, unsigned long end,
D
Dave Hansen 已提交
581
			   struct mm_walk *walk)
M
Mauricio Lin 已提交
582
{
583
	struct vm_area_struct *vma = walk->vma;
584
	pte_t *pte;
585
	spinlock_t *ptl;
M
Mauricio Lin 已提交
586

587 588
	ptl = pmd_trans_huge_lock(pmd, vma);
	if (ptl) {
589 590
		if (pmd_present(*pmd))
			smaps_pmd_entry(pmd, addr, walk);
591
		spin_unlock(ptl);
592
		goto out;
593
	}
594 595

	if (pmd_trans_unstable(pmd))
596
		goto out;
597 598 599 600 601
	/*
	 * The mmap_sem held all the way back in m_start() is what
	 * keeps khugepaged out of here and from collapsing things
	 * in here.
	 */
602
	pte = pte_offset_map_lock(vma->vm_mm, pmd, addr, &ptl);
603
	for (; addr != end; pte++, addr += PAGE_SIZE)
604
		smaps_pte_entry(pte, addr, walk);
605
	pte_unmap_unlock(pte - 1, ptl);
606
out:
607
	cond_resched();
608
	return 0;
M
Mauricio Lin 已提交
609 610
}

611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632
static void show_smap_vma_flags(struct seq_file *m, struct vm_area_struct *vma)
{
	/*
	 * Don't forget to update Documentation/ on changes.
	 */
	static const char mnemonics[BITS_PER_LONG][2] = {
		/*
		 * In case if we meet a flag we don't know about.
		 */
		[0 ... (BITS_PER_LONG-1)] = "??",

		[ilog2(VM_READ)]	= "rd",
		[ilog2(VM_WRITE)]	= "wr",
		[ilog2(VM_EXEC)]	= "ex",
		[ilog2(VM_SHARED)]	= "sh",
		[ilog2(VM_MAYREAD)]	= "mr",
		[ilog2(VM_MAYWRITE)]	= "mw",
		[ilog2(VM_MAYEXEC)]	= "me",
		[ilog2(VM_MAYSHARE)]	= "ms",
		[ilog2(VM_GROWSDOWN)]	= "gd",
		[ilog2(VM_PFNMAP)]	= "pf",
		[ilog2(VM_DENYWRITE)]	= "dw",
633 634 635
#ifdef CONFIG_X86_INTEL_MPX
		[ilog2(VM_MPX)]		= "mp",
#endif
636 637 638 639 640 641 642 643 644
		[ilog2(VM_LOCKED)]	= "lo",
		[ilog2(VM_IO)]		= "io",
		[ilog2(VM_SEQ_READ)]	= "sr",
		[ilog2(VM_RAND_READ)]	= "rr",
		[ilog2(VM_DONTCOPY)]	= "dc",
		[ilog2(VM_DONTEXPAND)]	= "de",
		[ilog2(VM_ACCOUNT)]	= "ac",
		[ilog2(VM_NORESERVE)]	= "nr",
		[ilog2(VM_HUGETLB)]	= "ht",
J
Jan Kara 已提交
645
		[ilog2(VM_SYNC)]	= "sf",
646
		[ilog2(VM_ARCH_1)]	= "ar",
647
		[ilog2(VM_WIPEONFORK)]	= "wf",
648
		[ilog2(VM_DONTDUMP)]	= "dd",
649 650 651
#ifdef CONFIG_MEM_SOFT_DIRTY
		[ilog2(VM_SOFTDIRTY)]	= "sd",
#endif
652 653 654 655
		[ilog2(VM_MIXEDMAP)]	= "mm",
		[ilog2(VM_HUGEPAGE)]	= "hg",
		[ilog2(VM_NOHUGEPAGE)]	= "nh",
		[ilog2(VM_MERGEABLE)]	= "mg",
656 657
		[ilog2(VM_UFFD_MISSING)]= "um",
		[ilog2(VM_UFFD_WP)]	= "uw",
658
#ifdef CONFIG_ARCH_HAS_PKEYS
659 660 661 662 663
		/* These come out via ProtectionKey: */
		[ilog2(VM_PKEY_BIT0)]	= "",
		[ilog2(VM_PKEY_BIT1)]	= "",
		[ilog2(VM_PKEY_BIT2)]	= "",
		[ilog2(VM_PKEY_BIT3)]	= "",
664 665
#if VM_PKEY_BIT4
		[ilog2(VM_PKEY_BIT4)]	= "",
666
#endif
667
#endif /* CONFIG_ARCH_HAS_PKEYS */
668 669 670 671 672
	};
	size_t i;

	seq_puts(m, "VmFlags: ");
	for (i = 0; i < BITS_PER_LONG; i++) {
673 674
		if (!mnemonics[i][0])
			continue;
675
		if (vma->vm_flags & (1UL << i)) {
676 677 678
			seq_putc(m, mnemonics[i][0]);
			seq_putc(m, mnemonics[i][1]);
			seq_putc(m, ' ');
679 680 681 682 683
		}
	}
	seq_putc(m, '\n');
}

684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699
#ifdef CONFIG_HUGETLB_PAGE
static int smaps_hugetlb_range(pte_t *pte, unsigned long hmask,
				 unsigned long addr, unsigned long end,
				 struct mm_walk *walk)
{
	struct mem_size_stats *mss = walk->private;
	struct vm_area_struct *vma = walk->vma;
	struct page *page = NULL;

	if (pte_present(*pte)) {
		page = vm_normal_page(vma, addr, *pte);
	} else if (is_swap_pte(*pte)) {
		swp_entry_t swpent = pte_to_swp_entry(*pte);

		if (is_migration_entry(swpent))
			page = migration_entry_to_page(swpent);
700 701
		else if (is_device_private_entry(swpent))
			page = device_private_entry_to_page(swpent);
702 703 704 705 706 707 708 709 710 711 712 713 714
	}
	if (page) {
		int mapcount = page_mapcount(page);

		if (mapcount >= 2)
			mss->shared_hugetlb += huge_page_size(hstate_vma(vma));
		else
			mss->private_hugetlb += huge_page_size(hstate_vma(vma));
	}
	return 0;
}
#endif /* HUGETLB_PAGE */

715 716
static void smap_gather_stats(struct vm_area_struct *vma,
			     struct mem_size_stats *mss)
M
Mauricio Lin 已提交
717
{
D
Dave Hansen 已提交
718 719
	struct mm_walk smaps_walk = {
		.pmd_entry = smaps_pte_range,
720 721 722
#ifdef CONFIG_HUGETLB_PAGE
		.hugetlb_entry = smaps_hugetlb_range,
#endif
D
Dave Hansen 已提交
723 724
		.mm = vma->vm_mm,
	};
M
Mauricio Lin 已提交
725

726
	smaps_walk.private = mss;
727 728

#ifdef CONFIG_SHMEM
729 730
	/* In case of smaps_rollup, reset the value from previous vma */
	mss->check_shmem_swap = false;
731
	if (vma->vm_file && shmem_mapping(vma->vm_file->f_mapping)) {
732 733 734 735 736 737 738 739 740 741 742 743 744 745
		/*
		 * For shared or readonly shmem mappings we know that all
		 * swapped out pages belong to the shmem object, and we can
		 * obtain the swap value much more efficiently. For private
		 * writable mappings, we might have COW pages that are
		 * not affected by the parent swapped out pages of the shmem
		 * object, so we have to distinguish them during the page walk.
		 * Unless we know that the shmem object (or the part mapped by
		 * our VMA) has no swapped out pages at all.
		 */
		unsigned long shmem_swapped = shmem_swap_usage(vma);

		if (!shmem_swapped || (vma->vm_flags & VM_SHARED) ||
					!(vma->vm_flags & VM_WRITE)) {
746
			mss->swap += shmem_swapped;
747
		} else {
748
			mss->check_shmem_swap = true;
749 750
			smaps_walk.pte_hole = smaps_pte_hole;
		}
751 752
	}
#endif
753
	/* mmap_sem is held in m_start */
754
	walk_page_vma(vma, &smaps_walk);
755 756 757 758
}

#define SEQ_PUT_DEC(str, val) \
		seq_put_decimal_ull_width(m, str, (val) >> 10, 8)
759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784

/* Show the contents common for smaps and smaps_rollup */
static void __show_smap(struct seq_file *m, const struct mem_size_stats *mss)
{
	SEQ_PUT_DEC("Rss:            ", mss->resident);
	SEQ_PUT_DEC(" kB\nPss:            ", mss->pss >> PSS_SHIFT);
	SEQ_PUT_DEC(" kB\nShared_Clean:   ", mss->shared_clean);
	SEQ_PUT_DEC(" kB\nShared_Dirty:   ", mss->shared_dirty);
	SEQ_PUT_DEC(" kB\nPrivate_Clean:  ", mss->private_clean);
	SEQ_PUT_DEC(" kB\nPrivate_Dirty:  ", mss->private_dirty);
	SEQ_PUT_DEC(" kB\nReferenced:     ", mss->referenced);
	SEQ_PUT_DEC(" kB\nAnonymous:      ", mss->anonymous);
	SEQ_PUT_DEC(" kB\nLazyFree:       ", mss->lazyfree);
	SEQ_PUT_DEC(" kB\nAnonHugePages:  ", mss->anonymous_thp);
	SEQ_PUT_DEC(" kB\nShmemPmdMapped: ", mss->shmem_thp);
	SEQ_PUT_DEC(" kB\nShared_Hugetlb: ", mss->shared_hugetlb);
	seq_put_decimal_ull_width(m, " kB\nPrivate_Hugetlb: ",
				  mss->private_hugetlb >> 10, 7);
	SEQ_PUT_DEC(" kB\nSwap:           ", mss->swap);
	SEQ_PUT_DEC(" kB\nSwapPss:        ",
					mss->swap_pss >> PSS_SHIFT);
	SEQ_PUT_DEC(" kB\nLocked:         ",
					mss->pss_locked >> PSS_SHIFT);
	seq_puts(m, " kB\n");
}

785 786 787
static int show_smap(struct seq_file *m, void *v)
{
	struct vm_area_struct *vma = v;
788 789 790 791 792 793 794 795 796 797 798 799 800 801 802
	struct mem_size_stats mss;

	memset(&mss, 0, sizeof(mss));

	smap_gather_stats(vma, &mss);

	show_map_vma(m, vma);

	SEQ_PUT_DEC("Size:           ", vma->vm_end - vma->vm_start);
	SEQ_PUT_DEC(" kB\nKernelPageSize: ", vma_kernel_pagesize(vma));
	SEQ_PUT_DEC(" kB\nMMUPageSize:    ", vma_mmu_pagesize(vma));
	seq_puts(m, " kB\n");

	__show_smap(m, &mss);

803 804
	seq_printf(m, "THPeligible:    %d\n", transparent_hugepage_enabled(vma));

805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820
	if (arch_pkeys_enabled())
		seq_printf(m, "ProtectionKey:  %8u\n", vma_pkey(vma));
	show_smap_vma_flags(m, vma);

	m_cache_vma(m, vma);

	return 0;
}

static int show_smaps_rollup(struct seq_file *m, void *v)
{
	struct proc_maps_private *priv = m->private;
	struct mem_size_stats mss;
	struct mm_struct *mm;
	struct vm_area_struct *vma;
	unsigned long last_vma_end = 0;
821 822
	int ret = 0;

823 824 825
	priv->task = get_proc_task(priv->inode);
	if (!priv->task)
		return -ESRCH;
826

827 828 829 830
	mm = priv->mm;
	if (!mm || !mmget_not_zero(mm)) {
		ret = -ESRCH;
		goto out_put_task;
831
	}
832

833
	memset(&mss, 0, sizeof(mss));
834

835 836 837 838
	ret = down_read_killable(&mm->mmap_sem);
	if (ret)
		goto out_put_mm;

839
	hold_task_mempolicy(priv);
840

841 842 843
	for (vma = priv->mm->mmap; vma; vma = vma->vm_next) {
		smap_gather_stats(vma, &mss);
		last_vma_end = vma->vm_end;
844
	}
845 846 847 848 849 850 851 852 853 854 855

	show_vma_header_prefix(m, priv->mm->mmap->vm_start,
			       last_vma_end, 0, 0, 0, 0);
	seq_pad(m, ' ');
	seq_puts(m, "[rollup]\n");

	__show_smap(m, &mss);

	release_task_mempolicy(priv);
	up_read(&mm->mmap_sem);

856 857
out_put_mm:
	mmput(mm);
858 859 860 861
out_put_task:
	put_task_struct(priv->task);
	priv->task = NULL;

862
	return ret;
M
Mauricio Lin 已提交
863
}
864
#undef SEQ_PUT_DEC
M
Mauricio Lin 已提交
865

866
static const struct seq_operations proc_pid_smaps_op = {
867 868 869
	.start	= m_start,
	.next	= m_next,
	.stop	= m_stop,
870
	.show	= show_smap
871 872
};

873
static int pid_smaps_open(struct inode *inode, struct file *file)
874 875 876 877
{
	return do_maps_open(inode, file, &proc_pid_smaps_op);
}

878
static int smaps_rollup_open(struct inode *inode, struct file *file)
879
{
880
	int ret;
881
	struct proc_maps_private *priv;
882 883 884

	priv = kzalloc(sizeof(*priv), GFP_KERNEL_ACCOUNT);
	if (!priv)
885
		return -ENOMEM;
886 887 888 889 890 891 892 893 894 895 896 897

	ret = single_open(file, show_smaps_rollup, priv);
	if (ret)
		goto out_free;

	priv->inode = inode;
	priv->mm = proc_mem_open(inode, PTRACE_MODE_READ);
	if (IS_ERR(priv->mm)) {
		ret = PTR_ERR(priv->mm);

		single_release(inode, file);
		goto out_free;
898
	}
899

900
	return 0;
901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916

out_free:
	kfree(priv);
	return ret;
}

static int smaps_rollup_release(struct inode *inode, struct file *file)
{
	struct seq_file *seq = file->private_data;
	struct proc_maps_private *priv = seq->private;

	if (priv->mm)
		mmdrop(priv->mm);

	kfree(priv);
	return single_release(inode, file);
917 918
}

919 920 921 922
const struct file_operations proc_pid_smaps_operations = {
	.open		= pid_smaps_open,
	.read		= seq_read,
	.llseek		= seq_lseek,
923
	.release	= proc_map_release,
924 925
};

926
const struct file_operations proc_pid_smaps_rollup_operations = {
927
	.open		= smaps_rollup_open,
928 929
	.read		= seq_read,
	.llseek		= seq_lseek,
930
	.release	= smaps_rollup_release,
931 932
};

933 934 935 936
enum clear_refs_types {
	CLEAR_REFS_ALL = 1,
	CLEAR_REFS_ANON,
	CLEAR_REFS_MAPPED,
937
	CLEAR_REFS_SOFT_DIRTY,
938
	CLEAR_REFS_MM_HIWATER_RSS,
939 940 941
	CLEAR_REFS_LAST,
};

942
struct clear_refs_private {
943
	enum clear_refs_types type;
944 945
};

946
#ifdef CONFIG_MEM_SOFT_DIRTY
947 948 949 950 951 952
static inline void clear_soft_dirty(struct vm_area_struct *vma,
		unsigned long addr, pte_t *pte)
{
	/*
	 * The soft-dirty tracker uses #PF-s to catch writes
	 * to pages, so write-protect the pte as well. See the
953
	 * Documentation/admin-guide/mm/soft-dirty.rst for full description
954 955 956
	 * of how soft-dirty works.
	 */
	pte_t ptent = *pte;
957 958

	if (pte_present(ptent)) {
959 960 961 962
		pte_t old_pte;

		old_pte = ptep_modify_prot_start(vma, addr, pte);
		ptent = pte_wrprotect(old_pte);
963
		ptent = pte_clear_soft_dirty(ptent);
964
		ptep_modify_prot_commit(vma, addr, pte, old_pte, ptent);
965 966
	} else if (is_swap_pte(ptent)) {
		ptent = pte_swp_clear_soft_dirty(ptent);
967
		set_pte_at(vma->vm_mm, addr, pte, ptent);
968
	}
969
}
970 971 972 973 974 975
#else
static inline void clear_soft_dirty(struct vm_area_struct *vma,
		unsigned long addr, pte_t *pte)
{
}
#endif
976

977
#if defined(CONFIG_MEM_SOFT_DIRTY) && defined(CONFIG_TRANSPARENT_HUGEPAGE)
978 979 980
static inline void clear_soft_dirty_pmd(struct vm_area_struct *vma,
		unsigned long addr, pmd_t *pmdp)
{
981
	pmd_t old, pmd = *pmdp;
982

983 984
	if (pmd_present(pmd)) {
		/* See comment in change_huge_pmd() */
985 986
		old = pmdp_invalidate(vma, addr, pmdp);
		if (pmd_dirty(old))
987
			pmd = pmd_mkdirty(pmd);
988
		if (pmd_young(old))
989 990 991 992 993 994 995 996 997 998
			pmd = pmd_mkyoung(pmd);

		pmd = pmd_wrprotect(pmd);
		pmd = pmd_clear_soft_dirty(pmd);

		set_pmd_at(vma->vm_mm, addr, pmdp, pmd);
	} else if (is_migration_entry(pmd_to_swp_entry(pmd))) {
		pmd = pmd_swp_clear_soft_dirty(pmd);
		set_pmd_at(vma->vm_mm, addr, pmdp, pmd);
	}
999 1000 1001 1002 1003 1004 1005 1006
}
#else
static inline void clear_soft_dirty_pmd(struct vm_area_struct *vma,
		unsigned long addr, pmd_t *pmdp)
{
}
#endif

1007
static int clear_refs_pte_range(pmd_t *pmd, unsigned long addr,
D
Dave Hansen 已提交
1008
				unsigned long end, struct mm_walk *walk)
1009
{
1010
	struct clear_refs_private *cp = walk->private;
1011
	struct vm_area_struct *vma = walk->vma;
1012 1013 1014 1015
	pte_t *pte, ptent;
	spinlock_t *ptl;
	struct page *page;

1016 1017
	ptl = pmd_trans_huge_lock(pmd, vma);
	if (ptl) {
1018 1019 1020 1021 1022
		if (cp->type == CLEAR_REFS_SOFT_DIRTY) {
			clear_soft_dirty_pmd(vma, addr, pmd);
			goto out;
		}

1023 1024 1025
		if (!pmd_present(*pmd))
			goto out;

1026 1027 1028 1029
		page = pmd_page(*pmd);

		/* Clear accessed and referenced bits. */
		pmdp_test_and_clear_young(vma, addr, pmd);
1030
		test_and_clear_page_young(page);
1031 1032 1033 1034 1035 1036
		ClearPageReferenced(page);
out:
		spin_unlock(ptl);
		return 0;
	}

1037 1038
	if (pmd_trans_unstable(pmd))
		return 0;
1039

1040 1041 1042 1043
	pte = pte_offset_map_lock(vma->vm_mm, pmd, addr, &ptl);
	for (; addr != end; pte++, addr += PAGE_SIZE) {
		ptent = *pte;

1044 1045 1046 1047 1048
		if (cp->type == CLEAR_REFS_SOFT_DIRTY) {
			clear_soft_dirty(vma, addr, pte);
			continue;
		}

1049 1050 1051
		if (!pte_present(ptent))
			continue;

1052 1053 1054 1055 1056 1057
		page = vm_normal_page(vma, addr, ptent);
		if (!page)
			continue;

		/* Clear accessed and referenced bits. */
		ptep_test_and_clear_young(vma, addr, pte);
1058
		test_and_clear_page_young(page);
1059 1060 1061 1062 1063 1064 1065
		ClearPageReferenced(page);
	}
	pte_unmap_unlock(pte - 1, ptl);
	cond_resched();
	return 0;
}

1066 1067 1068 1069 1070 1071
static int clear_refs_test_walk(unsigned long start, unsigned long end,
				struct mm_walk *walk)
{
	struct clear_refs_private *cp = walk->private;
	struct vm_area_struct *vma = walk->vma;

1072 1073 1074
	if (vma->vm_flags & VM_PFNMAP)
		return 1;

1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087
	/*
	 * Writing 1 to /proc/pid/clear_refs affects all pages.
	 * Writing 2 to /proc/pid/clear_refs only affects anonymous pages.
	 * Writing 3 to /proc/pid/clear_refs only affects file mapped pages.
	 * Writing 4 to /proc/pid/clear_refs affects all pages.
	 */
	if (cp->type == CLEAR_REFS_ANON && vma->vm_file)
		return 1;
	if (cp->type == CLEAR_REFS_MAPPED && !vma->vm_file)
		return 1;
	return 0;
}

1088 1089
static ssize_t clear_refs_write(struct file *file, const char __user *buf,
				size_t count, loff_t *ppos)
1090
{
1091
	struct task_struct *task;
1092
	char buffer[PROC_NUMBUF];
1093
	struct mm_struct *mm;
1094
	struct vm_area_struct *vma;
1095
	enum clear_refs_types type;
M
Minchan Kim 已提交
1096
	struct mmu_gather tlb;
1097
	int itype;
A
Alexey Dobriyan 已提交
1098
	int rv;
1099

1100 1101 1102 1103 1104
	memset(buffer, 0, sizeof(buffer));
	if (count > sizeof(buffer) - 1)
		count = sizeof(buffer) - 1;
	if (copy_from_user(buffer, buf, count))
		return -EFAULT;
1105
	rv = kstrtoint(strstrip(buffer), 10, &itype);
A
Alexey Dobriyan 已提交
1106 1107
	if (rv < 0)
		return rv;
1108 1109
	type = (enum clear_refs_types)itype;
	if (type < CLEAR_REFS_ALL || type >= CLEAR_REFS_LAST)
1110
		return -EINVAL;
1111

A
Al Viro 已提交
1112
	task = get_proc_task(file_inode(file));
1113 1114 1115 1116
	if (!task)
		return -ESRCH;
	mm = get_task_mm(task);
	if (mm) {
1117
		struct mmu_notifier_range range;
1118
		struct clear_refs_private cp = {
1119
			.type = type,
1120
		};
1121 1122
		struct mm_walk clear_refs_walk = {
			.pmd_entry = clear_refs_pte_range,
1123
			.test_walk = clear_refs_test_walk,
1124
			.mm = mm,
1125
			.private = &cp,
1126
		};
1127 1128

		if (type == CLEAR_REFS_MM_HIWATER_RSS) {
1129 1130 1131 1132 1133
			if (down_write_killable(&mm->mmap_sem)) {
				count = -EINTR;
				goto out_mm;
			}

1134 1135 1136 1137 1138 1139 1140 1141 1142
			/*
			 * Writing 5 to /proc/pid/clear_refs resets the peak
			 * resident set size to this mm's current rss value.
			 */
			reset_mm_hiwater_rss(mm);
			up_write(&mm->mmap_sem);
			goto out_mm;
		}

1143 1144 1145 1146
		if (down_read_killable(&mm->mmap_sem)) {
			count = -EINTR;
			goto out_mm;
		}
M
Minchan Kim 已提交
1147
		tlb_gather_mmu(&tlb, mm, 0, -1);
1148 1149 1150 1151 1152
		if (type == CLEAR_REFS_SOFT_DIRTY) {
			for (vma = mm->mmap; vma; vma = vma->vm_next) {
				if (!(vma->vm_flags & VM_SOFTDIRTY))
					continue;
				up_read(&mm->mmap_sem);
1153 1154 1155 1156
				if (down_write_killable(&mm->mmap_sem)) {
					count = -EINTR;
					goto out_mm;
				}
1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174
				/*
				 * Avoid to modify vma->vm_flags
				 * without locked ops while the
				 * coredump reads the vm_flags.
				 */
				if (!mmget_still_valid(mm)) {
					/*
					 * Silently return "count"
					 * like if get_task_mm()
					 * failed. FIXME: should this
					 * function have returned
					 * -ESRCH if get_task_mm()
					 * failed like if
					 * get_proc_task() fails?
					 */
					up_write(&mm->mmap_sem);
					goto out_mm;
				}
1175 1176 1177 1178 1179 1180 1181
				for (vma = mm->mmap; vma; vma = vma->vm_next) {
					vma->vm_flags &= ~VM_SOFTDIRTY;
					vma_set_page_prot(vma);
				}
				downgrade_write(&mm->mmap_sem);
				break;
			}
1182

1183 1184
			mmu_notifier_range_init(&range, MMU_NOTIFY_SOFT_DIRTY,
						0, NULL, mm, 0, -1UL);
1185
			mmu_notifier_invalidate_range_start(&range);
1186
		}
1187
		walk_page_range(0, mm->highest_vm_end, &clear_refs_walk);
1188
		if (type == CLEAR_REFS_SOFT_DIRTY)
1189
			mmu_notifier_invalidate_range_end(&range);
M
Minchan Kim 已提交
1190
		tlb_finish_mmu(&tlb, 0, -1);
1191
		up_read(&mm->mmap_sem);
1192
out_mm:
1193 1194 1195
		mmput(mm);
	}
	put_task_struct(task);
1196 1197

	return count;
1198 1199
}

1200 1201
const struct file_operations proc_clear_refs_operations = {
	.write		= clear_refs_write,
1202
	.llseek		= noop_llseek,
1203 1204
};

1205 1206 1207 1208
typedef struct {
	u64 pme;
} pagemap_entry_t;

1209
struct pagemapread {
1210
	int pos, len;		/* units: PM_ENTRY_BYTES, not bytes */
1211
	pagemap_entry_t *buffer;
1212
	bool show_pfn;
1213 1214
};

1215 1216 1217
#define PAGEMAP_WALK_SIZE	(PMD_SIZE)
#define PAGEMAP_WALK_MASK	(PMD_MASK)

1218 1219 1220 1221
#define PM_ENTRY_BYTES		sizeof(pagemap_entry_t)
#define PM_PFRAME_BITS		55
#define PM_PFRAME_MASK		GENMASK_ULL(PM_PFRAME_BITS - 1, 0)
#define PM_SOFT_DIRTY		BIT_ULL(55)
1222
#define PM_MMAP_EXCLUSIVE	BIT_ULL(56)
1223 1224 1225 1226
#define PM_FILE			BIT_ULL(61)
#define PM_SWAP			BIT_ULL(62)
#define PM_PRESENT		BIT_ULL(63)

1227 1228
#define PM_END_OF_BUFFER    1

1229
static inline pagemap_entry_t make_pme(u64 frame, u64 flags)
1230
{
1231
	return (pagemap_entry_t) { .pme = (frame & PM_PFRAME_MASK) | flags };
1232 1233 1234
}

static int add_to_pagemap(unsigned long addr, pagemap_entry_t *pme,
1235 1236
			  struct pagemapread *pm)
{
1237
	pm->buffer[pm->pos++] = *pme;
1238
	if (pm->pos >= pm->len)
1239
		return PM_END_OF_BUFFER;
1240 1241 1242 1243
	return 0;
}

static int pagemap_pte_hole(unsigned long start, unsigned long end,
D
Dave Hansen 已提交
1244
				struct mm_walk *walk)
1245
{
D
Dave Hansen 已提交
1246
	struct pagemapread *pm = walk->private;
1247
	unsigned long addr = start;
1248
	int err = 0;
1249

1250 1251
	while (addr < end) {
		struct vm_area_struct *vma = find_vma(walk->mm, addr);
1252
		pagemap_entry_t pme = make_pme(0, 0);
1253 1254
		/* End of address space hole, which we mark as non-present. */
		unsigned long hole_end;
1255

1256 1257 1258 1259 1260 1261 1262 1263 1264
		if (vma)
			hole_end = min(end, vma->vm_start);
		else
			hole_end = end;

		for (; addr < hole_end; addr += PAGE_SIZE) {
			err = add_to_pagemap(addr, &pme, pm);
			if (err)
				goto out;
1265 1266
		}

1267 1268 1269 1270 1271
		if (!vma)
			break;

		/* Addresses in the VMA. */
		if (vma->vm_flags & VM_SOFTDIRTY)
1272
			pme = make_pme(0, PM_SOFT_DIRTY);
1273
		for (; addr < min(end, vma->vm_end); addr += PAGE_SIZE) {
1274 1275 1276 1277
			err = add_to_pagemap(addr, &pme, pm);
			if (err)
				goto out;
		}
1278
	}
1279
out:
1280 1281 1282
	return err;
}

1283
static pagemap_entry_t pte_to_pagemap_entry(struct pagemapread *pm,
1284
		struct vm_area_struct *vma, unsigned long addr, pte_t pte)
1285
{
1286
	u64 frame = 0, flags = 0;
1287
	struct page *page = NULL;
1288

1289
	if (pte_present(pte)) {
1290 1291
		if (pm->show_pfn)
			frame = pte_pfn(pte);
1292
		flags |= PM_PRESENT;
1293
		page = _vm_normal_page(vma, addr, pte, true);
1294
		if (pte_soft_dirty(pte))
1295
			flags |= PM_SOFT_DIRTY;
1296
	} else if (is_swap_pte(pte)) {
1297 1298
		swp_entry_t entry;
		if (pte_swp_soft_dirty(pte))
1299
			flags |= PM_SOFT_DIRTY;
1300
		entry = pte_to_swp_entry(pte);
1301 1302 1303
		if (pm->show_pfn)
			frame = swp_type(entry) |
				(swp_offset(entry) << MAX_SWAPFILES_SHIFT);
1304
		flags |= PM_SWAP;
1305 1306
		if (is_migration_entry(entry))
			page = migration_entry_to_page(entry);
1307 1308 1309

		if (is_device_private_entry(entry))
			page = device_private_entry_to_page(entry);
1310 1311 1312 1313
	}

	if (page && !PageAnon(page))
		flags |= PM_FILE;
1314 1315
	if (page && page_mapcount(page) == 1)
		flags |= PM_MMAP_EXCLUSIVE;
1316 1317
	if (vma->vm_flags & VM_SOFTDIRTY)
		flags |= PM_SOFT_DIRTY;
1318

1319
	return make_pme(frame, flags);
1320 1321
}

1322
static int pagemap_pmd_range(pmd_t *pmdp, unsigned long addr, unsigned long end,
D
Dave Hansen 已提交
1323
			     struct mm_walk *walk)
1324
{
1325
	struct vm_area_struct *vma = walk->vma;
D
Dave Hansen 已提交
1326
	struct pagemapread *pm = walk->private;
1327
	spinlock_t *ptl;
1328
	pte_t *pte, *orig_pte;
1329 1330
	int err = 0;

1331
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
1332 1333
	ptl = pmd_trans_huge_lock(pmdp, vma);
	if (ptl) {
1334 1335
		u64 flags = 0, frame = 0;
		pmd_t pmd = *pmdp;
1336
		struct page *page = NULL;
1337

1338
		if (vma->vm_flags & VM_SOFTDIRTY)
1339
			flags |= PM_SOFT_DIRTY;
1340

1341
		if (pmd_present(pmd)) {
1342
			page = pmd_page(pmd);
1343

1344
			flags |= PM_PRESENT;
1345 1346
			if (pmd_soft_dirty(pmd))
				flags |= PM_SOFT_DIRTY;
1347 1348 1349
			if (pm->show_pfn)
				frame = pmd_pfn(pmd) +
					((addr & ~PMD_MASK) >> PAGE_SHIFT);
1350
		}
1351 1352 1353
#ifdef CONFIG_ARCH_ENABLE_THP_MIGRATION
		else if (is_swap_pmd(pmd)) {
			swp_entry_t entry = pmd_to_swp_entry(pmd);
1354
			unsigned long offset;
1355

1356 1357 1358 1359 1360 1361
			if (pm->show_pfn) {
				offset = swp_offset(entry) +
					((addr & ~PMD_MASK) >> PAGE_SHIFT);
				frame = swp_type(entry) |
					(offset << MAX_SWAPFILES_SHIFT);
			}
1362
			flags |= PM_SWAP;
1363 1364
			if (pmd_swp_soft_dirty(pmd))
				flags |= PM_SOFT_DIRTY;
1365 1366 1367 1368 1369 1370 1371
			VM_BUG_ON(!is_pmd_migration_entry(pmd));
			page = migration_entry_to_page(entry);
		}
#endif

		if (page && page_mapcount(page) == 1)
			flags |= PM_MMAP_EXCLUSIVE;
1372

1373
		for (; addr != end; addr += PAGE_SIZE) {
1374
			pagemap_entry_t pme = make_pme(frame, flags);
1375

1376
			err = add_to_pagemap(addr, &pme, pm);
1377 1378
			if (err)
				break;
1379 1380 1381 1382 1383 1384
			if (pm->show_pfn) {
				if (flags & PM_PRESENT)
					frame++;
				else if (flags & PM_SWAP)
					frame += (1 << MAX_SWAPFILES_SHIFT);
			}
1385
		}
1386
		spin_unlock(ptl);
1387
		return err;
1388 1389
	}

1390
	if (pmd_trans_unstable(pmdp))
1391
		return 0;
1392
#endif /* CONFIG_TRANSPARENT_HUGEPAGE */
1393

1394 1395 1396 1397
	/*
	 * We can assume that @vma always points to a valid one and @end never
	 * goes beyond vma->vm_end.
	 */
1398
	orig_pte = pte = pte_offset_map_lock(walk->mm, pmdp, addr, &ptl);
1399 1400
	for (; addr < end; pte++, addr += PAGE_SIZE) {
		pagemap_entry_t pme;
1401

1402
		pme = pte_to_pagemap_entry(pm, vma, addr, *pte);
1403
		err = add_to_pagemap(addr, &pme, pm);
1404
		if (err)
1405
			break;
1406
	}
1407
	pte_unmap_unlock(orig_pte, ptl);
1408 1409 1410 1411 1412 1413

	cond_resched();

	return err;
}

1414
#ifdef CONFIG_HUGETLB_PAGE
1415
/* This function walks within one hugetlb entry in the single call */
1416
static int pagemap_hugetlb_range(pte_t *ptep, unsigned long hmask,
1417 1418
				 unsigned long addr, unsigned long end,
				 struct mm_walk *walk)
1419 1420
{
	struct pagemapread *pm = walk->private;
1421
	struct vm_area_struct *vma = walk->vma;
1422
	u64 flags = 0, frame = 0;
1423
	int err = 0;
1424
	pte_t pte;
1425

1426
	if (vma->vm_flags & VM_SOFTDIRTY)
1427
		flags |= PM_SOFT_DIRTY;
1428

1429 1430 1431 1432 1433 1434 1435
	pte = huge_ptep_get(ptep);
	if (pte_present(pte)) {
		struct page *page = pte_page(pte);

		if (!PageAnon(page))
			flags |= PM_FILE;

1436 1437 1438
		if (page_mapcount(page) == 1)
			flags |= PM_MMAP_EXCLUSIVE;

1439
		flags |= PM_PRESENT;
1440 1441 1442
		if (pm->show_pfn)
			frame = pte_pfn(pte) +
				((addr & ~hmask) >> PAGE_SHIFT);
1443 1444
	}

1445
	for (; addr != end; addr += PAGE_SIZE) {
1446 1447
		pagemap_entry_t pme = make_pme(frame, flags);

1448
		err = add_to_pagemap(addr, &pme, pm);
1449 1450
		if (err)
			return err;
1451
		if (pm->show_pfn && (flags & PM_PRESENT))
1452
			frame++;
1453 1454 1455 1456 1457 1458
	}

	cond_resched();

	return err;
}
1459
#endif /* HUGETLB_PAGE */
1460

1461 1462 1463
/*
 * /proc/pid/pagemap - an array mapping virtual pages to pfns
 *
1464 1465 1466
 * For each page in the address space, this file contains one 64-bit entry
 * consisting of the following:
 *
1467
 * Bits 0-54  page frame number (PFN) if present
1468
 * Bits 0-4   swap type if swapped
1469
 * Bits 5-54  swap offset if swapped
1470
 * Bit  55    pte is soft-dirty (see Documentation/admin-guide/mm/soft-dirty.rst)
1471 1472
 * Bit  56    page exclusively mapped
 * Bits 57-60 zero
1473
 * Bit  61    page is file-page or shared-anon
1474 1475 1476 1477 1478 1479
 * Bit  62    page swapped
 * Bit  63    page present
 *
 * If the page is not present but in swap, then the PFN contains an
 * encoding of the swap file number and the page's offset into the
 * swap. Unmapped pages return a null PFN. This allows determining
1480 1481 1482 1483 1484 1485 1486 1487 1488 1489
 * precisely which pages are mapped (or in swap) and comparing mapped
 * pages between processes.
 *
 * Efficient users of this interface will use /proc/pid/maps to
 * determine which areas of memory are actually mapped and llseek to
 * skip over unmapped regions.
 */
static ssize_t pagemap_read(struct file *file, char __user *buf,
			    size_t count, loff_t *ppos)
{
1490
	struct mm_struct *mm = file->private_data;
1491
	struct pagemapread pm;
1492
	struct mm_walk pagemap_walk = {};
1493 1494 1495 1496
	unsigned long src;
	unsigned long svpfn;
	unsigned long start_vaddr;
	unsigned long end_vaddr;
1497
	int ret = 0, copied = 0;
1498

V
Vegard Nossum 已提交
1499
	if (!mm || !mmget_not_zero(mm))
1500 1501 1502 1503
		goto out;

	ret = -EINVAL;
	/* file position must be aligned */
1504
	if ((*ppos % PM_ENTRY_BYTES) || (count % PM_ENTRY_BYTES))
1505
		goto out_mm;
1506 1507

	ret = 0;
1508
	if (!count)
1509
		goto out_mm;
1510

1511 1512 1513
	/* do not disclose physical addresses: attack vector */
	pm.show_pfn = file_ns_capable(file, &init_user_ns, CAP_SYS_ADMIN);

1514
	pm.len = (PAGEMAP_WALK_SIZE >> PAGE_SHIFT);
1515
	pm.buffer = kmalloc_array(pm.len, PM_ENTRY_BYTES, GFP_KERNEL);
1516
	ret = -ENOMEM;
1517
	if (!pm.buffer)
1518
		goto out_mm;
1519

1520
	pagemap_walk.pmd_entry = pagemap_pmd_range;
1521
	pagemap_walk.pte_hole = pagemap_pte_hole;
1522
#ifdef CONFIG_HUGETLB_PAGE
1523
	pagemap_walk.hugetlb_entry = pagemap_hugetlb_range;
1524
#endif
1525 1526 1527 1528 1529 1530
	pagemap_walk.mm = mm;
	pagemap_walk.private = &pm;

	src = *ppos;
	svpfn = src / PM_ENTRY_BYTES;
	start_vaddr = svpfn << PAGE_SHIFT;
1531
	end_vaddr = mm->task_size;
1532 1533

	/* watch out for wraparound */
1534
	if (svpfn > mm->task_size >> PAGE_SHIFT)
1535 1536 1537 1538 1539 1540 1541 1542
		start_vaddr = end_vaddr;

	/*
	 * The odds are that this will stop walking way
	 * before end_vaddr, because the length of the
	 * user buffer is tracked in "pm", and the walk
	 * will stop when we hit the end of the buffer.
	 */
1543 1544 1545 1546 1547 1548
	ret = 0;
	while (count && (start_vaddr < end_vaddr)) {
		int len;
		unsigned long end;

		pm.pos = 0;
1549
		end = (start_vaddr + PAGEMAP_WALK_SIZE) & PAGEMAP_WALK_MASK;
1550 1551 1552
		/* overflow ? */
		if (end < start_vaddr || end > end_vaddr)
			end = end_vaddr;
1553 1554 1555
		ret = down_read_killable(&mm->mmap_sem);
		if (ret)
			goto out_free;
1556 1557 1558 1559 1560
		ret = walk_page_range(start_vaddr, end, &pagemap_walk);
		up_read(&mm->mmap_sem);
		start_vaddr = end;

		len = min(count, PM_ENTRY_BYTES * pm.pos);
1561
		if (copy_to_user(buf, pm.buffer, len)) {
1562
			ret = -EFAULT;
1563
			goto out_free;
1564 1565 1566 1567
		}
		copied += len;
		buf += len;
		count -= len;
1568
	}
1569 1570 1571 1572
	*ppos += copied;
	if (!ret || ret == PM_END_OF_BUFFER)
		ret = copied;

1573 1574
out_free:
	kfree(pm.buffer);
1575 1576
out_mm:
	mmput(mm);
1577 1578 1579 1580
out:
	return ret;
}

1581 1582
static int pagemap_open(struct inode *inode, struct file *file)
{
1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597
	struct mm_struct *mm;

	mm = proc_mem_open(inode, PTRACE_MODE_READ);
	if (IS_ERR(mm))
		return PTR_ERR(mm);
	file->private_data = mm;
	return 0;
}

static int pagemap_release(struct inode *inode, struct file *file)
{
	struct mm_struct *mm = file->private_data;

	if (mm)
		mmdrop(mm);
1598 1599 1600
	return 0;
}

1601 1602 1603
const struct file_operations proc_pagemap_operations = {
	.llseek		= mem_lseek, /* borrow this */
	.read		= pagemap_read,
1604
	.open		= pagemap_open,
1605
	.release	= pagemap_release,
1606
};
1607
#endif /* CONFIG_PROC_PAGE_MONITOR */
1608

1609 1610
#ifdef CONFIG_NUMA

1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621
struct numa_maps {
	unsigned long pages;
	unsigned long anon;
	unsigned long active;
	unsigned long writeback;
	unsigned long mapcount_max;
	unsigned long dirty;
	unsigned long swapcache;
	unsigned long node[MAX_NUMNODES];
};

1622 1623 1624 1625 1626
struct numa_maps_private {
	struct proc_maps_private proc_maps;
	struct numa_maps md;
};

1627 1628
static void gather_stats(struct page *page, struct numa_maps *md, int pte_dirty,
			unsigned long nr_pages)
1629 1630 1631
{
	int count = page_mapcount(page);

1632
	md->pages += nr_pages;
1633
	if (pte_dirty || PageDirty(page))
1634
		md->dirty += nr_pages;
1635 1636

	if (PageSwapCache(page))
1637
		md->swapcache += nr_pages;
1638 1639

	if (PageActive(page) || PageUnevictable(page))
1640
		md->active += nr_pages;
1641 1642

	if (PageWriteback(page))
1643
		md->writeback += nr_pages;
1644 1645

	if (PageAnon(page))
1646
		md->anon += nr_pages;
1647 1648 1649 1650

	if (count > md->mapcount_max)
		md->mapcount_max = count;

1651
	md->node[page_to_nid(page)] += nr_pages;
1652 1653
}

1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670
static struct page *can_gather_numa_stats(pte_t pte, struct vm_area_struct *vma,
		unsigned long addr)
{
	struct page *page;
	int nid;

	if (!pte_present(pte))
		return NULL;

	page = vm_normal_page(vma, addr, pte);
	if (!page)
		return NULL;

	if (PageReserved(page))
		return NULL;

	nid = page_to_nid(page);
1671
	if (!node_isset(nid, node_states[N_MEMORY]))
1672 1673 1674 1675 1676
		return NULL;

	return page;
}

1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
static struct page *can_gather_numa_stats_pmd(pmd_t pmd,
					      struct vm_area_struct *vma,
					      unsigned long addr)
{
	struct page *page;
	int nid;

	if (!pmd_present(pmd))
		return NULL;

	page = vm_normal_page_pmd(vma, addr, pmd);
	if (!page)
		return NULL;

	if (PageReserved(page))
		return NULL;

	nid = page_to_nid(page);
	if (!node_isset(nid, node_states[N_MEMORY]))
		return NULL;

	return page;
}
#endif

1703 1704 1705
static int gather_pte_stats(pmd_t *pmd, unsigned long addr,
		unsigned long end, struct mm_walk *walk)
{
1706 1707
	struct numa_maps *md = walk->private;
	struct vm_area_struct *vma = walk->vma;
1708 1709 1710 1711
	spinlock_t *ptl;
	pte_t *orig_pte;
	pte_t *pte;

1712
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
1713 1714
	ptl = pmd_trans_huge_lock(pmd, vma);
	if (ptl) {
1715 1716
		struct page *page;

1717
		page = can_gather_numa_stats_pmd(*pmd, vma, addr);
1718
		if (page)
1719
			gather_stats(page, md, pmd_dirty(*pmd),
1720
				     HPAGE_PMD_SIZE/PAGE_SIZE);
1721
		spin_unlock(ptl);
1722
		return 0;
1723 1724
	}

1725 1726
	if (pmd_trans_unstable(pmd))
		return 0;
1727
#endif
1728 1729
	orig_pte = pte = pte_offset_map_lock(walk->mm, pmd, addr, &ptl);
	do {
1730
		struct page *page = can_gather_numa_stats(*pte, vma, addr);
1731 1732
		if (!page)
			continue;
1733
		gather_stats(page, md, pte_dirty(*pte), 1);
1734 1735 1736

	} while (pte++, addr += PAGE_SIZE, addr != end);
	pte_unmap_unlock(orig_pte, ptl);
1737
	cond_resched();
1738 1739 1740
	return 0;
}
#ifdef CONFIG_HUGETLB_PAGE
1741
static int gather_hugetlb_stats(pte_t *pte, unsigned long hmask,
1742 1743
		unsigned long addr, unsigned long end, struct mm_walk *walk)
{
1744
	pte_t huge_pte = huge_ptep_get(pte);
1745 1746 1747
	struct numa_maps *md;
	struct page *page;

1748
	if (!pte_present(huge_pte))
1749 1750
		return 0;

1751
	page = pte_page(huge_pte);
1752 1753 1754 1755
	if (!page)
		return 0;

	md = walk->private;
1756
	gather_stats(page, md, pte_dirty(huge_pte), 1);
1757 1758 1759 1760
	return 0;
}

#else
1761
static int gather_hugetlb_stats(pte_t *pte, unsigned long hmask,
1762 1763 1764 1765 1766 1767 1768 1769 1770
		unsigned long addr, unsigned long end, struct mm_walk *walk)
{
	return 0;
}
#endif

/*
 * Display pages allocated per node and memory policy via /proc.
 */
1771
static int show_numa_map(struct seq_file *m, void *v)
1772
{
1773 1774
	struct numa_maps_private *numa_priv = m->private;
	struct proc_maps_private *proc_priv = &numa_priv->proc_maps;
1775
	struct vm_area_struct *vma = v;
1776
	struct numa_maps *md = &numa_priv->md;
1777 1778
	struct file *file = vma->vm_file;
	struct mm_struct *mm = vma->vm_mm;
1779 1780 1781 1782 1783 1784
	struct mm_walk walk = {
		.hugetlb_entry = gather_hugetlb_stats,
		.pmd_entry = gather_pte_stats,
		.private = md,
		.mm = mm,
	};
1785
	struct mempolicy *pol;
1786 1787
	char buffer[64];
	int nid;
1788 1789 1790 1791

	if (!mm)
		return 0;

1792 1793
	/* Ensure we start with an empty set of numa_maps statistics. */
	memset(md, 0, sizeof(*md));
1794

1795 1796 1797 1798 1799 1800 1801
	pol = __get_vma_policy(vma, vma->vm_start);
	if (pol) {
		mpol_to_str(buffer, sizeof(buffer), pol);
		mpol_cond_put(pol);
	} else {
		mpol_to_str(buffer, sizeof(buffer), proc_priv->task_mempolicy);
	}
1802 1803 1804 1805

	seq_printf(m, "%08lx %s", vma->vm_start, buffer);

	if (file) {
1806
		seq_puts(m, " file=");
M
Miklos Szeredi 已提交
1807
		seq_file_path(m, file, "\n\t= ");
1808
	} else if (vma->vm_start <= mm->brk && vma->vm_end >= mm->start_brk) {
1809
		seq_puts(m, " heap");
1810
	} else if (is_stack(vma)) {
1811
		seq_puts(m, " stack");
1812 1813
	}

1814
	if (is_vm_hugetlb_page(vma))
1815
		seq_puts(m, " huge");
1816

1817 1818
	/* mmap_sem is held by m_start */
	walk_page_vma(vma, &walk);
1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843

	if (!md->pages)
		goto out;

	if (md->anon)
		seq_printf(m, " anon=%lu", md->anon);

	if (md->dirty)
		seq_printf(m, " dirty=%lu", md->dirty);

	if (md->pages != md->anon && md->pages != md->dirty)
		seq_printf(m, " mapped=%lu", md->pages);

	if (md->mapcount_max > 1)
		seq_printf(m, " mapmax=%lu", md->mapcount_max);

	if (md->swapcache)
		seq_printf(m, " swapcache=%lu", md->swapcache);

	if (md->active < md->pages && !is_vm_hugetlb_page(vma))
		seq_printf(m, " active=%lu", md->active);

	if (md->writeback)
		seq_printf(m, " writeback=%lu", md->writeback);

1844 1845 1846
	for_each_node_state(nid, N_MEMORY)
		if (md->node[nid])
			seq_printf(m, " N%d=%lu", nid, md->node[nid]);
1847 1848

	seq_printf(m, " kernelpagesize_kB=%lu", vma_kernel_pagesize(vma) >> 10);
1849 1850
out:
	seq_putc(m, '\n');
1851
	m_cache_vma(m, vma);
1852 1853
	return 0;
}
1854

1855
static const struct seq_operations proc_pid_numa_maps_op = {
1856 1857 1858
	.start  = m_start,
	.next   = m_next,
	.stop   = m_stop,
1859
	.show   = show_numa_map,
1860
};
1861

1862 1863
static int pid_numa_maps_open(struct inode *inode, struct file *file)
{
1864 1865
	return proc_maps_open(inode, file, &proc_pid_numa_maps_op,
				sizeof(struct numa_maps_private));
1866 1867 1868 1869 1870 1871
}

const struct file_operations proc_pid_numa_maps_operations = {
	.open		= pid_numa_maps_open,
	.read		= seq_read,
	.llseek		= seq_lseek,
1872
	.release	= proc_map_release,
1873 1874
};

1875
#endif /* CONFIG_NUMA */