mm.h 60.0 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8
#ifndef _LINUX_MM_H
#define _LINUX_MM_H

#include <linux/errno.h>

#ifdef __KERNEL__

#include <linux/gfp.h>
9
#include <linux/bug.h>
L
Linus Torvalds 已提交
10 11 12
#include <linux/list.h>
#include <linux/mmzone.h>
#include <linux/rbtree.h>
13
#include <linux/atomic.h>
14
#include <linux/debug_locks.h>
15
#include <linux/mm_types.h>
16
#include <linux/range.h>
17
#include <linux/pfn.h>
A
Andrea Arcangeli 已提交
18
#include <linux/bit_spinlock.h>
19
#include <linux/shrinker.h>
L
Linus Torvalds 已提交
20 21 22

struct mempolicy;
struct anon_vma;
23
struct anon_vma_chain;
A
Alexey Dobriyan 已提交
24
struct file_ra_state;
A
Alexey Dobriyan 已提交
25
struct user_struct;
A
Alexey Dobriyan 已提交
26
struct writeback_control;
L
Linus Torvalds 已提交
27

28
#ifndef CONFIG_NEED_MULTIPLE_NODES	/* Don't use mapnrs, do it properly */
L
Linus Torvalds 已提交
29
extern unsigned long max_mapnr;
30 31 32 33 34 35 36

static inline void set_max_mapnr(unsigned long limit)
{
	max_mapnr = limit;
}
#else
static inline void set_max_mapnr(unsigned long limit) { }
L
Linus Torvalds 已提交
37 38
#endif

39
extern unsigned long totalram_pages;
L
Linus Torvalds 已提交
40 41 42 43 44 45 46 47 48 49 50 51 52
extern void * high_memory;
extern int page_cluster;

#ifdef CONFIG_SYSCTL
extern int sysctl_legacy_va_layout;
#else
#define sysctl_legacy_va_layout 0
#endif

#include <asm/page.h>
#include <asm/pgtable.h>
#include <asm/processor.h>

53
extern unsigned long sysctl_user_reserve_kbytes;
54
extern unsigned long sysctl_admin_reserve_kbytes;
55

L
Linus Torvalds 已提交
56 57
#define nth_page(page,n) pfn_to_page(page_to_pfn((page)) + (n))

58 59 60
/* to align the pointer to the (next) page boundary */
#define PAGE_ALIGN(addr) ALIGN(addr, PAGE_SIZE)

61 62 63
/* test whether an address (unsigned long or pointer) is aligned to PAGE_SIZE */
#define PAGE_ALIGNED(addr)	IS_ALIGNED((unsigned long)addr, PAGE_SIZE)

L
Linus Torvalds 已提交
64 65 66 67 68 69 70 71 72
/*
 * Linux kernel virtual memory manager primitives.
 * The idea being to have a "virtual" mm in the same way
 * we have a virtual fs - giving a cleaner interface to the
 * mm details, and allowing different kinds of memory mappings
 * (from shared memory to executable loading to arbitrary
 * mmap() functions).
 */

73 74
extern struct kmem_cache *vm_area_cachep;

L
Linus Torvalds 已提交
75
#ifndef CONFIG_MMU
76 77
extern struct rb_root nommu_region_tree;
extern struct rw_semaphore nommu_region_sem;
L
Linus Torvalds 已提交
78 79 80 81 82

extern unsigned int kobjsize(const void *objp);
#endif

/*
H
Hugh Dickins 已提交
83
 * vm_flags in vm_area_struct, see mm_types.h.
L
Linus Torvalds 已提交
84
 */
85 86
#define VM_NONE		0x00000000

L
Linus Torvalds 已提交
87 88 89 90 91
#define VM_READ		0x00000001	/* currently active flags */
#define VM_WRITE	0x00000002
#define VM_EXEC		0x00000004
#define VM_SHARED	0x00000008

92
/* mprotect() hardcodes VM_MAYREAD >> 4 == VM_READ, and so for r/w/x bits. */
L
Linus Torvalds 已提交
93 94 95 96 97 98
#define VM_MAYREAD	0x00000010	/* limits for mprotect() etc */
#define VM_MAYWRITE	0x00000020
#define VM_MAYEXEC	0x00000040
#define VM_MAYSHARE	0x00000080

#define VM_GROWSDOWN	0x00000100	/* general info on the segment */
99
#define VM_PFNMAP	0x00000400	/* Page-ranges managed without "struct page", just pure PFN */
L
Linus Torvalds 已提交
100 101 102 103 104 105 106 107 108 109 110 111
#define VM_DENYWRITE	0x00000800	/* ETXTBSY on write attempts.. */

#define VM_LOCKED	0x00002000
#define VM_IO           0x00004000	/* Memory mapped I/O or similar */

					/* Used by sys_madvise() */
#define VM_SEQ_READ	0x00008000	/* App will access data sequentially */
#define VM_RAND_READ	0x00010000	/* App will not benefit from clustered reads */

#define VM_DONTCOPY	0x00020000      /* Do not copy this vma on fork */
#define VM_DONTEXPAND	0x00040000	/* Cannot expand with mremap() */
#define VM_ACCOUNT	0x00100000	/* Is a VM accounted object */
112
#define VM_NORESERVE	0x00200000	/* should the VM suppress accounting */
L
Linus Torvalds 已提交
113 114
#define VM_HUGETLB	0x00400000	/* Huge TLB Page VM */
#define VM_NONLINEAR	0x00800000	/* Is non-linear (remap_file_pages) */
115
#define VM_ARCH_1	0x01000000	/* Architecture-specific flag */
116
#define VM_DONTDUMP	0x04000000	/* Do not include in the core dump */
117

118 119 120 121 122 123
#ifdef CONFIG_MEM_SOFT_DIRTY
# define VM_SOFTDIRTY	0x08000000	/* Not soft dirty clean area */
#else
# define VM_SOFTDIRTY	0
#endif

J
Jared Hulbert 已提交
124
#define VM_MIXEDMAP	0x10000000	/* Can contain "struct page" and pure PFN pages */
125 126
#define VM_HUGEPAGE	0x20000000	/* MADV_HUGEPAGE marked this vma */
#define VM_NOHUGEPAGE	0x40000000	/* MADV_NOHUGEPAGE marked this vma */
H
Hugh Dickins 已提交
127
#define VM_MERGEABLE	0x80000000	/* KSM may merge identical pages */
L
Linus Torvalds 已提交
128

129 130 131 132 133 134
#if defined(CONFIG_X86)
# define VM_PAT		VM_ARCH_1	/* PAT reserves whole VMA at once (x86) */
#elif defined(CONFIG_PPC)
# define VM_SAO		VM_ARCH_1	/* Strong Access Ordering (powerpc) */
#elif defined(CONFIG_PARISC)
# define VM_GROWSUP	VM_ARCH_1
135 136
#elif defined(CONFIG_METAG)
# define VM_GROWSUP	VM_ARCH_1
137 138 139 140 141 142 143 144 145 146
#elif defined(CONFIG_IA64)
# define VM_GROWSUP	VM_ARCH_1
#elif !defined(CONFIG_MMU)
# define VM_MAPPED_COPY	VM_ARCH_1	/* T if mapped copy of data (nommu mmap) */
#endif

#ifndef VM_GROWSUP
# define VM_GROWSUP	VM_NONE
#endif

147 148 149
/* Bits set in the VMA until the stack is in its final location */
#define VM_STACK_INCOMPLETE_SETUP	(VM_RAND_READ | VM_SEQ_READ)

L
Linus Torvalds 已提交
150 151 152 153 154 155 156 157 158 159
#ifndef VM_STACK_DEFAULT_FLAGS		/* arch can override this */
#define VM_STACK_DEFAULT_FLAGS VM_DATA_DEFAULT_FLAGS
#endif

#ifdef CONFIG_STACK_GROWSUP
#define VM_STACK_FLAGS	(VM_GROWSUP | VM_STACK_DEFAULT_FLAGS | VM_ACCOUNT)
#else
#define VM_STACK_FLAGS	(VM_GROWSDOWN | VM_STACK_DEFAULT_FLAGS | VM_ACCOUNT)
#endif

N
Nick Piggin 已提交
160
/*
161 162
 * Special vmas that are non-mergable, non-mlock()able.
 * Note: mm/huge_memory.c VM_NO_THP depends on this definition.
N
Nick Piggin 已提交
163
 */
164
#define VM_SPECIAL (VM_IO | VM_DONTEXPAND | VM_PFNMAP)
N
Nick Piggin 已提交
165

L
Linus Torvalds 已提交
166 167 168 169 170 171
/*
 * mapping from the currently active vm_flags protection bits (the
 * low four bits) to a page protection mask..
 */
extern pgprot_t protection_map[16];

N
Nick Piggin 已提交
172 173
#define FAULT_FLAG_WRITE	0x01	/* Fault was a write access */
#define FAULT_FLAG_NONLINEAR	0x02	/* Fault was via a nonlinear mapping */
174
#define FAULT_FLAG_MKWRITE	0x04	/* Fault was mkwrite of existing pte */
175
#define FAULT_FLAG_ALLOW_RETRY	0x08	/* Retry fault if blocking */
176
#define FAULT_FLAG_RETRY_NOWAIT	0x10	/* Don't drop mmap_sem and wait when retrying */
177
#define FAULT_FLAG_KILLABLE	0x20	/* The fault task is in SIGKILL killable region */
178
#define FAULT_FLAG_TRIED	0x40	/* second try */
179
#define FAULT_FLAG_USER		0x80	/* The fault originated in userspace */
N
Nick Piggin 已提交
180

181
/*
N
Nick Piggin 已提交
182
 * vm_fault is filled by the the pagefault handler and passed to the vma's
N
Nick Piggin 已提交
183 184
 * ->fault function. The vma's ->fault is responsible for returning a bitmask
 * of VM_FAULT_xxx flags that give details about how the fault was handled.
185
 *
N
Nick Piggin 已提交
186
 * pgoff should be used in favour of virtual_address, if possible. If pgoff
187
 * is used, one may implement ->remap_pages to get nonlinear mapping support.
188
 */
N
Nick Piggin 已提交
189 190 191 192 193 194
struct vm_fault {
	unsigned int flags;		/* FAULT_FLAG_xxx flags */
	pgoff_t pgoff;			/* Logical page offset based on vma */
	void __user *virtual_address;	/* Faulting virtual address */

	struct page *page;		/* ->fault handlers should return a
N
Nick Piggin 已提交
195
					 * page here, unless VM_FAULT_NOPAGE
N
Nick Piggin 已提交
196
					 * is set (which is also implied by
N
Nick Piggin 已提交
197
					 * VM_FAULT_ERROR).
N
Nick Piggin 已提交
198
					 */
199
};
L
Linus Torvalds 已提交
200 201 202 203 204 205 206 207 208

/*
 * These are the virtual MM functions - opening of an area, closing and
 * unmapping it (needed to keep files on disk up-to-date etc), pointer
 * to the functions called when a no-page or a wp-page exception occurs. 
 */
struct vm_operations_struct {
	void (*open)(struct vm_area_struct * area);
	void (*close)(struct vm_area_struct * area);
N
Nick Piggin 已提交
209
	int (*fault)(struct vm_area_struct *vma, struct vm_fault *vmf);
210 211 212

	/* notification that a previously read-only page is about to become
	 * writable, if an error is returned it will cause a SIGBUS */
213
	int (*page_mkwrite)(struct vm_area_struct *vma, struct vm_fault *vmf);
214 215 216 217 218 219

	/* called by access_process_vm when get_user_pages() fails, typically
	 * for use by special VMAs that can switch between memory and hardware
	 */
	int (*access)(struct vm_area_struct *vma, unsigned long addr,
		      void *buf, int len, int write);
L
Linus Torvalds 已提交
220
#ifdef CONFIG_NUMA
221 222 223 224 225 226 227
	/*
	 * set_policy() op must add a reference to any non-NULL @new mempolicy
	 * to hold the policy upon return.  Caller should pass NULL @new to
	 * remove a policy and fall back to surrounding context--i.e. do not
	 * install a MPOL_DEFAULT policy, nor the task or system default
	 * mempolicy.
	 */
L
Linus Torvalds 已提交
228
	int (*set_policy)(struct vm_area_struct *vma, struct mempolicy *new);
229 230 231 232 233 234 235 236 237 238 239

	/*
	 * get_policy() op must add reference [mpol_get()] to any policy at
	 * (vma,addr) marked as MPOL_SHARED.  The shared policy infrastructure
	 * in mm/mempolicy.c will do this automatically.
	 * get_policy() must NOT add a ref if the policy at (vma,addr) is not
	 * marked as MPOL_SHARED. vma policies are protected by the mmap_sem.
	 * If no [shared/vma] mempolicy exists at the addr, get_policy() op
	 * must return NULL--i.e., do not "fallback" to task or system default
	 * policy.
	 */
L
Linus Torvalds 已提交
240 241
	struct mempolicy *(*get_policy)(struct vm_area_struct *vma,
					unsigned long addr);
242 243
	int (*migrate)(struct vm_area_struct *vma, const nodemask_t *from,
		const nodemask_t *to, unsigned long flags);
L
Linus Torvalds 已提交
244
#endif
245 246 247
	/* called by sys_remap_file_pages() to populate non-linear mapping */
	int (*remap_pages)(struct vm_area_struct *vma, unsigned long addr,
			   unsigned long size, pgoff_t pgoff);
L
Linus Torvalds 已提交
248 249 250 251 252
};

struct mmu_gather;
struct inode;

A
Andrew Morton 已提交
253 254
#define page_private(page)		((page)->private)
#define set_page_private(page, v)	((page)->private = (v))
H
Hugh Dickins 已提交
255

256 257 258
/* It's valid only if the page is free path or free_list */
static inline void set_freepage_migratetype(struct page *page, int migratetype)
{
M
Minchan Kim 已提交
259
	page->index = migratetype;
260 261 262 263 264
}

/* It's valid only if the page is free path or free_list */
static inline int get_freepage_migratetype(struct page *page)
{
M
Minchan Kim 已提交
265
	return page->index;
266 267
}

L
Linus Torvalds 已提交
268 269 270 271 272
/*
 * FIXME: take this include out, include page-flags.h in
 * files which need it (119 of them)
 */
#include <linux/page-flags.h>
273
#include <linux/huge_mm.h>
L
Linus Torvalds 已提交
274 275 276 277 278 279 280 281 282 283 284 285 286 287 288

/*
 * Methods to modify the page usage count.
 *
 * What counts for a page usage:
 * - cache mapping   (page->mapping)
 * - private data    (page->private)
 * - page mapped in a task's page tables, each mapping
 *   is counted separately
 *
 * Also, many kernel routines increase the page count before a critical
 * routine so they can be sure the page doesn't go away from under them.
 */

/*
N
Nick Piggin 已提交
289
 * Drop a ref, return true if the refcount fell to zero (the page has no users)
L
Linus Torvalds 已提交
290
 */
291 292
static inline int put_page_testzero(struct page *page)
{
N
Nick Piggin 已提交
293
	VM_BUG_ON(atomic_read(&page->_count) == 0);
294
	return atomic_dec_and_test(&page->_count);
295
}
L
Linus Torvalds 已提交
296 297

/*
298 299
 * Try to grab a ref unless the page has a refcount of zero, return false if
 * that is the case.
L
Linus Torvalds 已提交
300
 */
301 302
static inline int get_page_unless_zero(struct page *page)
{
303
	return atomic_inc_not_zero(&page->_count);
304
}
L
Linus Torvalds 已提交
305

306 307
extern int page_is_ram(unsigned long pfn);

308
/* Support for virtually mapped pages */
309 310
struct page *vmalloc_to_page(const void *addr);
unsigned long vmalloc_to_pfn(const void *addr);
311

312 313 314 315 316 317
/*
 * Determine if an address is within the vmalloc range
 *
 * On nommu, vmalloc/vfree wrap through kmalloc/kfree directly, so there
 * is no special casing required.
 */
318 319
static inline int is_vmalloc_addr(const void *x)
{
320
#ifdef CONFIG_MMU
321 322 323
	unsigned long addr = (unsigned long)x;

	return addr >= VMALLOC_START && addr < VMALLOC_END;
324 325
#else
	return 0;
326
#endif
327
}
328 329 330
#ifdef CONFIG_MMU
extern int is_vmalloc_or_module_addr(const void *x);
#else
331
static inline int is_vmalloc_or_module_addr(const void *x)
332 333 334 335
{
	return 0;
}
#endif
336

A
Andrea Arcangeli 已提交
337 338 339
static inline void compound_lock(struct page *page)
{
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
340
	VM_BUG_ON(PageSlab(page));
A
Andrea Arcangeli 已提交
341 342 343 344 345 346 347
	bit_spin_lock(PG_compound_lock, &page->flags);
#endif
}

static inline void compound_unlock(struct page *page)
{
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
348
	VM_BUG_ON(PageSlab(page));
A
Andrea Arcangeli 已提交
349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371
	bit_spin_unlock(PG_compound_lock, &page->flags);
#endif
}

static inline unsigned long compound_lock_irqsave(struct page *page)
{
	unsigned long uninitialized_var(flags);
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
	local_irq_save(flags);
	compound_lock(page);
#endif
	return flags;
}

static inline void compound_unlock_irqrestore(struct page *page,
					      unsigned long flags)
{
#ifdef CONFIG_TRANSPARENT_HUGEPAGE
	compound_unlock(page);
	local_irq_restore(flags);
#endif
}

372 373
static inline struct page *compound_head(struct page *page)
{
374
	if (unlikely(PageTail(page)))
375 376 377 378
		return page->first_page;
	return page;
}

379 380 381 382 383
/*
 * The atomic page->_mapcount, starts from -1: so that transitions
 * both from it and to it can be tracked, using atomic_inc_and_test
 * and atomic_add_negative(-1).
 */
384
static inline void page_mapcount_reset(struct page *page)
385 386 387 388 389 390 391 392 393
{
	atomic_set(&(page)->_mapcount, -1);
}

static inline int page_mapcount(struct page *page)
{
	return atomic_read(&(page)->_mapcount) + 1;
}

H
Hugh Dickins 已提交
394
static inline int page_count(struct page *page)
L
Linus Torvalds 已提交
395
{
396
	return atomic_read(&compound_head(page)->_count);
L
Linus Torvalds 已提交
397 398
}

A
Andrea Arcangeli 已提交
399 400 401 402 403 404 405 406 407 408 409
static inline void get_huge_page_tail(struct page *page)
{
	/*
	 * __split_huge_page_refcount() cannot run
	 * from under us.
	 */
	VM_BUG_ON(page_mapcount(page) < 0);
	VM_BUG_ON(atomic_read(&page->_count) != 0);
	atomic_inc(&page->_mapcount);
}

410 411
extern bool __get_page_tail(struct page *page);

L
Linus Torvalds 已提交
412 413
static inline void get_page(struct page *page)
{
414 415 416
	if (unlikely(PageTail(page)))
		if (likely(__get_page_tail(page)))
			return;
417 418
	/*
	 * Getting a normal page or the head of a compound page
419
	 * requires to already have an elevated page->_count.
420
	 */
421
	VM_BUG_ON(atomic_read(&page->_count) <= 0);
L
Linus Torvalds 已提交
422 423 424
	atomic_inc(&page->_count);
}

425 426 427 428 429 430
static inline struct page *virt_to_head_page(const void *x)
{
	struct page *page = virt_to_page(x);
	return compound_head(page);
}

431 432 433 434 435 436 437 438 439
/*
 * Setup the page count before being freed into the page allocator for
 * the first time (boot or memory hotplug)
 */
static inline void init_page_count(struct page *page)
{
	atomic_set(&page->_count, 1);
}

A
Andrea Arcangeli 已提交
440 441 442
/*
 * PageBuddy() indicate that the page is free and in the buddy system
 * (see mm/page_alloc.c).
443 444 445 446 447
 *
 * PAGE_BUDDY_MAPCOUNT_VALUE must be <= -2 but better not too close to
 * -2 so that an underflow of the page_mapcount() won't be mistaken
 * for a genuine PAGE_BUDDY_MAPCOUNT_VALUE. -128 can be created very
 * efficiently by most CPU architectures.
A
Andrea Arcangeli 已提交
448
 */
449 450
#define PAGE_BUDDY_MAPCOUNT_VALUE (-128)

A
Andrea Arcangeli 已提交
451 452
static inline int PageBuddy(struct page *page)
{
453
	return atomic_read(&page->_mapcount) == PAGE_BUDDY_MAPCOUNT_VALUE;
A
Andrea Arcangeli 已提交
454 455 456 457 458
}

static inline void __SetPageBuddy(struct page *page)
{
	VM_BUG_ON(atomic_read(&page->_mapcount) != -1);
459
	atomic_set(&page->_mapcount, PAGE_BUDDY_MAPCOUNT_VALUE);
A
Andrea Arcangeli 已提交
460 461 462 463 464 465 466 467
}

static inline void __ClearPageBuddy(struct page *page)
{
	VM_BUG_ON(!PageBuddy(page));
	atomic_set(&page->_mapcount, -1);
}

L
Linus Torvalds 已提交
468
void put_page(struct page *page);
469
void put_pages_list(struct list_head *pages);
L
Linus Torvalds 已提交
470

N
Nick Piggin 已提交
471
void split_page(struct page *page, unsigned int order);
472
int split_free_page(struct page *page);
N
Nick Piggin 已提交
473

474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491
/*
 * Compound pages have a destructor function.  Provide a
 * prototype for that function and accessor functions.
 * These are _only_ valid on the head of a PG_compound page.
 */
typedef void compound_page_dtor(struct page *);

static inline void set_compound_page_dtor(struct page *page,
						compound_page_dtor *dtor)
{
	page[1].lru.next = (void *)dtor;
}

static inline compound_page_dtor *get_compound_page_dtor(struct page *page)
{
	return (compound_page_dtor *)page[1].lru.next;
}

492 493
static inline int compound_order(struct page *page)
{
494
	if (!PageHead(page))
495 496 497 498 499 500 501 502 503
		return 0;
	return (unsigned long)page[1].lru.prev;
}

static inline void set_compound_order(struct page *page, unsigned long order)
{
	page[1].lru.prev = (void *)order;
}

504
#ifdef CONFIG_MMU
A
Andrea Arcangeli 已提交
505 506 507 508 509 510 511 512 513 514 515 516
/*
 * Do pte_mkwrite, but only if the vma says VM_WRITE.  We do this when
 * servicing faults for write access.  In the normal case, do always want
 * pte_mkwrite.  But get_user_pages can cause write faults for mappings
 * that do not have writing enabled, when used by access_process_vm.
 */
static inline pte_t maybe_mkwrite(pte_t pte, struct vm_area_struct *vma)
{
	if (likely(vma->vm_flags & VM_WRITE))
		pte = pte_mkwrite(pte);
	return pte;
}
517
#endif
A
Andrea Arcangeli 已提交
518

L
Linus Torvalds 已提交
519 520 521 522 523 524 525
/*
 * Multiple processes may "see" the same page. E.g. for untouched
 * mappings of /dev/null, all processes see the same page full of
 * zeroes, and text pages of executables and shared libraries have
 * only one copy in memory, at most, normally.
 *
 * For the non-reserved pages, page_count(page) denotes a reference count.
526 527
 *   page_count() == 0 means the page is free. page->lru is then used for
 *   freelist management in the buddy allocator.
N
Nick Piggin 已提交
528
 *   page_count() > 0  means the page has been allocated.
L
Linus Torvalds 已提交
529
 *
N
Nick Piggin 已提交
530 531 532 533 534
 * Pages are allocated by the slab allocator in order to provide memory
 * to kmalloc and kmem_cache_alloc. In this case, the management of the
 * page, and the fields in 'struct page' are the responsibility of mm/slab.c
 * unless a particular usage is carefully commented. (the responsibility of
 * freeing the kmalloc memory is the caller's, of course).
L
Linus Torvalds 已提交
535
 *
N
Nick Piggin 已提交
536 537 538 539 540 541 542 543 544
 * A page may be used by anyone else who does a __get_free_page().
 * In this case, page_count still tracks the references, and should only
 * be used through the normal accessor functions. The top bits of page->flags
 * and page->virtual store page management information, but all other fields
 * are unused and could be used privately, carefully. The management of this
 * page is the responsibility of the one who allocated it, and those who have
 * subsequently been given references to it.
 *
 * The other pages (we may call them "pagecache pages") are completely
L
Linus Torvalds 已提交
545 546 547
 * managed by the Linux memory manager: I/O, buffers, swapping etc.
 * The following discussion applies only to them.
 *
N
Nick Piggin 已提交
548 549 550 551
 * A pagecache page contains an opaque `private' member, which belongs to the
 * page's address_space. Usually, this is the address of a circular list of
 * the page's disk buffers. PG_private must be set to tell the VM to call
 * into the filesystem to release these pages.
L
Linus Torvalds 已提交
552
 *
N
Nick Piggin 已提交
553 554 555
 * A page may belong to an inode's memory mapping. In this case, page->mapping
 * is the pointer to the inode, and page->index is the file offset of the page,
 * in units of PAGE_CACHE_SIZE.
L
Linus Torvalds 已提交
556
 *
N
Nick Piggin 已提交
557 558 559
 * If pagecache pages are not associated with an inode, they are said to be
 * anonymous pages. These may become associated with the swapcache, and in that
 * case PG_swapcache is set, and page->private is an offset into the swapcache.
L
Linus Torvalds 已提交
560
 *
N
Nick Piggin 已提交
561 562 563
 * In either case (swapcache or inode backed), the pagecache itself holds one
 * reference to the page. Setting PG_private should also increment the
 * refcount. The each user mapping also has a reference to the page.
L
Linus Torvalds 已提交
564
 *
N
Nick Piggin 已提交
565 566 567 568
 * The pagecache pages are stored in a per-mapping radix tree, which is
 * rooted at mapping->page_tree, and indexed by offset.
 * Where 2.4 and early 2.6 kernels kept dirty/clean pages in per-address_space
 * lists, we instead now tag pages as dirty/writeback in the radix tree.
L
Linus Torvalds 已提交
569
 *
N
Nick Piggin 已提交
570
 * All pagecache pages may be subject to I/O:
L
Linus Torvalds 已提交
571 572
 * - inode pages may need to be read from disk,
 * - inode pages which have been modified and are MAP_SHARED may need
N
Nick Piggin 已提交
573 574 575 576
 *   to be written back to the inode on disk,
 * - anonymous pages (including MAP_PRIVATE file mappings) which have been
 *   modified may need to be swapped out to swap space and (later) to be read
 *   back into memory.
L
Linus Torvalds 已提交
577 578 579 580 581 582
 */

/*
 * The zone field is never updated after free_area_init_core()
 * sets it, so none of the operations on it need to be atomic.
 */
583

584
/* Page flags: | [SECTION] | [NODE] | ZONE | [LAST_NID] | ... | FLAGS | */
585
#define SECTIONS_PGOFF		((sizeof(unsigned long)*8) - SECTIONS_WIDTH)
A
Andy Whitcroft 已提交
586 587
#define NODES_PGOFF		(SECTIONS_PGOFF - NODES_WIDTH)
#define ZONES_PGOFF		(NODES_PGOFF - ZONES_WIDTH)
588
#define LAST_NID_PGOFF		(ZONES_PGOFF - LAST_NID_WIDTH)
A
Andy Whitcroft 已提交
589

590
/*
L
Lucas De Marchi 已提交
591
 * Define the bit shifts to access each section.  For non-existent
592 593 594
 * sections we define the shift as 0; that plus a 0 mask ensures
 * the compiler will optimise away reference to them.
 */
A
Andy Whitcroft 已提交
595 596 597
#define SECTIONS_PGSHIFT	(SECTIONS_PGOFF * (SECTIONS_WIDTH != 0))
#define NODES_PGSHIFT		(NODES_PGOFF * (NODES_WIDTH != 0))
#define ZONES_PGSHIFT		(ZONES_PGOFF * (ZONES_WIDTH != 0))
598
#define LAST_NID_PGSHIFT	(LAST_NID_PGOFF * (LAST_NID_WIDTH != 0))
599

600 601
/* NODE:ZONE or SECTION:ZONE is used to ID a zone for the buddy allocator */
#ifdef NODE_NOT_IN_PAGE_FLAGS
602
#define ZONEID_SHIFT		(SECTIONS_SHIFT + ZONES_SHIFT)
603 604
#define ZONEID_PGOFF		((SECTIONS_PGOFF < ZONES_PGOFF)? \
						SECTIONS_PGOFF : ZONES_PGOFF)
A
Andy Whitcroft 已提交
605
#else
606
#define ZONEID_SHIFT		(NODES_SHIFT + ZONES_SHIFT)
607 608
#define ZONEID_PGOFF		((NODES_PGOFF < ZONES_PGOFF)? \
						NODES_PGOFF : ZONES_PGOFF)
609 610
#endif

611
#define ZONEID_PGSHIFT		(ZONEID_PGOFF * (ZONEID_SHIFT != 0))
612

613 614
#if SECTIONS_WIDTH+NODES_WIDTH+ZONES_WIDTH > BITS_PER_LONG - NR_PAGEFLAGS
#error SECTIONS_WIDTH+NODES_WIDTH+ZONES_WIDTH > BITS_PER_LONG - NR_PAGEFLAGS
615 616
#endif

A
Andy Whitcroft 已提交
617 618 619
#define ZONES_MASK		((1UL << ZONES_WIDTH) - 1)
#define NODES_MASK		((1UL << NODES_WIDTH) - 1)
#define SECTIONS_MASK		((1UL << SECTIONS_WIDTH) - 1)
620
#define LAST_NID_MASK		((1UL << LAST_NID_WIDTH) - 1)
621
#define ZONEID_MASK		((1UL << ZONEID_SHIFT) - 1)
622

I
Ian Campbell 已提交
623
static inline enum zone_type page_zonenum(const struct page *page)
L
Linus Torvalds 已提交
624
{
625
	return (page->flags >> ZONES_PGSHIFT) & ZONES_MASK;
L
Linus Torvalds 已提交
626 627
}

C
Cody P Schafer 已提交
628 629 630 631
#if defined(CONFIG_SPARSEMEM) && !defined(CONFIG_SPARSEMEM_VMEMMAP)
#define SECTION_IN_PAGE_FLAGS
#endif

632
/*
633 634 635 636 637 638
 * The identification function is mainly used by the buddy allocator for
 * determining if two pages could be buddies. We are not really identifying
 * the zone since we could be using the section number id if we do not have
 * node id available in page flags.
 * We only guarantee that it will return the same value for two combinable
 * pages in a zone.
639
 */
640 641
static inline int page_zone_id(struct page *page)
{
642
	return (page->flags >> ZONEID_PGSHIFT) & ZONEID_MASK;
643 644
}

645
static inline int zone_to_nid(struct zone *zone)
646
{
647 648 649 650 651
#ifdef CONFIG_NUMA
	return zone->node;
#else
	return 0;
#endif
652 653
}

654
#ifdef NODE_NOT_IN_PAGE_FLAGS
I
Ian Campbell 已提交
655
extern int page_to_nid(const struct page *page);
656
#else
I
Ian Campbell 已提交
657
static inline int page_to_nid(const struct page *page)
A
Andy Whitcroft 已提交
658
{
659
	return (page->flags >> NODES_PGSHIFT) & NODES_MASK;
A
Andy Whitcroft 已提交
660
}
661 662
#endif

663
#ifdef CONFIG_NUMA_BALANCING
664
#ifdef LAST_NID_NOT_IN_PAGE_FLAGS
665
static inline int page_nid_xchg_last(struct page *page, int nid)
666 667 668 669
{
	return xchg(&page->_last_nid, nid);
}

670
static inline int page_nid_last(struct page *page)
671 672 673
{
	return page->_last_nid;
}
674
static inline void page_nid_reset_last(struct page *page)
675 676 677 678
{
	page->_last_nid = -1;
}
#else
679
static inline int page_nid_last(struct page *page)
680 681 682 683
{
	return (page->flags >> LAST_NID_PGSHIFT) & LAST_NID_MASK;
}

684
extern int page_nid_xchg_last(struct page *page, int nid);
685

686
static inline void page_nid_reset_last(struct page *page)
687
{
M
Mel Gorman 已提交
688 689 690 691
	int nid = (1 << LAST_NID_SHIFT) - 1;

	page->flags &= ~(LAST_NID_MASK << LAST_NID_PGSHIFT);
	page->flags |= (nid & LAST_NID_MASK) << LAST_NID_PGSHIFT;
692 693 694
}
#endif /* LAST_NID_NOT_IN_PAGE_FLAGS */
#else
695
static inline int page_nid_xchg_last(struct page *page, int nid)
696 697 698 699
{
	return page_to_nid(page);
}

700
static inline int page_nid_last(struct page *page)
701 702 703 704
{
	return page_to_nid(page);
}

705
static inline void page_nid_reset_last(struct page *page)
706 707 708 709
{
}
#endif

I
Ian Campbell 已提交
710
static inline struct zone *page_zone(const struct page *page)
711 712 713 714
{
	return &NODE_DATA(page_to_nid(page))->node_zones[page_zonenum(page)];
}

C
Cody P Schafer 已提交
715
#ifdef SECTION_IN_PAGE_FLAGS
716 717 718 719 720 721
static inline void set_page_section(struct page *page, unsigned long section)
{
	page->flags &= ~(SECTIONS_MASK << SECTIONS_PGSHIFT);
	page->flags |= (section & SECTIONS_MASK) << SECTIONS_PGSHIFT;
}

722
static inline unsigned long page_to_section(const struct page *page)
A
Andy Whitcroft 已提交
723 724 725
{
	return (page->flags >> SECTIONS_PGSHIFT) & SECTIONS_MASK;
}
726
#endif
A
Andy Whitcroft 已提交
727

728
static inline void set_page_zone(struct page *page, enum zone_type zone)
729 730 731 732
{
	page->flags &= ~(ZONES_MASK << ZONES_PGSHIFT);
	page->flags |= (zone & ZONES_MASK) << ZONES_PGSHIFT;
}
733

734 735 736 737
static inline void set_page_node(struct page *page, unsigned long node)
{
	page->flags &= ~(NODES_MASK << NODES_PGSHIFT);
	page->flags |= (node & NODES_MASK) << NODES_PGSHIFT;
L
Linus Torvalds 已提交
738
}
739

740
static inline void set_page_links(struct page *page, enum zone_type zone,
A
Andy Whitcroft 已提交
741
	unsigned long node, unsigned long pfn)
L
Linus Torvalds 已提交
742
{
743 744
	set_page_zone(page, zone);
	set_page_node(page, node);
C
Cody P Schafer 已提交
745
#ifdef SECTION_IN_PAGE_FLAGS
A
Andy Whitcroft 已提交
746
	set_page_section(page, pfn_to_section_nr(pfn));
747
#endif
L
Linus Torvalds 已提交
748 749
}

750 751 752 753 754
/*
 * Some inline functions in vmstat.h depend on page_zone()
 */
#include <linux/vmstat.h>

I
Ian Campbell 已提交
755
static __always_inline void *lowmem_page_address(const struct page *page)
L
Linus Torvalds 已提交
756
{
757
	return __va(PFN_PHYS(page_to_pfn(page)));
L
Linus Torvalds 已提交
758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773
}

#if defined(CONFIG_HIGHMEM) && !defined(WANT_PAGE_VIRTUAL)
#define HASHED_PAGE_VIRTUAL
#endif

#if defined(WANT_PAGE_VIRTUAL)
#define page_address(page) ((page)->virtual)
#define set_page_address(page, address)			\
	do {						\
		(page)->virtual = (address);		\
	} while(0)
#define page_address_init()  do { } while(0)
#endif

#if defined(HASHED_PAGE_VIRTUAL)
774
void *page_address(const struct page *page);
L
Linus Torvalds 已提交
775 776 777 778 779 780 781 782 783 784 785 786 787
void set_page_address(struct page *page, void *virtual);
void page_address_init(void);
#endif

#if !defined(HASHED_PAGE_VIRTUAL) && !defined(WANT_PAGE_VIRTUAL)
#define page_address(page) lowmem_page_address(page)
#define set_page_address(page, address)  do { } while(0)
#define page_address_init()  do { } while(0)
#endif

/*
 * On an anonymous page mapped into a user virtual memory area,
 * page->mapping points to its anon_vma, not to a struct address_space;
H
Hugh Dickins 已提交
788 789 790 791 792 793 794 795
 * with the PAGE_MAPPING_ANON bit set to distinguish it.  See rmap.h.
 *
 * On an anonymous page in a VM_MERGEABLE area, if CONFIG_KSM is enabled,
 * the PAGE_MAPPING_KSM bit may be set along with the PAGE_MAPPING_ANON bit;
 * and then page->mapping points, not to an anon_vma, but to a private
 * structure which KSM associates with that merged page.  See ksm.h.
 *
 * PAGE_MAPPING_KSM without PAGE_MAPPING_ANON is currently never used.
L
Linus Torvalds 已提交
796 797 798 799 800 801
 *
 * Please note that, confusingly, "page_mapping" refers to the inode
 * address_space which maps the page from disk; whereas "page_mapped"
 * refers to user virtual address space into which the page is mapped.
 */
#define PAGE_MAPPING_ANON	1
H
Hugh Dickins 已提交
802 803
#define PAGE_MAPPING_KSM	2
#define PAGE_MAPPING_FLAGS	(PAGE_MAPPING_ANON | PAGE_MAPPING_KSM)
L
Linus Torvalds 已提交
804

S
Shaohua Li 已提交
805
extern struct address_space *page_mapping(struct page *page);
L
Linus Torvalds 已提交
806

H
Hugh Dickins 已提交
807 808 809 810 811 812
/* Neutral page->mapping pointer to address_space or anon_vma or other */
static inline void *page_rmapping(struct page *page)
{
	return (void *)((unsigned long)page->mapping & ~PAGE_MAPPING_FLAGS);
}

813 814 815 816 817 818 819 820 821 822 823
extern struct address_space *__page_file_mapping(struct page *);

static inline
struct address_space *page_file_mapping(struct page *page)
{
	if (unlikely(PageSwapCache(page)))
		return __page_file_mapping(page);

	return page->mapping;
}

L
Linus Torvalds 已提交
824 825 826 827 828 829 830 831 832 833 834 835
static inline int PageAnon(struct page *page)
{
	return ((unsigned long)page->mapping & PAGE_MAPPING_ANON) != 0;
}

/*
 * Return the pagecache index of the passed page.  Regular pagecache pages
 * use ->index whereas swapcache pages use ->private
 */
static inline pgoff_t page_index(struct page *page)
{
	if (unlikely(PageSwapCache(page)))
H
Hugh Dickins 已提交
836
		return page_private(page);
L
Linus Torvalds 已提交
837 838 839
	return page->index;
}

840 841 842 843 844 845 846 847 848 849 850 851 852 853
extern pgoff_t __page_file_index(struct page *page);

/*
 * Return the file index of the page. Regular pagecache pages use ->index
 * whereas swapcache pages use swp_offset(->private)
 */
static inline pgoff_t page_file_index(struct page *page)
{
	if (unlikely(PageSwapCache(page)))
		return __page_file_index(page);

	return page->index;
}

L
Linus Torvalds 已提交
854 855 856 857 858 859 860 861 862 863 864 865 866
/*
 * Return true if this page is mapped into pagetables.
 */
static inline int page_mapped(struct page *page)
{
	return atomic_read(&(page)->_mapcount) >= 0;
}

/*
 * Different kinds of faults, as returned by handle_mm_fault().
 * Used to decide whether a process gets delivered SIGBUS or
 * just gets major/minor fault counters bumped up.
 */
N
Nick Piggin 已提交
867

N
Nick Piggin 已提交
868
#define VM_FAULT_MINOR	0 /* For backwards compat. Remove me quickly. */
N
Nick Piggin 已提交
869

N
Nick Piggin 已提交
870 871 872 873
#define VM_FAULT_OOM	0x0001
#define VM_FAULT_SIGBUS	0x0002
#define VM_FAULT_MAJOR	0x0004
#define VM_FAULT_WRITE	0x0008	/* Special case for get_user_pages */
874 875
#define VM_FAULT_HWPOISON 0x0010	/* Hit poisoned small page */
#define VM_FAULT_HWPOISON_LARGE 0x0020  /* Hit poisoned large page. Index encoded in upper bits */
N
Nick Piggin 已提交
876

N
Nick Piggin 已提交
877 878
#define VM_FAULT_NOPAGE	0x0100	/* ->fault installed the pte, not return page */
#define VM_FAULT_LOCKED	0x0200	/* ->fault locked the returned page */
879
#define VM_FAULT_RETRY	0x0400	/* ->fault blocked, must retry */
880
#define VM_FAULT_FALLBACK 0x0800	/* huge page fault failed, fall back to small */
L
Linus Torvalds 已提交
881

882 883 884
#define VM_FAULT_HWPOISON_LARGE_MASK 0xf000 /* encodes hpage index for large hwpoison */

#define VM_FAULT_ERROR	(VM_FAULT_OOM | VM_FAULT_SIGBUS | VM_FAULT_HWPOISON | \
885
			 VM_FAULT_FALLBACK | VM_FAULT_HWPOISON_LARGE)
886 887 888 889

/* Encode hstate index for a hwpoisoned large page */
#define VM_FAULT_SET_HINDEX(x) ((x) << 12)
#define VM_FAULT_GET_HINDEX(x) (((x) >> 12) & 0xf)
N
Nick Piggin 已提交
890

891 892 893 894 895
/*
 * Can be called by the pagefault handler when it gets a VM_FAULT_OOM.
 */
extern void pagefault_out_of_memory(void);

L
Linus Torvalds 已提交
896 897
#define offset_in_page(p)	((unsigned long)(p) & ~PAGE_MASK)

898
/*
899
 * Flags passed to show_mem() and show_free_areas() to suppress output in
900 901
 * various contexts.
 */
902 903
#define SHOW_MEM_FILTER_NODES		(0x0001u)	/* disallowed nodes */
#define SHOW_MEM_FILTER_PAGE_COUNT	(0x0002u)	/* page type count */
904

905 906
extern void show_free_areas(unsigned int flags);
extern bool skip_free_areas_node(unsigned int flags, int nid);
L
Linus Torvalds 已提交
907 908 909

int shmem_zero_setup(struct vm_area_struct *);

A
Alexey Dobriyan 已提交
910
extern int can_do_mlock(void);
L
Linus Torvalds 已提交
911 912 913 914 915 916 917 918 919 920 921 922 923
extern int user_shm_lock(size_t, struct user_struct *);
extern void user_shm_unlock(size_t, struct user_struct *);

/*
 * Parameter block passed down to zap_pte_range in exceptional cases.
 */
struct zap_details {
	struct vm_area_struct *nonlinear_vma;	/* Check page->index if set */
	struct address_space *check_mapping;	/* Check page->mapping if set */
	pgoff_t	first_index;			/* Lowest page->index to unmap */
	pgoff_t last_index;			/* Highest page->index to unmap */
};

N
Nick Piggin 已提交
924 925 926
struct page *vm_normal_page(struct vm_area_struct *vma, unsigned long addr,
		pte_t pte);

927 928
int zap_vma_ptes(struct vm_area_struct *vma, unsigned long address,
		unsigned long size);
A
Al Viro 已提交
929
void zap_page_range(struct vm_area_struct *vma, unsigned long address,
L
Linus Torvalds 已提交
930
		unsigned long size, struct zap_details *);
931 932
void unmap_vmas(struct mmu_gather *tlb, struct vm_area_struct *start_vma,
		unsigned long start, unsigned long end);
933 934 935 936 937 938

/**
 * mm_walk - callbacks for walk_page_range
 * @pgd_entry: if set, called for each non-empty PGD (top-level) entry
 * @pud_entry: if set, called for each non-empty PUD (2nd-level) entry
 * @pmd_entry: if set, called for each non-empty PMD (3rd-level) entry
939 940 941
 *	       this handler is required to be able to handle
 *	       pmd_trans_huge() pmds.  They may simply choose to
 *	       split_huge_page() instead of handling it explicitly.
942 943
 * @pte_entry: if set, called for each non-empty PTE (4th-level) entry
 * @pte_hole: if set, called for each hole at all levels
944
 * @hugetlb_entry: if set, called for each hugetlb entry
945 946
 *		   *Caution*: The caller must hold mmap_sem() if @hugetlb_entry
 * 			      is used.
947 948 949 950
 *
 * (see walk_page_range for more details)
 */
struct mm_walk {
951 952 953 954 955 956 957 958 959 960 961 962 963
	int (*pgd_entry)(pgd_t *pgd, unsigned long addr,
			 unsigned long next, struct mm_walk *walk);
	int (*pud_entry)(pud_t *pud, unsigned long addr,
	                 unsigned long next, struct mm_walk *walk);
	int (*pmd_entry)(pmd_t *pmd, unsigned long addr,
			 unsigned long next, struct mm_walk *walk);
	int (*pte_entry)(pte_t *pte, unsigned long addr,
			 unsigned long next, struct mm_walk *walk);
	int (*pte_hole)(unsigned long addr, unsigned long next,
			struct mm_walk *walk);
	int (*hugetlb_entry)(pte_t *pte, unsigned long hmask,
			     unsigned long addr, unsigned long next,
			     struct mm_walk *walk);
D
Dave Hansen 已提交
964 965
	struct mm_struct *mm;
	void *private;
966 967
};

D
Dave Hansen 已提交
968 969
int walk_page_range(unsigned long addr, unsigned long end,
		struct mm_walk *walk);
970
void free_pgd_range(struct mmu_gather *tlb, unsigned long addr,
971
		unsigned long end, unsigned long floor, unsigned long ceiling);
L
Linus Torvalds 已提交
972 973 974 975
int copy_page_range(struct mm_struct *dst, struct mm_struct *src,
			struct vm_area_struct *vma);
void unmap_mapping_range(struct address_space *mapping,
		loff_t const holebegin, loff_t const holelen, int even_cows);
J
Johannes Weiner 已提交
976 977
int follow_pfn(struct vm_area_struct *vma, unsigned long address,
	unsigned long *pfn);
978 979
int follow_phys(struct vm_area_struct *vma, unsigned long address,
		unsigned int flags, unsigned long *prot, resource_size_t *phys);
980 981
int generic_access_phys(struct vm_area_struct *vma, unsigned long addr,
			void *buf, int len, int write);
L
Linus Torvalds 已提交
982 983 984 985 986 987 988

static inline void unmap_shared_mapping_range(struct address_space *mapping,
		loff_t const holebegin, loff_t const holelen)
{
	unmap_mapping_range(mapping, holebegin, holelen, 0);
}

989
extern void truncate_pagecache(struct inode *inode, loff_t new);
990
extern void truncate_setsize(struct inode *inode, loff_t newsize);
991
void truncate_pagecache_range(struct inode *inode, loff_t offset, loff_t end);
992
int truncate_inode_page(struct address_space *mapping, struct page *page);
993
int generic_error_remove_page(struct address_space *mapping, struct page *page);
994 995
int invalidate_inode_page(struct page *page);

996
#ifdef CONFIG_MMU
N
Nick Piggin 已提交
997
extern int handle_mm_fault(struct mm_struct *mm, struct vm_area_struct *vma,
998
			unsigned long address, unsigned int flags);
999 1000
extern int fixup_user_fault(struct task_struct *tsk, struct mm_struct *mm,
			    unsigned long address, unsigned int fault_flags);
1001 1002 1003
#else
static inline int handle_mm_fault(struct mm_struct *mm,
			struct vm_area_struct *vma, unsigned long address,
1004
			unsigned int flags)
1005 1006 1007 1008 1009
{
	/* should never happen if there's no MMU */
	BUG();
	return VM_FAULT_SIGBUS;
}
1010 1011 1012 1013 1014 1015 1016 1017
static inline int fixup_user_fault(struct task_struct *tsk,
		struct mm_struct *mm, unsigned long address,
		unsigned int fault_flags)
{
	/* should never happen if there's no MMU */
	BUG();
	return -EFAULT;
}
1018
#endif
N
Nick Piggin 已提交
1019

L
Linus Torvalds 已提交
1020
extern int access_process_vm(struct task_struct *tsk, unsigned long addr, void *buf, int len, int write);
S
Stephen Wilson 已提交
1021 1022
extern int access_remote_vm(struct mm_struct *mm, unsigned long addr,
		void *buf, int len, int write);
L
Linus Torvalds 已提交
1023

1024 1025 1026 1027 1028 1029 1030 1031
long __get_user_pages(struct task_struct *tsk, struct mm_struct *mm,
		      unsigned long start, unsigned long nr_pages,
		      unsigned int foll_flags, struct page **pages,
		      struct vm_area_struct **vmas, int *nonblocking);
long get_user_pages(struct task_struct *tsk, struct mm_struct *mm,
		    unsigned long start, unsigned long nr_pages,
		    int write, int force, struct page **pages,
		    struct vm_area_struct **vmas);
1032 1033
int get_user_pages_fast(unsigned long start, int nr_pages, int write,
			struct page **pages);
1034 1035 1036 1037
struct kvec;
int get_kernel_pages(const struct kvec *iov, int nr_pages, int write,
			struct page **pages);
int get_kernel_page(unsigned long start, int write, struct page **pages);
H
Hugh Dickins 已提交
1038
struct page *get_dump_page(unsigned long addr);
L
Linus Torvalds 已提交
1039

1040
extern int try_to_release_page(struct page * page, gfp_t gfp_mask);
1041 1042
extern void do_invalidatepage(struct page *page, unsigned int offset,
			      unsigned int length);
1043

L
Linus Torvalds 已提交
1044
int __set_page_dirty_nobuffers(struct page *page);
1045
int __set_page_dirty_no_writeback(struct page *page);
L
Linus Torvalds 已提交
1046 1047
int redirty_page_for_writepage(struct writeback_control *wbc,
				struct page *page);
1048
void account_page_dirtied(struct page *page, struct address_space *mapping);
M
Michael Rubin 已提交
1049
void account_page_writeback(struct page *page);
1050
int set_page_dirty(struct page *page);
L
Linus Torvalds 已提交
1051 1052 1053
int set_page_dirty_lock(struct page *page);
int clear_page_dirty_for_io(struct page *page);

1054
/* Is the vma a continuation of the stack vma above it? */
1055
static inline int vma_growsdown(struct vm_area_struct *vma, unsigned long addr)
1056 1057 1058 1059
{
	return vma && (vma->vm_end == addr) && (vma->vm_flags & VM_GROWSDOWN);
}

1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081
static inline int stack_guard_page_start(struct vm_area_struct *vma,
					     unsigned long addr)
{
	return (vma->vm_flags & VM_GROWSDOWN) &&
		(vma->vm_start == addr) &&
		!vma_growsdown(vma->vm_prev, addr);
}

/* Is the vma a continuation of the stack vma below it? */
static inline int vma_growsup(struct vm_area_struct *vma, unsigned long addr)
{
	return vma && (vma->vm_start == addr) && (vma->vm_flags & VM_GROWSUP);
}

static inline int stack_guard_page_end(struct vm_area_struct *vma,
					   unsigned long addr)
{
	return (vma->vm_flags & VM_GROWSUP) &&
		(vma->vm_end == addr) &&
		!vma_growsup(vma->vm_next, addr);
}

1082 1083 1084
extern pid_t
vm_is_stack(struct task_struct *task, struct vm_area_struct *vma, int in_group);

1085 1086
extern unsigned long move_page_tables(struct vm_area_struct *vma,
		unsigned long old_addr, struct vm_area_struct *new_vma,
1087 1088
		unsigned long new_addr, unsigned long len,
		bool need_rmap_locks);
1089 1090
extern unsigned long change_protection(struct vm_area_struct *vma, unsigned long start,
			      unsigned long end, pgprot_t newprot,
1091
			      int dirty_accountable, int prot_numa);
1092 1093 1094
extern int mprotect_fixup(struct vm_area_struct *vma,
			  struct vm_area_struct **pprev, unsigned long start,
			  unsigned long end, unsigned long newflags);
L
Linus Torvalds 已提交
1095

1096 1097 1098 1099 1100
/*
 * doesn't attempt to fault and will return short.
 */
int __get_user_pages_fast(unsigned long start, int nr_pages, int write,
			  struct page **pages);
K
KAMEZAWA Hiroyuki 已提交
1101 1102 1103 1104 1105
/*
 * per-process(per-mm_struct) statistics.
 */
static inline unsigned long get_mm_counter(struct mm_struct *mm, int member)
{
1106 1107 1108 1109 1110 1111 1112 1113 1114
	long val = atomic_long_read(&mm->rss_stat.count[member]);

#ifdef SPLIT_RSS_COUNTING
	/*
	 * counter is updated in asynchronous manner and may go to minus.
	 * But it's never be expected number for users.
	 */
	if (val < 0)
		val = 0;
1115
#endif
1116 1117
	return (unsigned long)val;
}
K
KAMEZAWA Hiroyuki 已提交
1118 1119 1120

static inline void add_mm_counter(struct mm_struct *mm, int member, long value)
{
1121
	atomic_long_add(value, &mm->rss_stat.count[member]);
K
KAMEZAWA Hiroyuki 已提交
1122 1123 1124 1125
}

static inline void inc_mm_counter(struct mm_struct *mm, int member)
{
1126
	atomic_long_inc(&mm->rss_stat.count[member]);
K
KAMEZAWA Hiroyuki 已提交
1127 1128 1129 1130
}

static inline void dec_mm_counter(struct mm_struct *mm, int member)
{
1131
	atomic_long_dec(&mm->rss_stat.count[member]);
K
KAMEZAWA Hiroyuki 已提交
1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172
}

static inline unsigned long get_mm_rss(struct mm_struct *mm)
{
	return get_mm_counter(mm, MM_FILEPAGES) +
		get_mm_counter(mm, MM_ANONPAGES);
}

static inline unsigned long get_mm_hiwater_rss(struct mm_struct *mm)
{
	return max(mm->hiwater_rss, get_mm_rss(mm));
}

static inline unsigned long get_mm_hiwater_vm(struct mm_struct *mm)
{
	return max(mm->hiwater_vm, mm->total_vm);
}

static inline void update_hiwater_rss(struct mm_struct *mm)
{
	unsigned long _rss = get_mm_rss(mm);

	if ((mm)->hiwater_rss < _rss)
		(mm)->hiwater_rss = _rss;
}

static inline void update_hiwater_vm(struct mm_struct *mm)
{
	if (mm->hiwater_vm < mm->total_vm)
		mm->hiwater_vm = mm->total_vm;
}

static inline void setmax_mm_hiwater_rss(unsigned long *maxrss,
					 struct mm_struct *mm)
{
	unsigned long hiwater_rss = get_mm_hiwater_rss(mm);

	if (*maxrss < hiwater_rss)
		*maxrss = hiwater_rss;
}

K
KAMEZAWA Hiroyuki 已提交
1173
#if defined(SPLIT_RSS_COUNTING)
1174
void sync_mm_rss(struct mm_struct *mm);
K
KAMEZAWA Hiroyuki 已提交
1175
#else
1176
static inline void sync_mm_rss(struct mm_struct *mm)
K
KAMEZAWA Hiroyuki 已提交
1177 1178 1179
{
}
#endif
1180

A
Alexey Dobriyan 已提交
1181
int vma_wants_writenotify(struct vm_area_struct *vma);
1182

1183 1184 1185 1186 1187 1188 1189 1190 1191
extern pte_t *__get_locked_pte(struct mm_struct *mm, unsigned long addr,
			       spinlock_t **ptl);
static inline pte_t *get_locked_pte(struct mm_struct *mm, unsigned long addr,
				    spinlock_t **ptl)
{
	pte_t *ptep;
	__cond_lock(*ptl, ptep = __get_locked_pte(mm, addr, ptl));
	return ptep;
}
1192

N
Nick Piggin 已提交
1193 1194 1195 1196 1197 1198 1199
#ifdef __PAGETABLE_PUD_FOLDED
static inline int __pud_alloc(struct mm_struct *mm, pgd_t *pgd,
						unsigned long address)
{
	return 0;
}
#else
1200
int __pud_alloc(struct mm_struct *mm, pgd_t *pgd, unsigned long address);
N
Nick Piggin 已提交
1201 1202 1203 1204 1205 1206 1207 1208 1209
#endif

#ifdef __PAGETABLE_PMD_FOLDED
static inline int __pmd_alloc(struct mm_struct *mm, pud_t *pud,
						unsigned long address)
{
	return 0;
}
#else
1210
int __pmd_alloc(struct mm_struct *mm, pud_t *pud, unsigned long address);
N
Nick Piggin 已提交
1211 1212
#endif

1213 1214
int __pte_alloc(struct mm_struct *mm, struct vm_area_struct *vma,
		pmd_t *pmd, unsigned long address);
1215 1216
int __pte_alloc_kernel(pmd_t *pmd, unsigned long address);

L
Linus Torvalds 已提交
1217 1218 1219 1220
/*
 * The following ifdef needed to get the 4level-fixup.h header to work.
 * Remove it when 4level-fixup.h has been removed.
 */
1221
#if defined(CONFIG_MMU) && !defined(__ARCH_HAS_4LEVEL_HACK)
L
Linus Torvalds 已提交
1222 1223
static inline pud_t *pud_alloc(struct mm_struct *mm, pgd_t *pgd, unsigned long address)
{
1224 1225
	return (unlikely(pgd_none(*pgd)) && __pud_alloc(mm, pgd, address))?
		NULL: pud_offset(pgd, address);
L
Linus Torvalds 已提交
1226 1227 1228 1229
}

static inline pmd_t *pmd_alloc(struct mm_struct *mm, pud_t *pud, unsigned long address)
{
1230 1231
	return (unlikely(pud_none(*pud)) && __pmd_alloc(mm, pud, address))?
		NULL: pmd_offset(pud, address);
L
Linus Torvalds 已提交
1232
}
1233 1234
#endif /* CONFIG_MMU && !__ARCH_HAS_4LEVEL_HACK */

1235
#if USE_SPLIT_PTLOCKS
H
Hugh Dickins 已提交
1236 1237 1238 1239 1240 1241
/*
 * We tuck a spinlock to guard each pagetable page into its struct page,
 * at page->private, with BUILD_BUG_ON to make sure that this will not
 * overflow into the next struct page (as it might with DEBUG_SPINLOCK).
 * When freeing, reset page->mapping so free_pages_check won't complain.
 */
A
Andrew Morton 已提交
1242
#define __pte_lockptr(page)	&((page)->ptl)
H
Hugh Dickins 已提交
1243 1244 1245 1246 1247
#define pte_lock_init(_page)	do {					\
	spin_lock_init(__pte_lockptr(_page));				\
} while (0)
#define pte_lock_deinit(page)	((page)->mapping = NULL)
#define pte_lockptr(mm, pmd)	({(void)(mm); __pte_lockptr(pmd_page(*(pmd)));})
1248
#else	/* !USE_SPLIT_PTLOCKS */
H
Hugh Dickins 已提交
1249 1250 1251 1252 1253 1254
/*
 * We use mm->page_table_lock to guard all pagetable pages of the mm.
 */
#define pte_lock_init(page)	do {} while (0)
#define pte_lock_deinit(page)	do {} while (0)
#define pte_lockptr(mm, pmd)	({(void)(pmd); &(mm)->page_table_lock;})
1255
#endif /* USE_SPLIT_PTLOCKS */
H
Hugh Dickins 已提交
1256

1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268
static inline void pgtable_page_ctor(struct page *page)
{
	pte_lock_init(page);
	inc_zone_page_state(page, NR_PAGETABLE);
}

static inline void pgtable_page_dtor(struct page *page)
{
	pte_lock_deinit(page);
	dec_zone_page_state(page, NR_PAGETABLE);
}

H
Hugh Dickins 已提交
1269 1270
#define pte_offset_map_lock(mm, pmd, address, ptlp)	\
({							\
H
Hugh Dickins 已提交
1271
	spinlock_t *__ptl = pte_lockptr(mm, pmd);	\
H
Hugh Dickins 已提交
1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282
	pte_t *__pte = pte_offset_map(pmd, address);	\
	*(ptlp) = __ptl;				\
	spin_lock(__ptl);				\
	__pte;						\
})

#define pte_unmap_unlock(pte, ptl)	do {		\
	spin_unlock(ptl);				\
	pte_unmap(pte);					\
} while (0)

1283 1284 1285 1286
#define pte_alloc_map(mm, vma, pmd, address)				\
	((unlikely(pmd_none(*(pmd))) && __pte_alloc(mm, vma,	\
							pmd, address))?	\
	 NULL: pte_offset_map(pmd, address))
1287

H
Hugh Dickins 已提交
1288
#define pte_alloc_map_lock(mm, pmd, address, ptlp)	\
1289 1290
	((unlikely(pmd_none(*(pmd))) && __pte_alloc(mm, NULL,	\
							pmd, address))?	\
H
Hugh Dickins 已提交
1291 1292
		NULL: pte_offset_map_lock(mm, pmd, address, ptlp))

1293
#define pte_alloc_kernel(pmd, address)			\
1294
	((unlikely(pmd_none(*(pmd))) && __pte_alloc_kernel(pmd, address))? \
1295
		NULL: pte_offset_kernel(pmd, address))
L
Linus Torvalds 已提交
1296 1297

extern void free_area_init(unsigned long * zones_size);
1298 1299
extern void free_area_init_node(int nid, unsigned long * zones_size,
		unsigned long zone_start_pfn, unsigned long *zholes_size);
1300 1301
extern void free_initmem(void);

1302 1303 1304
/*
 * Free reserved pages within range [PAGE_ALIGN(start), end & PAGE_MASK)
 * into the buddy system. The freed pages will be poisoned with pattern
1305
 * "poison" if it's within range [0, UCHAR_MAX].
1306 1307
 * Return pages freed into the buddy system.
 */
1308
extern unsigned long free_reserved_area(void *start, void *end,
1309
					int poison, char *s);
1310

1311 1312 1313 1314 1315 1316 1317
#ifdef	CONFIG_HIGHMEM
/*
 * Free a highmem page into the buddy system, adjusting totalhigh_pages
 * and totalram_pages.
 */
extern void free_highmem_page(struct page *page);
#endif
1318

1319
extern void adjust_managed_page_count(struct page *page, long count);
1320
extern void mem_init_print_info(const char *str);
1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343

/* Free the reserved page into the buddy system, so it gets managed. */
static inline void __free_reserved_page(struct page *page)
{
	ClearPageReserved(page);
	init_page_count(page);
	__free_page(page);
}

static inline void free_reserved_page(struct page *page)
{
	__free_reserved_page(page);
	adjust_managed_page_count(page, 1);
}

static inline void mark_page_reserved(struct page *page)
{
	SetPageReserved(page);
	adjust_managed_page_count(page, -1);
}

/*
 * Default method to free all the __init memory into the buddy system.
1344 1345 1346
 * The freed pages will be poisoned with pattern "poison" if it's within
 * range [0, UCHAR_MAX].
 * Return pages freed into the buddy system.
1347 1348 1349 1350 1351
 */
static inline unsigned long free_initmem_default(int poison)
{
	extern char __init_begin[], __init_end[];

1352
	return free_reserved_area(&__init_begin, &__init_end,
1353 1354 1355
				  poison, "unused kernel");
}

1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366
static inline unsigned long get_num_physpages(void)
{
	int nid;
	unsigned long phys_pages = 0;

	for_each_online_node(nid)
		phys_pages += node_present_pages(nid);

	return phys_pages;
}

T
Tejun Heo 已提交
1367
#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
1368
/*
T
Tejun Heo 已提交
1369
 * With CONFIG_HAVE_MEMBLOCK_NODE_MAP set, an architecture may initialise its
1370 1371 1372 1373 1374 1375
 * zones, allocate the backing mem_map and account for memory holes in a more
 * architecture independent manner. This is a substitute for creating the
 * zone_sizes[] and zholes_size[] arrays and passing them to
 * free_area_init_node()
 *
 * An architecture is expected to register range of page frames backed by
T
Tejun Heo 已提交
1376
 * physical memory with memblock_add[_node]() before calling
1377 1378 1379 1380 1381 1382
 * free_area_init_nodes() passing in the PFN each zone ends at. At a basic
 * usage, an architecture is expected to do something like
 *
 * unsigned long max_zone_pfns[MAX_NR_ZONES] = {max_dma, max_normal_pfn,
 * 							 max_highmem_pfn};
 * for_each_valid_physical_page_range()
T
Tejun Heo 已提交
1383
 * 	memblock_add_node(base, size, nid)
1384 1385
 * free_area_init_nodes(max_zone_pfns);
 *
T
Tejun Heo 已提交
1386 1387 1388 1389
 * free_bootmem_with_active_regions() calls free_bootmem_node() for each
 * registered physical page range.  Similarly
 * sparse_memory_present_with_active_regions() calls memory_present() for
 * each range when SPARSEMEM is enabled.
1390 1391
 *
 * See mm/page_alloc.c for more information on each function exposed by
T
Tejun Heo 已提交
1392
 * CONFIG_HAVE_MEMBLOCK_NODE_MAP.
1393 1394
 */
extern void free_area_init_nodes(unsigned long *max_zone_pfn);
1395
unsigned long node_map_pfn_alignment(void);
1396 1397
unsigned long __absent_pages_in_range(int nid, unsigned long start_pfn,
						unsigned long end_pfn);
1398 1399 1400 1401 1402 1403 1404 1405
extern unsigned long absent_pages_in_range(unsigned long start_pfn,
						unsigned long end_pfn);
extern void get_pfn_range_for_nid(unsigned int nid,
			unsigned long *start_pfn, unsigned long *end_pfn);
extern unsigned long find_min_pfn_with_active_regions(void);
extern void free_bootmem_with_active_regions(int nid,
						unsigned long max_low_pfn);
extern void sparse_memory_present_with_active_regions(int nid);
1406

T
Tejun Heo 已提交
1407
#endif /* CONFIG_HAVE_MEMBLOCK_NODE_MAP */
1408

T
Tejun Heo 已提交
1409
#if !defined(CONFIG_HAVE_MEMBLOCK_NODE_MAP) && \
1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423
    !defined(CONFIG_HAVE_ARCH_EARLY_PFN_TO_NID)
static inline int __early_pfn_to_nid(unsigned long pfn)
{
	return 0;
}
#else
/* please see mm/page_alloc.c */
extern int __meminit early_pfn_to_nid(unsigned long pfn);
#ifdef CONFIG_HAVE_ARCH_EARLY_PFN_TO_NID
/* there is a per-arch backend function. */
extern int __meminit __early_pfn_to_nid(unsigned long pfn);
#endif /* CONFIG_HAVE_ARCH_EARLY_PFN_TO_NID */
#endif

1424
extern void set_dma_reserve(unsigned long new_dma_reserve);
D
Dave Hansen 已提交
1425 1426
extern void memmap_init_zone(unsigned long, int, unsigned long,
				unsigned long, enum memmap_context);
1427
extern void setup_per_zone_wmarks(void);
1428
extern int __meminit init_per_zone_wmark_min(void);
L
Linus Torvalds 已提交
1429
extern void mem_init(void);
1430
extern void __init mmap_init(void);
1431
extern void show_mem(unsigned int flags);
L
Linus Torvalds 已提交
1432 1433 1434
extern void si_meminfo(struct sysinfo * val);
extern void si_meminfo_node(struct sysinfo *val, int nid);

J
Joe Perches 已提交
1435 1436
extern __printf(3, 4)
void warn_alloc_failed(gfp_t gfp_mask, int order, const char *fmt, ...);
1437

1438 1439
extern void setup_per_cpu_pageset(void);

1440
extern void zone_pcp_update(struct zone *zone);
1441
extern void zone_pcp_reset(struct zone *zone);
1442

1443 1444 1445
/* page_alloc.c */
extern int min_free_kbytes;

1446
/* nommu.c */
1447
extern atomic_long_t mmap_pages_allocated;
1448
extern int nommu_shrink_inode_mappings(struct inode *, size_t, size_t);
1449

1450 1451 1452
/* interval_tree.c */
void vma_interval_tree_insert(struct vm_area_struct *node,
			      struct rb_root *root);
M
Michel Lespinasse 已提交
1453 1454 1455
void vma_interval_tree_insert_after(struct vm_area_struct *node,
				    struct vm_area_struct *prev,
				    struct rb_root *root);
1456 1457 1458 1459 1460 1461 1462 1463 1464 1465
void vma_interval_tree_remove(struct vm_area_struct *node,
			      struct rb_root *root);
struct vm_area_struct *vma_interval_tree_iter_first(struct rb_root *root,
				unsigned long start, unsigned long last);
struct vm_area_struct *vma_interval_tree_iter_next(struct vm_area_struct *node,
				unsigned long start, unsigned long last);

#define vma_interval_tree_foreach(vma, root, start, last)		\
	for (vma = vma_interval_tree_iter_first(root, start, last);	\
	     vma; vma = vma_interval_tree_iter_next(vma, start, last))
L
Linus Torvalds 已提交
1466 1467 1468 1469

static inline void vma_nonlinear_insert(struct vm_area_struct *vma,
					struct list_head *list)
{
1470
	list_add_tail(&vma->shared.nonlinear, list);
L
Linus Torvalds 已提交
1471 1472
}

1473 1474 1475 1476 1477 1478 1479 1480
void anon_vma_interval_tree_insert(struct anon_vma_chain *node,
				   struct rb_root *root);
void anon_vma_interval_tree_remove(struct anon_vma_chain *node,
				   struct rb_root *root);
struct anon_vma_chain *anon_vma_interval_tree_iter_first(
	struct rb_root *root, unsigned long start, unsigned long last);
struct anon_vma_chain *anon_vma_interval_tree_iter_next(
	struct anon_vma_chain *node, unsigned long start, unsigned long last);
1481 1482 1483
#ifdef CONFIG_DEBUG_VM_RB
void anon_vma_interval_tree_verify(struct anon_vma_chain *node);
#endif
1484 1485 1486 1487 1488

#define anon_vma_interval_tree_foreach(avc, root, start, last)		 \
	for (avc = anon_vma_interval_tree_iter_first(root, start, last); \
	     avc; avc = anon_vma_interval_tree_iter_next(avc, start, last))

L
Linus Torvalds 已提交
1489
/* mmap.c */
1490
extern int __vm_enough_memory(struct mm_struct *mm, long pages, int cap_sys_admin);
1491
extern int vma_adjust(struct vm_area_struct *vma, unsigned long start,
L
Linus Torvalds 已提交
1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502
	unsigned long end, pgoff_t pgoff, struct vm_area_struct *insert);
extern struct vm_area_struct *vma_merge(struct mm_struct *,
	struct vm_area_struct *prev, unsigned long addr, unsigned long end,
	unsigned long vm_flags, struct anon_vma *, struct file *, pgoff_t,
	struct mempolicy *);
extern struct anon_vma *find_mergeable_anon_vma(struct vm_area_struct *);
extern int split_vma(struct mm_struct *,
	struct vm_area_struct *, unsigned long addr, int new_below);
extern int insert_vm_struct(struct mm_struct *, struct vm_area_struct *);
extern void __vma_link_rb(struct mm_struct *, struct vm_area_struct *,
	struct rb_node **, struct rb_node *);
1503
extern void unlink_file_vma(struct vm_area_struct *);
L
Linus Torvalds 已提交
1504
extern struct vm_area_struct *copy_vma(struct vm_area_struct **,
1505 1506
	unsigned long addr, unsigned long len, pgoff_t pgoff,
	bool *need_rmap_locks);
L
Linus Torvalds 已提交
1507
extern void exit_mmap(struct mm_struct *);
M
Matt Helsley 已提交
1508

1509 1510 1511
extern int mm_take_all_locks(struct mm_struct *mm);
extern void mm_drop_all_locks(struct mm_struct *mm);

1512 1513
extern void set_mm_exe_file(struct mm_struct *mm, struct file *new_exe_file);
extern struct file *get_mm_exe_file(struct mm_struct *mm);
M
Matt Helsley 已提交
1514

A
akpm@osdl.org 已提交
1515
extern int may_expand_vm(struct mm_struct *mm, unsigned long npages);
1516 1517 1518
extern int install_special_mapping(struct mm_struct *mm,
				   unsigned long addr, unsigned long len,
				   unsigned long flags, struct page **pages);
L
Linus Torvalds 已提交
1519 1520 1521

extern unsigned long get_unmapped_area(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);

M
Miklos Szeredi 已提交
1522
extern unsigned long mmap_region(struct file *file, unsigned long addr,
1523
	unsigned long len, vm_flags_t vm_flags, unsigned long pgoff);
1524 1525
extern unsigned long do_mmap_pgoff(struct file *file, unsigned long addr,
	unsigned long len, unsigned long prot, unsigned long flags,
1526
	unsigned long pgoff, unsigned long *populate);
L
Linus Torvalds 已提交
1527 1528
extern int do_munmap(struct mm_struct *, unsigned long, size_t);

1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540
#ifdef CONFIG_MMU
extern int __mm_populate(unsigned long addr, unsigned long len,
			 int ignore_errors);
static inline void mm_populate(unsigned long addr, unsigned long len)
{
	/* Ignore errors */
	(void) __mm_populate(addr, len, 1);
}
#else
static inline void mm_populate(unsigned long addr, unsigned long len) {}
#endif

1541 1542
/* These take the mm semaphore themselves */
extern unsigned long vm_brk(unsigned long, unsigned long);
A
Al Viro 已提交
1543
extern int vm_munmap(unsigned long, size_t);
1544 1545 1546
extern unsigned long vm_mmap(struct file *, unsigned long,
        unsigned long, unsigned long,
        unsigned long, unsigned long);
L
Linus Torvalds 已提交
1547

1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578
struct vm_unmapped_area_info {
#define VM_UNMAPPED_AREA_TOPDOWN 1
	unsigned long flags;
	unsigned long length;
	unsigned long low_limit;
	unsigned long high_limit;
	unsigned long align_mask;
	unsigned long align_offset;
};

extern unsigned long unmapped_area(struct vm_unmapped_area_info *info);
extern unsigned long unmapped_area_topdown(struct vm_unmapped_area_info *info);

/*
 * Search for an unmapped address range.
 *
 * We are looking for a range that:
 * - does not intersect with any VMA;
 * - is contained within the [low_limit, high_limit) interval;
 * - is at least the desired size.
 * - satisfies (begin_addr & align_mask) == (align_offset & align_mask)
 */
static inline unsigned long
vm_unmapped_area(struct vm_unmapped_area_info *info)
{
	if (!(info->flags & VM_UNMAPPED_AREA_TOPDOWN))
		return unmapped_area(info);
	else
		return unmapped_area_topdown(info);
}

1579
/* truncate.c */
L
Linus Torvalds 已提交
1580
extern void truncate_inode_pages(struct address_space *, loff_t);
1581 1582
extern void truncate_inode_pages_range(struct address_space *,
				       loff_t lstart, loff_t lend);
L
Linus Torvalds 已提交
1583 1584

/* generic vm_area_ops exported for stackable file systems */
N
Nick Piggin 已提交
1585
extern int filemap_fault(struct vm_area_struct *, struct vm_fault *);
1586
extern int filemap_page_mkwrite(struct vm_area_struct *vma, struct vm_fault *vmf);
L
Linus Torvalds 已提交
1587 1588 1589

/* mm/page-writeback.c */
int write_one_page(struct page *page, int wait);
N
Nick Piggin 已提交
1590
void task_dirty_inc(struct task_struct *tsk);
L
Linus Torvalds 已提交
1591 1592 1593 1594 1595 1596

/* readahead.c */
#define VM_MAX_READAHEAD	128	/* kbytes */
#define VM_MIN_READAHEAD	16	/* kbytes (includes current page) */

int force_page_cache_readahead(struct address_space *mapping, struct file *filp,
A
Andrew Morton 已提交
1597
			pgoff_t offset, unsigned long nr_to_read);
1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611

void page_cache_sync_readahead(struct address_space *mapping,
			       struct file_ra_state *ra,
			       struct file *filp,
			       pgoff_t offset,
			       unsigned long size);

void page_cache_async_readahead(struct address_space *mapping,
				struct file_ra_state *ra,
				struct file *filp,
				struct page *pg,
				pgoff_t offset,
				unsigned long size);

L
Linus Torvalds 已提交
1612
unsigned long max_sane_readahead(unsigned long nr);
1613 1614 1615
unsigned long ra_submit(struct file_ra_state *ra,
			struct address_space *mapping,
			struct file *filp);
L
Linus Torvalds 已提交
1616

1617
/* Generic expand stack which grows the stack according to GROWS{UP,DOWN} */
H
Hugh Dickins 已提交
1618
extern int expand_stack(struct vm_area_struct *vma, unsigned long address);
1619 1620 1621 1622

/* CONFIG_STACK_GROWSUP still needs to to grow downwards at some places */
extern int expand_downwards(struct vm_area_struct *vma,
		unsigned long address);
1623
#if VM_GROWSUP
H
Hugh Dickins 已提交
1624
extern int expand_upwards(struct vm_area_struct *vma, unsigned long address);
1625 1626
#else
  #define expand_upwards(vma, address) do { } while (0)
1627
#endif
L
Linus Torvalds 已提交
1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649

/* Look up the first VMA which satisfies  addr < vm_end,  NULL if none. */
extern struct vm_area_struct * find_vma(struct mm_struct * mm, unsigned long addr);
extern struct vm_area_struct * find_vma_prev(struct mm_struct * mm, unsigned long addr,
					     struct vm_area_struct **pprev);

/* Look up the first VMA which intersects the interval start_addr..end_addr-1,
   NULL if none.  Assume start_addr < end_addr. */
static inline struct vm_area_struct * find_vma_intersection(struct mm_struct * mm, unsigned long start_addr, unsigned long end_addr)
{
	struct vm_area_struct * vma = find_vma(mm,start_addr);

	if (vma && end_addr <= vma->vm_start)
		vma = NULL;
	return vma;
}

static inline unsigned long vma_pages(struct vm_area_struct *vma)
{
	return (vma->vm_end - vma->vm_start) >> PAGE_SHIFT;
}

1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661
/* Look up the first VMA which exactly match the interval vm_start ... vm_end */
static inline struct vm_area_struct *find_exact_vma(struct mm_struct *mm,
				unsigned long vm_start, unsigned long vm_end)
{
	struct vm_area_struct *vma = find_vma(mm, vm_start);

	if (vma && (vma->vm_start != vm_start || vma->vm_end != vm_end))
		vma = NULL;

	return vma;
}

1662
#ifdef CONFIG_MMU
1663
pgprot_t vm_get_page_prot(unsigned long vm_flags);
1664 1665 1666 1667 1668 1669 1670
#else
static inline pgprot_t vm_get_page_prot(unsigned long vm_flags)
{
	return __pgprot(0);
}
#endif

L
Lee Schermerhorn 已提交
1671
#ifdef CONFIG_ARCH_USES_NUMA_PROT_NONE
1672
unsigned long change_prot_numa(struct vm_area_struct *vma,
L
Lee Schermerhorn 已提交
1673 1674 1675
			unsigned long start, unsigned long end);
#endif

1676 1677 1678
struct vm_area_struct *find_extend_vma(struct mm_struct *, unsigned long addr);
int remap_pfn_range(struct vm_area_struct *, unsigned long addr,
			unsigned long pfn, unsigned long size, pgprot_t);
1679
int vm_insert_page(struct vm_area_struct *, unsigned long addr, struct page *);
N
Nick Piggin 已提交
1680 1681
int vm_insert_pfn(struct vm_area_struct *vma, unsigned long addr,
			unsigned long pfn);
N
Nick Piggin 已提交
1682 1683
int vm_insert_mixed(struct vm_area_struct *vma, unsigned long addr,
			unsigned long pfn);
1684 1685
int vm_iomap_memory(struct vm_area_struct *vma, phys_addr_t start, unsigned long len);

1686

1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697
struct page *follow_page_mask(struct vm_area_struct *vma,
			      unsigned long address, unsigned int foll_flags,
			      unsigned int *page_mask);

static inline struct page *follow_page(struct vm_area_struct *vma,
		unsigned long address, unsigned int foll_flags)
{
	unsigned int unused_page_mask;
	return follow_page_mask(vma, address, foll_flags, &unused_page_mask);
}

1698 1699 1700
#define FOLL_WRITE	0x01	/* check pte is writable */
#define FOLL_TOUCH	0x02	/* mark page accessed */
#define FOLL_GET	0x04	/* do get_page on page */
H
Hugh Dickins 已提交
1701
#define FOLL_DUMP	0x08	/* give error on hole if it would be zero */
H
Hugh Dickins 已提交
1702
#define FOLL_FORCE	0x10	/* get_user_pages read/write w/o permission */
1703 1704
#define FOLL_NOWAIT	0x20	/* if a disk transfer is needed, start the IO
				 * and return without waiting upon it */
1705
#define FOLL_MLOCK	0x40	/* mark page as mlocked */
1706
#define FOLL_SPLIT	0x80	/* don't return transhuge pages, split them */
1707
#define FOLL_HWPOISON	0x100	/* check page is hwpoisoned */
1708
#define FOLL_NUMA	0x200	/* force NUMA hinting page fault */
1709
#define FOLL_MIGRATION	0x400	/* wait for page to replace migration entry */
L
Linus Torvalds 已提交
1710

1711
typedef int (*pte_fn_t)(pte_t *pte, pgtable_t token, unsigned long addr,
1712 1713 1714 1715
			void *data);
extern int apply_to_page_range(struct mm_struct *mm, unsigned long address,
			       unsigned long size, pte_fn_t fn, void *data);

L
Linus Torvalds 已提交
1716
#ifdef CONFIG_PROC_FS
1717
void vm_stat_account(struct mm_struct *, unsigned long, struct file *, long);
L
Linus Torvalds 已提交
1718
#else
1719
static inline void vm_stat_account(struct mm_struct *mm,
L
Linus Torvalds 已提交
1720 1721
			unsigned long flags, struct file *file, long pages)
{
1722
	mm->total_vm += pages;
L
Linus Torvalds 已提交
1723 1724 1725
}
#endif /* CONFIG_PROC_FS */

1726 1727
#ifdef CONFIG_DEBUG_PAGEALLOC
extern void kernel_map_pages(struct page *page, int numpages, int enable);
1728 1729 1730
#ifdef CONFIG_HIBERNATION
extern bool kernel_page_present(struct page *page);
#endif /* CONFIG_HIBERNATION */
1731
#else
L
Linus Torvalds 已提交
1732
static inline void
N
Nick Piggin 已提交
1733
kernel_map_pages(struct page *page, int numpages, int enable) {}
1734 1735 1736
#ifdef CONFIG_HIBERNATION
static inline bool kernel_page_present(struct page *page) { return true; }
#endif /* CONFIG_HIBERNATION */
L
Linus Torvalds 已提交
1737 1738
#endif

1739
extern struct vm_area_struct *get_gate_vma(struct mm_struct *mm);
L
Linus Torvalds 已提交
1740
#ifdef	__HAVE_ARCH_GATE_AREA
1741
int in_gate_area_no_mm(unsigned long addr);
1742
int in_gate_area(struct mm_struct *mm, unsigned long addr);
L
Linus Torvalds 已提交
1743
#else
1744 1745
int in_gate_area_no_mm(unsigned long addr);
#define in_gate_area(mm, addr) ({(void)mm; in_gate_area_no_mm(addr);})
L
Linus Torvalds 已提交
1746 1747
#endif	/* __HAVE_ARCH_GATE_AREA */

1748 1749
#ifdef CONFIG_SYSCTL
extern int sysctl_drop_caches;
1750
int drop_caches_sysctl_handler(struct ctl_table *, int,
A
Andrew Morton 已提交
1751
					void __user *, size_t *, loff_t *);
1752 1753
#endif

1754
unsigned long shrink_slab(struct shrink_control *shrink,
1755 1756
			  unsigned long nr_pages_scanned,
			  unsigned long lru_pages);
A
Andrew Morton 已提交
1757

1758 1759 1760
#ifndef CONFIG_MMU
#define randomize_va_space 0
#else
1761
extern int randomize_va_space;
1762
#endif
1763

1764
const char * arch_vma_name(struct vm_area_struct *vma);
1765
void print_vma_addr(char *prefix, unsigned long rip);
1766

1767 1768 1769 1770 1771 1772
void sparse_mem_maps_populate_node(struct page **map_map,
				   unsigned long pnum_begin,
				   unsigned long pnum_end,
				   unsigned long map_count,
				   int nodeid);

1773
struct page *sparse_mem_map_populate(unsigned long pnum, int nid);
1774 1775 1776 1777
pgd_t *vmemmap_pgd_populate(unsigned long addr, int node);
pud_t *vmemmap_pud_populate(pgd_t *pgd, unsigned long addr, int node);
pmd_t *vmemmap_pmd_populate(pud_t *pud, unsigned long addr, int node);
pte_t *vmemmap_pte_populate(pmd_t *pmd, unsigned long addr, int node);
1778
void *vmemmap_alloc_block(unsigned long size, int node);
1779
void *vmemmap_alloc_block_buf(unsigned long size, int node);
1780
void vmemmap_verify(pte_t *, int, unsigned long, unsigned long);
1781 1782 1783
int vmemmap_populate_basepages(unsigned long start, unsigned long end,
			       int node);
int vmemmap_populate(unsigned long start, unsigned long end, int node);
1784
void vmemmap_populate_print_last(void);
1785
#ifdef CONFIG_MEMORY_HOTPLUG
1786
void vmemmap_free(unsigned long start, unsigned long end);
1787
#endif
1788 1789
void register_page_bootmem_memmap(unsigned long section_nr, struct page *map,
				  unsigned long size);
1790

1791 1792
enum mf_flags {
	MF_COUNT_INCREASED = 1 << 0,
1793
	MF_ACTION_REQUIRED = 1 << 1,
1794
	MF_MUST_KILL = 1 << 2,
1795
	MF_SOFT_OFFLINE = 1 << 3,
1796
};
1797
extern int memory_failure(unsigned long pfn, int trapno, int flags);
1798
extern void memory_failure_queue(unsigned long pfn, int trapno, int flags);
W
Wu Fengguang 已提交
1799
extern int unpoison_memory(unsigned long pfn);
1800 1801
extern int sysctl_memory_failure_early_kill;
extern int sysctl_memory_failure_recovery;
1802
extern void shake_page(struct page *p, int access);
1803
extern atomic_long_t num_poisoned_pages;
1804
extern int soft_offline_page(struct page *page, int flags);
1805

1806 1807
extern void dump_page(struct page *page);

A
Andrea Arcangeli 已提交
1808 1809 1810 1811 1812 1813 1814 1815 1816
#if defined(CONFIG_TRANSPARENT_HUGEPAGE) || defined(CONFIG_HUGETLBFS)
extern void clear_huge_page(struct page *page,
			    unsigned long addr,
			    unsigned int pages_per_huge_page);
extern void copy_user_huge_page(struct page *dst, struct page *src,
				unsigned long addr, struct vm_area_struct *vma,
				unsigned int pages_per_huge_page);
#endif /* CONFIG_TRANSPARENT_HUGEPAGE || CONFIG_HUGETLBFS */

1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833
#ifdef CONFIG_DEBUG_PAGEALLOC
extern unsigned int _debug_guardpage_minorder;

static inline unsigned int debug_guardpage_minorder(void)
{
	return _debug_guardpage_minorder;
}

static inline bool page_is_guard(struct page *page)
{
	return test_bit(PAGE_DEBUG_FLAG_GUARD, &page->debug_flags);
}
#else
static inline unsigned int debug_guardpage_minorder(void) { return 0; }
static inline bool page_is_guard(struct page *page) { return false; }
#endif /* CONFIG_DEBUG_PAGEALLOC */

1834 1835 1836 1837 1838 1839
#if MAX_NUMNODES > 1
void __init setup_nr_node_ids(void);
#else
static inline void setup_nr_node_ids(void) {}
#endif

L
Linus Torvalds 已提交
1840 1841
#endif /* __KERNEL__ */
#endif /* _LINUX_MM_H */