include/linux/mm.h

   1 #ifndef _LINUX_MM_H
   2 #define _LINUX_MM_H
   3
   4 #include <linux/sched.h>
   5 #include <linux/errno.h>
   6
   7 #ifdef __KERNEL__
   8
   9 #include <linux/config.h>
  10 #include <linux/gfp.h>
  11 #include <linux/list.h>
  12 #include <linux/mmzone.h>
  13 #include <linux/rbtree.h>
  14 #include <linux/prio_tree.h>
  15 #include <linux/fs.h>
  16
  17 struct mempolicy;
  18 struct anon_vma;
  19
  20 #ifndef CONFIG_DISCONTIGMEM          /* Don't use mapnrs, do it properly */
  21 extern unsigned long max_mapnr;
  22 #endif
  23
  24 extern unsigned long num_physpages;
  25 extern void * high_memory;
  26 extern unsigned long vmalloc_earlyreserve;
  27 extern int page_cluster;
  28
  29 #include <asm/page.h>
  30 #include <asm/pgtable.h>
  31 #include <asm/processor.h>
  32 #include <asm/atomic.h>
  33
  34 #ifndef MM_VM_SIZE
  35 #define MM_VM_SIZE(mm)  TASK_SIZE
  36 #endif
  37
  38 /*
  39  * Linux kernel virtual memory manager primitives.
  40  * The idea being to have a "virtual" mm in the same way
  41  * we have a virtual fs - giving a cleaner interface to the
  42  * mm details, and allowing different kinds of memory mappings
  43  * (from shared memory to executable loading to arbitrary
  44  * mmap() functions).
  45  */
  46
  47 /*
  48  * This struct defines a memory VMM memory area. There is one of these
  49  * per VM-area/task.  A VM area is any part of the process virtual memory
  50  * space that has a special rule for the page-fault handlers (ie a shared
  51  * library, the executable area etc).
  52  */
  53 struct vm_area_struct {
  54         struct mm_struct * vm_mm;       /* The address space we belong to. */
  55         unsigned long vm_start;         /* Our start address within vm_mm. */
  56         unsigned long vm_end;           /* The first byte after our end address
  57                                            within vm_mm. */
  58
  59         /* linked list of VM areas per task, sorted by address */
  60         struct vm_area_struct *vm_next;
  61
  62         pgprot_t vm_page_prot;          /* Access permissions of this VMA. */
  63         unsigned long vm_flags;         /* Flags, listed below. */
  64
  65         struct rb_node vm_rb;
  66
  67         /*
  68          * For areas with an address space and backing store,
  69          * linkage into the address_space->i_mmap prio tree, or
  70          * linkage to the list of like vmas hanging off its node, or
  71          * linkage of vma in the address_space->i_mmap_nonlinear list.
  72          */
  73         union {
  74                 struct {
  75                         struct list_head list;
  76                         void *parent;   /* aligns with prio_tree_node parent */
  77                         struct vm_area_struct *head;
  78                 } vm_set;
  79
  80                 struct prio_tree_node prio_tree_node;
  81         } shared;
  82
  83         /*
  84          * A file's MAP_PRIVATE vma can be in both i_mmap tree and anon_vma
  85          * list, after a COW of one of the file pages.  A MAP_SHARED vma
  86          * can only be in the i_mmap tree.  An anonymous MAP_PRIVATE, stack
  87          * or brk vma (with NULL file) can only be in an anon_vma list.
  88          */
  89         struct list_head anon_vma_node; /* Serialized by anon_vma->lock */
  90         struct anon_vma *anon_vma;      /* Serialized by page_table_lock */
  91
  92         /* Function pointers to deal with this struct. */
  93         struct vm_operations_struct * vm_ops;
  94
  95         /* Information about our backing store: */
  96         unsigned long vm_pgoff;         /* Offset (within vm_file) in PAGE_SIZE
  97                                            units, *not* PAGE_CACHE_SIZE */
  98         struct file * vm_file;          /* File we map to (can be NULL). */
  99         void * vm_private_data;         /* was vm_pte (shared mem) */
 100
 101 #ifdef CONFIG_NUMA
 102         struct mempolicy *vm_policy;    /* NUMA policy for the VMA */
 103 #endif
 104 };
 105
 106 /*
 107  * vm_flags..
 108  */
 109 #define VM_READ         0x00000001      /* currently active flags */
 110 #define VM_WRITE        0x00000002
 111 #define VM_EXEC         0x00000004
 112 #define VM_SHARED       0x00000008
 113
 114 #define VM_MAYREAD      0x00000010      /* limits for mprotect() etc */
 115 #define VM_MAYWRITE     0x00000020
 116 #define VM_MAYEXEC      0x00000040
 117 #define VM_MAYSHARE     0x00000080
 118
 119 #define VM_GROWSDOWN    0x00000100      /* general info on the segment */
 120 #define VM_GROWSUP      0x00000200
 121 #define VM_SHM          0x00000400      /* shared memory area, don't swap out */
 122 #define VM_DENYWRITE    0x00000800      /* ETXTBSY on write attempts.. */
 123
 124 #define VM_EXECUTABLE   0x00001000
 125 #define VM_LOCKED       0x00002000
 126 #define VM_IO           0x00004000      /* Memory mapped I/O or similar */
 127
 128                                         /* Used by sys_madvise() */
 129 #define VM_SEQ_READ     0x00008000      /* App will access data sequentially */
 130 #define VM_RAND_READ    0x00010000      /* App will not benefit from clustered reads */
 131
 132 #define VM_DONTCOPY     0x00020000      /* Do not copy this vma on fork */
 133 #define VM_DONTEXPAND   0x00040000      /* Cannot expand with mremap() */
 134 #define VM_RESERVED     0x00080000      /* Don't unmap it from swap_out */
 135 #define VM_ACCOUNT      0x00100000      /* Is a VM accounted object */
 136 #define VM_HUGETLB      0x00400000      /* Huge TLB Page VM */
 137 #define VM_NONLINEAR    0x00800000      /* Is non-linear (remap_file_pages) */
 138
 139 #ifndef VM_STACK_DEFAULT_FLAGS          /* arch can override this */
 140 #define VM_STACK_DEFAULT_FLAGS VM_DATA_DEFAULT_FLAGS
 141 #endif
 142
 143 #ifdef CONFIG_STACK_GROWSUP
 144 #define VM_STACK_FLAGS  (VM_GROWSUP | VM_STACK_DEFAULT_FLAGS | VM_ACCOUNT)
 145 #else
 146 #define VM_STACK_FLAGS  (VM_GROWSDOWN | VM_STACK_DEFAULT_FLAGS | VM_ACCOUNT)
 147 #endif
 148
 149 #define VM_READHINTMASK                 (VM_SEQ_READ | VM_RAND_READ)
 150 #define VM_ClearReadHint(v)             (v)->vm_flags &= ~VM_READHINTMASK
 151 #define VM_NormalReadHint(v)            (!((v)->vm_flags & VM_READHINTMASK))
 152 #define VM_SequentialReadHint(v)        ((v)->vm_flags & VM_SEQ_READ)
 153 #define VM_RandomReadHint(v)            ((v)->vm_flags & VM_RAND_READ)
 154
 155 /*
 156  * mapping from the currently active vm_flags protection bits (the
 157  * low four bits) to a page protection mask..
 158  */
 159 extern pgprot_t protection_map[16];
 160
 161
 162 /*
 163  * These are the virtual MM functions - opening of an area, closing and
 164  * unmapping it (needed to keep files on disk up-to-date etc), pointer
 165  * to the functions called when a no-page or a wp-page exception occurs.
 166  */
 167 struct vm_operations_struct {
 168         void (*open)(struct vm_area_struct * area);
 169         void (*close)(struct vm_area_struct * area);
 170         struct page * (*nopage)(struct vm_area_struct * area, unsigned long address, int *type);
 171         int (*populate)(struct vm_area_struct * area, unsigned long address, unsigned long len, pgprot_t prot, unsigned long pgoff, int nonblock);
 172 #ifdef CONFIG_NUMA
 173         int (*set_policy)(struct vm_area_struct *vma, struct mempolicy *new);
 174         struct mempolicy *(*get_policy)(struct vm_area_struct *vma,
 175                                         unsigned long addr);
 176 #endif
 177 };
 178
 179 struct mmu_gather;
 180 struct inode;
 181
 182 #ifdef ARCH_HAS_ATOMIC_UNSIGNED
 183 typedef unsigned page_flags_t;
 184 #else
 185 typedef unsigned long page_flags_t;
 186 #endif
 187
 188 /*
 189  * Each physical page in the system has a struct page associated with
 190  * it to keep track of whatever it is we are using the page for at the
 191  * moment. Note that we have no way to track which tasks are using
 192  * a page.
 193  */
 194 struct page {
 195         page_flags_t flags;             /* Atomic flags, some possibly
 196                                          * updated asynchronously */
 197         atomic_t _count;                /* Usage count, see below. */
 198         unsigned int mapcount;          /* Count of ptes mapped in mms,
 199                                          * to show when page is mapped
 200                                          * & limit reverse map searches,
 201                                          * protected by PG_maplock.
 202                                          */
 203         unsigned long private;          /* Mapping-private opaque data:
 204                                          * usually used for buffer_heads
 205                                          * if PagePrivate set; used for
 206                                          * swp_entry_t if PageSwapCache
 207                                          */
 208         struct address_space *mapping;  /* If PG_anon clear, points to
 209                                          * inode address_space, or NULL.
 210                                          * If page mapped as anonymous
 211                                          * memory, PG_anon is set, and
 212                                          * it points to anon_vma object.
 213                                          */
 214         pgoff_t index;                  /* Our offset within mapping. */
 215         struct list_head lru;           /* Pageout list, eg. active_list
 216                                          * protected by zone->lru_lock !
 217                                          */
 218         /*
 219          * On machines where all RAM is mapped into kernel address space,
 220          * we can simply calculate the virtual address. On machines with
 221          * highmem some memory is mapped into kernel virtual memory
 222          * dynamically, so we need a place to store that address.
 223          * Note that this field could be 16 bits on x86 ... ;)
 224          *
 225          * Architectures with slow multiplication can define
 226          * WANT_PAGE_VIRTUAL in asm/page.h
 227          */
 228 #if defined(WANT_PAGE_VIRTUAL)
 229         void *virtual;                  /* Kernel virtual address (NULL if
 230                                            not kmapped, ie. highmem) */
 231 #endif /* WANT_PAGE_VIRTUAL */
 232 #ifdef CONFIG_CKRM_RES_MEM
 233         void *memclass;
 234 #endif // CONFIG_CKRM_RES_MEM
 235 };
 236
 237 /*
 238  * FIXME: take this include out, include page-flags.h in
 239  * files which need it (119 of them)
 240  */
 241 #include <linux/page-flags.h>
 242
 243 /*
 244  * Methods to modify the page usage count.
 245  *
 246  * What counts for a page usage:
 247  * - cache mapping   (page->mapping)
 248  * - private data    (page->private)
 249  * - page mapped in a task's page tables, each mapping
 250  *   is counted separately
 251  *
 252  * Also, many kernel routines increase the page count before a critical
 253  * routine so they can be sure the page doesn't go away from under them.
 254  *
 255  * Since 2.6.6 (approx), a free page has ->_count = -1.  This is so that we
 256  * can use atomic_add_negative(-1, page->_count) to detect when the page
 257  * becomes free and so that we can also use atomic_inc_and_test to atomically
 258  * detect when we just tried to grab a ref on a page which some other CPU has
 259  * already deemed to be freeable.
 260  *
 261  * NO code should make assumptions about this internal detail!  Use the provided
 262  * macros which retain the old rules: page_count(page) == 0 is a free page.
 263  */
 264
 265 /*
 266  * Drop a ref, return true if the logical refcount fell to zero (the page has
 267  * no users)
 268  */
 269 #define put_page_testzero(p)                            \
 270         ({                                              \
 271                 BUG_ON(page_count(p) == 0);             \
 272                 atomic_add_negative(-1, &(p)->_count);  \
 273         })
 274
 275 /*
 276  * Grab a ref, return true if the page previously had a logical refcount of
 277  * zero.  ie: returns true if we just grabbed an already-deemed-to-be-free page
 278  */
 279 #define get_page_testone(p)     atomic_inc_and_test(&(p)->_count)
 280
 281 #define set_page_count(p,v)     atomic_set(&(p)->_count, v - 1)
 282 #define __put_page(p)           atomic_dec(&(p)->_count)
 283
 284 extern void FASTCALL(__page_cache_release(struct page *));
 285
 286 #ifdef CONFIG_HUGETLB_PAGE
 287
 288 static inline int page_count(struct page *p)
 289 {
 290         if (PageCompound(p))
 291                 p = (struct page *)p->private;
 292         return atomic_read(&(p)->_count) + 1;
 293 }
 294
 295 static inline void get_page(struct page *page)
 296 {
 297         if (unlikely(PageCompound(page)))
 298                 page = (struct page *)page->private;
 299         atomic_inc(&page->_count);
 300 }
 301
 302 void put_page(struct page *page);
 303
 304 #else           /* CONFIG_HUGETLB_PAGE */
 305
 306 #define page_count(p)           (atomic_read(&(p)->_count) + 1)
 307
 308 static inline void get_page(struct page *page)
 309 {
 310         atomic_inc(&page->_count);
 311 }
 312
 313 static inline void put_page(struct page *page)
 314 {
 315         if (!PageReserved(page) && put_page_testzero(page))
 316                 __page_cache_release(page);
 317 }
 318
 319 #endif          /* CONFIG_HUGETLB_PAGE */
 320
 321 /*
 322  * Multiple processes may "see" the same page. E.g. for untouched
 323  * mappings of /dev/null, all processes see the same page full of
 324  * zeroes, and text pages of executables and shared libraries have
 325  * only one copy in memory, at most, normally.
 326  *
 327  * For the non-reserved pages, page_count(page) denotes a reference count.
 328  *   page_count() == 0 means the page is free.
 329  *   page_count() == 1 means the page is used for exactly one purpose
 330  *   (e.g. a private data page of one process).
 331  *
 332  * A page may be used for kmalloc() or anyone else who does a
 333  * __get_free_page(). In this case the page_count() is at least 1, and
 334  * all other fields are unused but should be 0 or NULL. The
 335  * management of this page is the responsibility of the one who uses
 336  * it.
 337  *
 338  * The other pages (we may call them "process pages") are completely
 339  * managed by the Linux memory manager: I/O, buffers, swapping etc.
 340  * The following discussion applies only to them.
 341  *
 342  * A page may belong to an inode's memory mapping. In this case,
 343  * page->mapping is the pointer to the inode, and page->index is the
 344  * file offset of the page, in units of PAGE_CACHE_SIZE.
 345  *
 346  * A page contains an opaque `private' member, which belongs to the
 347  * page's address_space.  Usually, this is the address of a circular
 348  * list of the page's disk buffers.
 349  *
 350  * For pages belonging to inodes, the page_count() is the number of
 351  * attaches, plus 1 if `private' contains something, plus one for
 352  * the page cache itself.
 353  *
 354  * All pages belonging to an inode are in these doubly linked lists:
 355  * mapping->clean_pages, mapping->dirty_pages and mapping->locked_pages;
 356  * using the page->list list_head. These fields are also used for
 357  * freelist managemet (when page_count()==0).
 358  *
 359  * There is also a per-mapping radix tree mapping index to the page
 360  * in memory if present. The tree is rooted at mapping->root.
 361  *
 362  * All process pages can do I/O:
 363  * - inode pages may need to be read from disk,
 364  * - inode pages which have been modified and are MAP_SHARED may need
 365  *   to be written to disk,
 366  * - private pages which have been modified may need to be swapped out
 367  *   to swap space and (later) to be read back into memory.
 368  */
 369
 370 /*
 371  * The zone field is never updated after free_area_init_core()
 372  * sets it, so none of the operations on it need to be atomic.
 373  * We'll have up to (MAX_NUMNODES * MAX_NR_ZONES) zones total,
 374  * so we use (MAX_NODES_SHIFT + MAX_ZONES_SHIFT) here to get enough bits.
 375  */
 376 #define NODEZONE_SHIFT (sizeof(page_flags_t)*8 - MAX_NODES_SHIFT - MAX_ZONES_SHIFT)
 377 #define NODEZONE(node, zone)    ((node << ZONES_SHIFT) | zone)
 378
 379 static inline unsigned long page_zonenum(struct page *page)
 380 {
 381         return (page->flags >> NODEZONE_SHIFT) & (~(~0UL << ZONES_SHIFT));
 382 }
 383 static inline unsigned long page_to_nid(struct page *page)
 384 {
 385         return (page->flags >> (NODEZONE_SHIFT + ZONES_SHIFT));
 386 }
 387
 388 struct zone;
 389 extern struct zone *zone_table[];
 390
 391 static inline struct zone *page_zone(struct page *page)
 392 {
 393         return zone_table[page->flags >> NODEZONE_SHIFT];
 394 }
 395
 396 static inline void set_page_zone(struct page *page, unsigned long nodezone_num)
 397 {
 398         page->flags &= ~(~0UL << NODEZONE_SHIFT);
 399         page->flags |= nodezone_num << NODEZONE_SHIFT;
 400 }
 401
 402 #ifndef CONFIG_DISCONTIGMEM
 403 /* The array of struct pages - for discontigmem use pgdat->lmem_map */
 404 extern struct page *mem_map;
 405 #endif
 406
 407 static inline void *lowmem_page_address(struct page *page)
 408 {
 409         return __va(page_to_pfn(page) << PAGE_SHIFT);
 410 }
 411
 412 #if defined(CONFIG_HIGHMEM) && !defined(WANT_PAGE_VIRTUAL)
 413 #define HASHED_PAGE_VIRTUAL
 414 #endif
 415
 416 #if defined(WANT_PAGE_VIRTUAL)
 417 #define page_address(page) ((page)->virtual)
 418 #define set_page_address(page, address)                 \
 419         do {                                            \
 420                 (page)->virtual = (address);            \
 421         } while(0)
 422 #define page_address_init()  do { } while(0)
 423 #endif
 424
 425 #if defined(HASHED_PAGE_VIRTUAL)
 426 void *page_address(struct page *page);
 427 void set_page_address(struct page *page, void *virtual);
 428 void page_address_init(void);
 429 #endif
 430
 431 #if !defined(HASHED_PAGE_VIRTUAL) && !defined(WANT_PAGE_VIRTUAL)
 432 #define page_address(page) lowmem_page_address(page)
 433 #define set_page_address(page, address)  do { } while(0)
 434 #define page_address_init()  do { } while(0)
 435 #endif
 436
 437 /*
 438  * On an anonymous page mapped into a user virtual memory area,
 439  * page->mapping points to its anon_vma, not to a struct address_space.
 440  *
 441  * Please note that, confusingly, "page_mapping" refers to the inode
 442  * address_space which maps the page from disk; whereas "page_mapped"
 443  * refers to user virtual address space into which the page is mapped.
 444  */
 445 extern struct address_space swapper_space;
 446 static inline struct address_space *page_mapping(struct page *page)
 447 {
 448         struct address_space *mapping = NULL;
 449
 450         if (unlikely(PageSwapCache(page)))
 451                 mapping = &swapper_space;
 452         else if (likely(!PageAnon(page)))
 453                 mapping = page->mapping;
 454         return mapping;
 455 }
 456
 457 /*
 458  * Return the pagecache index of the passed page.  Regular pagecache pages
 459  * use ->index whereas swapcache pages use ->private
 460  */
 461 static inline pgoff_t page_index(struct page *page)
 462 {
 463         if (unlikely(PageSwapCache(page)))
 464                 return page->private;
 465         return page->index;
 466 }
 467
 468 /*
 469  * Return true if this page is mapped into pagetables.
 470  */
 471 static inline int page_mapped(struct page *page)
 472 {
 473         return page->mapcount != 0;
 474 }
 475
 476 /*
 477  * Error return values for the *_nopage functions
 478  */
 479 #define NOPAGE_SIGBUS   (NULL)
 480 #define NOPAGE_OOM      ((struct page *) (-1))
 481
 482 /*
 483  * Different kinds of faults, as returned by handle_mm_fault().
 484  * Used to decide whether a process gets delivered SIGBUS or
 485  * just gets major/minor fault counters bumped up.
 486  */
 487 #define VM_FAULT_OOM    (-1)
 488 #define VM_FAULT_SIGBUS 0
 489 #define VM_FAULT_MINOR  1
 490 #define VM_FAULT_MAJOR  2
 491
 492 #define offset_in_page(p)       ((unsigned long)(p) & ~PAGE_MASK)
 493
 494 extern void show_free_areas(void);
 495
 496 struct page *shmem_nopage(struct vm_area_struct * vma,
 497                         unsigned long address, int *type);
 498 int shmem_set_policy(struct vm_area_struct *vma, struct mempolicy *new);
 499 struct mempolicy *shmem_get_policy(struct vm_area_struct *vma,
 500                                         unsigned long addr);
 501 struct file *shmem_file_setup(char * name, loff_t size, unsigned long flags);
 502 void shmem_lock(struct file * file, int lock);
 503 int shmem_zero_setup(struct vm_area_struct *);
 504
 505 /*
 506  * Parameter block passed down to zap_pte_range in exceptional cases.
 507  */
 508 struct zap_details {
 509         struct vm_area_struct *nonlinear_vma;   /* Check page->index if set */
 510         struct address_space *check_mapping;    /* Check page->mapping if set */
 511         pgoff_t first_index;                    /* Lowest page->index to unmap */
 512         pgoff_t last_index;                     /* Highest page->index to unmap */
 513         int atomic;                             /* May not schedule() */
 514 };
 515
 516 void zap_page_range(struct vm_area_struct *vma, unsigned long address,
 517                 unsigned long size, struct zap_details *);
 518 int unmap_vmas(struct mmu_gather **tlbp, struct mm_struct *mm,
 519                 struct vm_area_struct *start_vma, unsigned long start_addr,
 520                 unsigned long end_addr, unsigned long *nr_accounted,
 521                 struct zap_details *);
 522 void clear_page_tables(struct mmu_gather *tlb, unsigned long first, int nr);
 523 int copy_page_range(struct mm_struct *dst, struct mm_struct *src,
 524                         struct vm_area_struct *vma);
 525 int zeromap_page_range(struct vm_area_struct *vma, unsigned long from,
 526                         unsigned long size, pgprot_t prot);
 527 void unmap_mapping_range(struct address_space *mapping,
 528                 loff_t const holebegin, loff_t const holelen, int even_cows);
 529
 530 static inline void unmap_shared_mapping_range(struct address_space *mapping,
 531                 loff_t const holebegin, loff_t const holelen)
 532 {
 533         unmap_mapping_range(mapping, holebegin, holelen, 0);
 534 }
 535
 536 extern int vmtruncate(struct inode * inode, loff_t offset);
 537 extern pmd_t *FASTCALL(__pmd_alloc(struct mm_struct *mm, pgd_t *pgd, unsigned long address));
 538 extern pte_t *FASTCALL(pte_alloc_kernel(struct mm_struct *mm, pmd_t *pmd, unsigned long address));
 539 extern pte_t *FASTCALL(pte_alloc_map(struct mm_struct *mm, pmd_t *pmd, unsigned long address));
 540 extern int install_page(struct mm_struct *mm, struct vm_area_struct *vma, unsigned long addr, struct page *page, pgprot_t prot);
 541 extern int install_file_pte(struct mm_struct *mm, struct vm_area_struct *vma, unsigned long addr, unsigned long pgoff, pgprot_t prot);
 542 extern int handle_mm_fault(struct mm_struct *mm,struct vm_area_struct *vma, unsigned long address, int write_access);
 543 extern int make_pages_present(unsigned long addr, unsigned long end);
 544 extern int access_process_vm(struct task_struct *tsk, unsigned long addr, void *buf, int len, int write);
 545 void install_arg_page(struct vm_area_struct *, struct page *, unsigned long);
 546
 547 int get_user_pages(struct task_struct *tsk, struct mm_struct *mm, unsigned long start,
 548                 int len, int write, int force, struct page **pages, struct vm_area_struct **vmas);
 549
 550 int __set_page_dirty_buffers(struct page *page);
 551 int __set_page_dirty_nobuffers(struct page *page);
 552 int redirty_page_for_writepage(struct writeback_control *wbc,
 553                                 struct page *page);
 554 int FASTCALL(set_page_dirty(struct page *page));
 555 int set_page_dirty_lock(struct page *page);
 556 int clear_page_dirty_for_io(struct page *page);
 557
 558 /*
 559  * Prototype to add a shrinker callback for ageable caches.
 560  *
 561  * These functions are passed a count `nr_to_scan' and a gfpmask.  They should
 562  * scan `nr_to_scan' objects, attempting to free them.
 563  *
 564  * The callback must the number of objects which remain in the cache.
 565  *
 566  * The callback will be passes nr_to_scan == 0 when the VM is querying the
 567  * cache size, so a fastpath for that case is appropriate.
 568  */
 569 typedef int (*shrinker_t)(int nr_to_scan, unsigned int gfp_mask);
 570
 571 /*
 572  * Add an aging callback.  The int is the number of 'seeks' it takes
 573  * to recreate one of the objects that these functions age.
 574  */
 575
 576 #define DEFAULT_SEEKS 2
 577 struct shrinker;
 578 extern struct shrinker *set_shrinker(int, shrinker_t);
 579 extern void remove_shrinker(struct shrinker *shrinker);
 580
 581 /*
 582  * On a two-level page table, this ends up being trivial. Thus the
 583  * inlining and the symmetry break with pte_alloc_map() that does all
 584  * of this out-of-line.
 585  */
 586 static inline pmd_t *pmd_alloc(struct mm_struct *mm, pgd_t *pgd, unsigned long address)
 587 {
 588         if (pgd_none(*pgd))
 589                 return __pmd_alloc(mm, pgd, address);
 590         return pmd_offset(pgd, address);
 591 }
 592
 593 extern void free_area_init(unsigned long * zones_size);
 594 extern void free_area_init_node(int nid, pg_data_t *pgdat, struct page *pmap,
 595         unsigned long * zones_size, unsigned long zone_start_pfn,
 596         unsigned long *zholes_size);
 597 extern void memmap_init_zone(struct page *, unsigned long, int,
 598         unsigned long, unsigned long);
 599 extern void mem_init(void);
 600 extern void show_mem(void);
 601 extern void si_meminfo(struct sysinfo * val);
 602 extern void si_meminfo_node(struct sysinfo *val, int nid);
 603
 604 static inline void vma_prio_tree_init(struct vm_area_struct *vma)
 605 {
 606         vma->shared.vm_set.list.next = NULL;
 607         vma->shared.vm_set.list.prev = NULL;
 608         vma->shared.vm_set.parent = NULL;
 609         vma->shared.vm_set.head = NULL;
 610 }
 611
 612 /* prio_tree.c */
 613 void vma_prio_tree_add(struct vm_area_struct *, struct vm_area_struct *old);
 614 void vma_prio_tree_insert(struct vm_area_struct *, struct prio_tree_root *);
 615 void vma_prio_tree_remove(struct vm_area_struct *, struct prio_tree_root *);
 616 struct vm_area_struct *vma_prio_tree_next(
 617         struct vm_area_struct *, struct prio_tree_root *,
 618         struct prio_tree_iter *, pgoff_t begin, pgoff_t end);
 619
 620 /* mmap.c */
 621 extern void vma_adjust(struct vm_area_struct *vma, unsigned long start,
 622         unsigned long end, pgoff_t pgoff, struct vm_area_struct *insert);
 623 extern struct vm_area_struct *vma_merge(struct mm_struct *,
 624         struct vm_area_struct *prev, unsigned long addr, unsigned long end,
 625         unsigned long vm_flags, struct anon_vma *, struct file *, pgoff_t,
 626         struct mempolicy *);
 627 extern struct anon_vma *find_mergeable_anon_vma(struct vm_area_struct *);
 628 extern int split_vma(struct mm_struct *,
 629         struct vm_area_struct *, unsigned long addr, int new_below);
 630 extern void insert_vm_struct(struct mm_struct *, struct vm_area_struct *);
 631 extern void __vma_link_rb(struct mm_struct *, struct vm_area_struct *,
 632         struct rb_node **, struct rb_node *);
 633 extern struct vm_area_struct *copy_vma(struct vm_area_struct **,
 634         unsigned long addr, unsigned long len, pgoff_t pgoff);
 635 extern void exit_mmap(struct mm_struct *);
 636
 637 extern unsigned long get_unmapped_area(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);
 638
 639 extern unsigned long do_mmap_pgoff(struct file *file, unsigned long addr,
 640         unsigned long len, unsigned long prot,
 641         unsigned long flag, unsigned long pgoff);
 642
 643 static inline unsigned long do_mmap(struct file *file, unsigned long addr,
 644         unsigned long len, unsigned long prot,
 645         unsigned long flag, unsigned long offset)
 646 {
 647         unsigned long ret = -EINVAL;
 648         if ((offset + PAGE_ALIGN(len)) < offset)
 649                 goto out;
 650         if (!(offset & ~PAGE_MASK))
 651                 ret = do_mmap_pgoff(file, addr, len, prot, flag, offset >> PAGE_SHIFT);
 652 out:
 653         return ret;
 654 }
 655
 656 extern int do_munmap(struct mm_struct *, unsigned long, size_t);
 657
 658 extern unsigned long do_brk(unsigned long, unsigned long);
 659
 660 /* filemap.c */
 661 extern unsigned long page_unuse(struct page *);
 662 extern void truncate_inode_pages(struct address_space *, loff_t);
 663
 664 /* generic vm_area_ops exported for stackable file systems */
 665 struct page *filemap_nopage(struct vm_area_struct *, unsigned long, int *);
 666
 667 /* mm/page-writeback.c */
 668 int write_one_page(struct page *page, int wait);
 669
 670 /* readahead.c */
 671 #define VM_MAX_READAHEAD        128     /* kbytes */
 672 #define VM_MIN_READAHEAD        16      /* kbytes (includes current page) */
 673
 674 int do_page_cache_readahead(struct address_space *mapping, struct file *filp,
 675                         unsigned long offset, unsigned long nr_to_read);
 676 int force_page_cache_readahead(struct address_space *mapping, struct file *filp,
 677                         unsigned long offset, unsigned long nr_to_read);
 678 void page_cache_readahead(struct address_space *mapping,
 679                           struct file_ra_state *ra,
 680                           struct file *filp,
 681                           unsigned long offset);
 682 void handle_ra_miss(struct address_space *mapping,
 683                     struct file_ra_state *ra, pgoff_t offset);
 684 unsigned long max_sane_readahead(unsigned long nr);
 685
 686 /* Do stack extension */
 687 extern int expand_stack(struct vm_area_struct * vma, unsigned long address);
 688
 689 /* Look up the first VMA which satisfies  addr < vm_end,  NULL if none. */
 690 extern struct vm_area_struct * find_vma(struct mm_struct * mm, unsigned long addr);
 691 extern struct vm_area_struct * find_vma_prev(struct mm_struct * mm, unsigned long addr,
 692                                              struct vm_area_struct **pprev);
 693
 694 /* Look up the first VMA which intersects the interval start_addr..end_addr-1,
 695    NULL if none.  Assume start_addr < end_addr. */
 696 static inline struct vm_area_struct * find_vma_intersection(struct mm_struct * mm, unsigned long start_addr, unsigned long end_addr)
 697 {
 698         struct vm_area_struct * vma = find_vma(mm,start_addr);
 699
 700         if (vma && end_addr <= vma->vm_start)
 701                 vma = NULL;
 702         return vma;
 703 }
 704
 705 static inline unsigned long vma_pages(struct vm_area_struct *vma)
 706 {
 707         return (vma->vm_end - vma->vm_start) >> PAGE_SHIFT;
 708 }
 709
 710 extern struct vm_area_struct *find_extend_vma(struct mm_struct *mm, unsigned long addr);
 711
 712 extern struct page * vmalloc_to_page(void *addr);
 713 extern struct page * follow_page(struct mm_struct *mm, unsigned long address,
 714                 int write);
 715 extern int remap_page_range(struct vm_area_struct *vma, unsigned long from,
 716                 unsigned long to, unsigned long size, pgprot_t prot);
 717
 718 #ifndef CONFIG_DEBUG_PAGEALLOC
 719 static inline void
 720 kernel_map_pages(struct page *page, int numpages, int enable)
 721 {
 722 }
 723 #endif
 724
 725 #ifndef CONFIG_ARCH_GATE_AREA
 726 extern struct vm_area_struct *get_gate_vma(struct task_struct *tsk);
 727 int in_gate_area(struct task_struct *task, unsigned long addr);
 728 #endif
 729
 730 #endif /* __KERNEL__ */
 731 #endif /* _LINUX_MM_H */