mmzone.h 36 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168
  1. #ifndef _LINUX_MMZONE_H
  2. #define _LINUX_MMZONE_H
  3. #ifndef __ASSEMBLY__
  4. #ifndef __GENERATING_BOUNDS_H
  5. #include <linux/spinlock.h>
  6. #include <linux/list.h>
  7. #include <linux/wait.h>
  8. #include <linux/bitops.h>
  9. #include <linux/cache.h>
  10. #include <linux/threads.h>
  11. #include <linux/numa.h>
  12. #include <linux/init.h>
  13. #include <linux/seqlock.h>
  14. #include <linux/nodemask.h>
  15. #include <linux/pageblock-flags.h>
  16. #include <generated/bounds.h>
  17. #include <linux/atomic.h>
  18. #include <asm/page.h>
  19. /* Free memory management - zoned buddy allocator. */
  20. #ifndef CONFIG_FORCE_MAX_ZONEORDER
  21. #define MAX_ORDER 11
  22. #else
  23. #define MAX_ORDER CONFIG_FORCE_MAX_ZONEORDER
  24. #endif
  25. #define MAX_ORDER_NR_PAGES (1 << (MAX_ORDER - 1))
  26. /*
  27. * PAGE_ALLOC_COSTLY_ORDER is the order at which allocations are deemed
  28. * costly to service. That is between allocation orders which should
  29. * coelesce naturally under reasonable reclaim pressure and those which
  30. * will not.
  31. */
  32. #define PAGE_ALLOC_COSTLY_ORDER 3
  33. #define MIGRATE_UNMOVABLE 0
  34. #define MIGRATE_RECLAIMABLE 1
  35. #define MIGRATE_MOVABLE 2
  36. #define MIGRATE_PCPTYPES 3 /* the number of types on the pcp lists */
  37. #define MIGRATE_RESERVE 3
  38. #define MIGRATE_ISOLATE 4 /* can't allocate from here */
  39. #define MIGRATE_TYPES 5
  40. #define for_each_migratetype_order(order, type) \
  41. for (order = 0; order < MAX_ORDER; order++) \
  42. for (type = 0; type < MIGRATE_TYPES; type++)
  43. extern int page_group_by_mobility_disabled;
  44. static inline int get_pageblock_migratetype(struct page *page)
  45. {
  46. return get_pageblock_flags_group(page, PB_migrate, PB_migrate_end);
  47. }
  48. struct free_area {
  49. struct list_head free_list[MIGRATE_TYPES];
  50. unsigned long nr_free;
  51. };
  52. struct pglist_data;
  53. /*
  54. * zone->lock and zone->lru_lock are two of the hottest locks in the kernel.
  55. * So add a wild amount of padding here to ensure that they fall into separate
  56. * cachelines. There are very few zone structures in the machine, so space
  57. * consumption is not a concern here.
  58. */
  59. #if defined(CONFIG_SMP)
  60. struct zone_padding {
  61. char x[0];
  62. } ____cacheline_internodealigned_in_smp;
  63. #define ZONE_PADDING(name) struct zone_padding name;
  64. #else
  65. #define ZONE_PADDING(name)
  66. #endif
  67. enum zone_stat_item {
  68. /* First 128 byte cacheline (assuming 64 bit words) */
  69. NR_FREE_PAGES,
  70. NR_LRU_BASE,
  71. NR_INACTIVE_ANON = NR_LRU_BASE, /* must match order of LRU_[IN]ACTIVE */
  72. NR_ACTIVE_ANON, /* " " " " " */
  73. NR_INACTIVE_FILE, /* " " " " " */
  74. NR_ACTIVE_FILE, /* " " " " " */
  75. NR_UNEVICTABLE, /* " " " " " */
  76. NR_MLOCK, /* mlock()ed pages found and moved off LRU */
  77. NR_ANON_PAGES, /* Mapped anonymous pages */
  78. NR_FILE_MAPPED, /* pagecache pages mapped into pagetables.
  79. only modified from process context */
  80. NR_FILE_PAGES,
  81. NR_FILE_DIRTY,
  82. NR_WRITEBACK,
  83. NR_SLAB_RECLAIMABLE,
  84. NR_SLAB_UNRECLAIMABLE,
  85. NR_PAGETABLE, /* used for pagetables */
  86. NR_KERNEL_STACK,
  87. /* Second 128 byte cacheline */
  88. NR_UNSTABLE_NFS, /* NFS unstable pages */
  89. NR_BOUNCE,
  90. NR_VMSCAN_WRITE,
  91. NR_WRITEBACK_TEMP, /* Writeback using temporary buffers */
  92. NR_ISOLATED_ANON, /* Temporary isolated pages from anon lru */
  93. NR_ISOLATED_FILE, /* Temporary isolated pages from file lru */
  94. NR_SHMEM, /* shmem pages (included tmpfs/GEM pages) */
  95. NR_DIRTIED, /* page dirtyings since bootup */
  96. NR_WRITTEN, /* page writings since bootup */
  97. #ifdef CONFIG_NUMA
  98. NUMA_HIT, /* allocated in intended node */
  99. NUMA_MISS, /* allocated in non intended node */
  100. NUMA_FOREIGN, /* was intended here, hit elsewhere */
  101. NUMA_INTERLEAVE_HIT, /* interleaver preferred this zone */
  102. NUMA_LOCAL, /* allocation from local node */
  103. NUMA_OTHER, /* allocation from other node */
  104. #endif
  105. NR_ANON_TRANSPARENT_HUGEPAGES,
  106. NR_VM_ZONE_STAT_ITEMS };
  107. /*
  108. * We do arithmetic on the LRU lists in various places in the code,
  109. * so it is important to keep the active lists LRU_ACTIVE higher in
  110. * the array than the corresponding inactive lists, and to keep
  111. * the *_FILE lists LRU_FILE higher than the corresponding _ANON lists.
  112. *
  113. * This has to be kept in sync with the statistics in zone_stat_item
  114. * above and the descriptions in vmstat_text in mm/vmstat.c
  115. */
  116. #define LRU_BASE 0
  117. #define LRU_ACTIVE 1
  118. #define LRU_FILE 2
  119. enum lru_list {
  120. LRU_INACTIVE_ANON = LRU_BASE,
  121. LRU_ACTIVE_ANON = LRU_BASE + LRU_ACTIVE,
  122. LRU_INACTIVE_FILE = LRU_BASE + LRU_FILE,
  123. LRU_ACTIVE_FILE = LRU_BASE + LRU_FILE + LRU_ACTIVE,
  124. LRU_UNEVICTABLE,
  125. NR_LRU_LISTS
  126. };
  127. #define for_each_lru(l) for (l = 0; l < NR_LRU_LISTS; l++)
  128. #define for_each_evictable_lru(l) for (l = 0; l <= LRU_ACTIVE_FILE; l++)
  129. static inline int is_file_lru(enum lru_list l)
  130. {
  131. return (l == LRU_INACTIVE_FILE || l == LRU_ACTIVE_FILE);
  132. }
  133. static inline int is_active_lru(enum lru_list l)
  134. {
  135. return (l == LRU_ACTIVE_ANON || l == LRU_ACTIVE_FILE);
  136. }
  137. static inline int is_unevictable_lru(enum lru_list l)
  138. {
  139. return (l == LRU_UNEVICTABLE);
  140. }
  141. /* Mask used at gathering information at once (see memcontrol.c) */
  142. #define LRU_ALL_FILE (BIT(LRU_INACTIVE_FILE) | BIT(LRU_ACTIVE_FILE))
  143. #define LRU_ALL_ANON (BIT(LRU_INACTIVE_ANON) | BIT(LRU_ACTIVE_ANON))
  144. #define LRU_ALL_EVICTABLE (LRU_ALL_FILE | LRU_ALL_ANON)
  145. #define LRU_ALL ((1 << NR_LRU_LISTS) - 1)
  146. /* Isolate inactive pages */
  147. #define ISOLATE_INACTIVE ((__force isolate_mode_t)0x1)
  148. /* Isolate active pages */
  149. #define ISOLATE_ACTIVE ((__force isolate_mode_t)0x2)
  150. /* Isolate clean file */
  151. #define ISOLATE_CLEAN ((__force isolate_mode_t)0x4)
  152. /* LRU Isolation modes. */
  153. typedef unsigned __bitwise__ isolate_mode_t;
  154. enum zone_watermarks {
  155. WMARK_MIN,
  156. WMARK_LOW,
  157. WMARK_HIGH,
  158. NR_WMARK
  159. };
  160. #define min_wmark_pages(z) (z->watermark[WMARK_MIN])
  161. #define low_wmark_pages(z) (z->watermark[WMARK_LOW])
  162. #define high_wmark_pages(z) (z->watermark[WMARK_HIGH])
  163. struct per_cpu_pages {
  164. int count; /* number of pages in the list */
  165. int high; /* high watermark, emptying needed */
  166. int batch; /* chunk size for buddy add/remove */
  167. /* Lists of pages, one per migrate type stored on the pcp-lists */
  168. struct list_head lists[MIGRATE_PCPTYPES];
  169. };
  170. struct per_cpu_pageset {
  171. struct per_cpu_pages pcp;
  172. #ifdef CONFIG_NUMA
  173. s8 expire;
  174. #endif
  175. #ifdef CONFIG_SMP
  176. s8 stat_threshold;
  177. s8 vm_stat_diff[NR_VM_ZONE_STAT_ITEMS];
  178. #endif
  179. };
  180. #endif /* !__GENERATING_BOUNDS.H */
  181. enum zone_type {
  182. #ifdef CONFIG_ZONE_DMA
  183. /*
  184. * ZONE_DMA is used when there are devices that are not able
  185. * to do DMA to all of addressable memory (ZONE_NORMAL). Then we
  186. * carve out the portion of memory that is needed for these devices.
  187. * The range is arch specific.
  188. *
  189. * Some examples
  190. *
  191. * Architecture Limit
  192. * ---------------------------
  193. * parisc, ia64, sparc <4G
  194. * s390 <2G
  195. * arm Various
  196. * alpha Unlimited or 0-16MB.
  197. *
  198. * i386, x86_64 and multiple other arches
  199. * <16M.
  200. */
  201. ZONE_DMA,
  202. #endif
  203. #ifdef CONFIG_ZONE_DMA32
  204. /*
  205. * x86_64 needs two ZONE_DMAs because it supports devices that are
  206. * only able to do DMA to the lower 16M but also 32 bit devices that
  207. * can only do DMA areas below 4G.
  208. */
  209. ZONE_DMA32,
  210. #endif
  211. /*
  212. * Normal addressable memory is in ZONE_NORMAL. DMA operations can be
  213. * performed on pages in ZONE_NORMAL if the DMA devices support
  214. * transfers to all addressable memory.
  215. */
  216. ZONE_NORMAL,
  217. #ifdef CONFIG_HIGHMEM
  218. /*
  219. * A memory area that is only addressable by the kernel through
  220. * mapping portions into its own address space. This is for example
  221. * used by i386 to allow the kernel to address the memory beyond
  222. * 900MB. The kernel will set up special mappings (page
  223. * table entries on i386) for each page that the kernel needs to
  224. * access.
  225. */
  226. ZONE_HIGHMEM,
  227. #endif
  228. ZONE_MOVABLE,
  229. __MAX_NR_ZONES
  230. };
  231. #ifndef __GENERATING_BOUNDS_H
  232. /*
  233. * When a memory allocation must conform to specific limitations (such
  234. * as being suitable for DMA) the caller will pass in hints to the
  235. * allocator in the gfp_mask, in the zone modifier bits. These bits
  236. * are used to select a priority ordered list of memory zones which
  237. * match the requested limits. See gfp_zone() in include/linux/gfp.h
  238. */
  239. #if MAX_NR_ZONES < 2
  240. #define ZONES_SHIFT 0
  241. #elif MAX_NR_ZONES <= 2
  242. #define ZONES_SHIFT 1
  243. #elif MAX_NR_ZONES <= 4
  244. #define ZONES_SHIFT 2
  245. #else
  246. #error ZONES_SHIFT -- too many zones configured adjust calculation
  247. #endif
  248. struct zone_reclaim_stat {
  249. /*
  250. * The pageout code in vmscan.c keeps track of how many of the
  251. * mem/swap backed and file backed pages are refeferenced.
  252. * The higher the rotated/scanned ratio, the more valuable
  253. * that cache is.
  254. *
  255. * The anon LRU stats live in [0], file LRU stats in [1]
  256. */
  257. unsigned long recent_rotated[2];
  258. unsigned long recent_scanned[2];
  259. };
  260. struct zone {
  261. /* Fields commonly accessed by the page allocator */
  262. /* zone watermarks, access with *_wmark_pages(zone) macros */
  263. unsigned long watermark[NR_WMARK];
  264. /*
  265. * When free pages are below this point, additional steps are taken
  266. * when reading the number of free pages to avoid per-cpu counter
  267. * drift allowing watermarks to be breached
  268. */
  269. unsigned long percpu_drift_mark;
  270. /*
  271. * We don't know if the memory that we're going to allocate will be freeable
  272. * or/and it will be released eventually, so to avoid totally wasting several
  273. * GB of ram we must reserve some of the lower zone memory (otherwise we risk
  274. * to run OOM on the lower zones despite there's tons of freeable ram
  275. * on the higher zones). This array is recalculated at runtime if the
  276. * sysctl_lowmem_reserve_ratio sysctl changes.
  277. */
  278. unsigned long lowmem_reserve[MAX_NR_ZONES];
  279. #ifdef CONFIG_NUMA
  280. int node;
  281. /*
  282. * zone reclaim becomes active if more unmapped pages exist.
  283. */
  284. unsigned long min_unmapped_pages;
  285. unsigned long min_slab_pages;
  286. #endif
  287. struct per_cpu_pageset __percpu *pageset;
  288. /*
  289. * free areas of different sizes
  290. */
  291. spinlock_t lock;
  292. int all_unreclaimable; /* All pages pinned */
  293. #ifdef CONFIG_MEMORY_HOTPLUG
  294. /* see spanned/present_pages for more description */
  295. seqlock_t span_seqlock;
  296. #endif
  297. struct free_area free_area[MAX_ORDER];
  298. #ifndef CONFIG_SPARSEMEM
  299. /*
  300. * Flags for a pageblock_nr_pages block. See pageblock-flags.h.
  301. * In SPARSEMEM, this map is stored in struct mem_section
  302. */
  303. unsigned long *pageblock_flags;
  304. #endif /* CONFIG_SPARSEMEM */
  305. #ifdef CONFIG_COMPACTION
  306. /*
  307. * On compaction failure, 1<<compact_defer_shift compactions
  308. * are skipped before trying again. The number attempted since
  309. * last failure is tracked with compact_considered.
  310. */
  311. unsigned int compact_considered;
  312. unsigned int compact_defer_shift;
  313. #endif
  314. ZONE_PADDING(_pad1_)
  315. /* Fields commonly accessed by the page reclaim scanner */
  316. spinlock_t lru_lock;
  317. struct zone_lru {
  318. struct list_head list;
  319. } lru[NR_LRU_LISTS];
  320. struct zone_reclaim_stat reclaim_stat;
  321. unsigned long pages_scanned; /* since last reclaim */
  322. unsigned long flags; /* zone flags, see below */
  323. /* Zone statistics */
  324. atomic_long_t vm_stat[NR_VM_ZONE_STAT_ITEMS];
  325. /*
  326. * The target ratio of ACTIVE_ANON to INACTIVE_ANON pages on
  327. * this zone's LRU. Maintained by the pageout code.
  328. */
  329. unsigned int inactive_ratio;
  330. ZONE_PADDING(_pad2_)
  331. /* Rarely used or read-mostly fields */
  332. /*
  333. * wait_table -- the array holding the hash table
  334. * wait_table_hash_nr_entries -- the size of the hash table array
  335. * wait_table_bits -- wait_table_size == (1 << wait_table_bits)
  336. *
  337. * The purpose of all these is to keep track of the people
  338. * waiting for a page to become available and make them
  339. * runnable again when possible. The trouble is that this
  340. * consumes a lot of space, especially when so few things
  341. * wait on pages at a given time. So instead of using
  342. * per-page waitqueues, we use a waitqueue hash table.
  343. *
  344. * The bucket discipline is to sleep on the same queue when
  345. * colliding and wake all in that wait queue when removing.
  346. * When something wakes, it must check to be sure its page is
  347. * truly available, a la thundering herd. The cost of a
  348. * collision is great, but given the expected load of the
  349. * table, they should be so rare as to be outweighed by the
  350. * benefits from the saved space.
  351. *
  352. * __wait_on_page_locked() and unlock_page() in mm/filemap.c, are the
  353. * primary users of these fields, and in mm/page_alloc.c
  354. * free_area_init_core() performs the initialization of them.
  355. */
  356. wait_queue_head_t * wait_table;
  357. unsigned long wait_table_hash_nr_entries;
  358. unsigned long wait_table_bits;
  359. /*
  360. * Discontig memory support fields.
  361. */
  362. struct pglist_data *zone_pgdat;
  363. /* zone_start_pfn == zone_start_paddr >> PAGE_SHIFT */
  364. unsigned long zone_start_pfn;
  365. /*
  366. * zone_start_pfn, spanned_pages and present_pages are all
  367. * protected by span_seqlock. It is a seqlock because it has
  368. * to be read outside of zone->lock, and it is done in the main
  369. * allocator path. But, it is written quite infrequently.
  370. *
  371. * The lock is declared along with zone->lock because it is
  372. * frequently read in proximity to zone->lock. It's good to
  373. * give them a chance of being in the same cacheline.
  374. */
  375. unsigned long spanned_pages; /* total size, including holes */
  376. unsigned long present_pages; /* amount of memory (excluding holes) */
  377. /*
  378. * rarely used fields:
  379. */
  380. const char *name;
  381. } ____cacheline_internodealigned_in_smp;
  382. typedef enum {
  383. ZONE_RECLAIM_LOCKED, /* prevents concurrent reclaim */
  384. ZONE_OOM_LOCKED, /* zone is in OOM killer zonelist */
  385. ZONE_CONGESTED, /* zone has many dirty pages backed by
  386. * a congested BDI
  387. */
  388. } zone_flags_t;
  389. static inline void zone_set_flag(struct zone *zone, zone_flags_t flag)
  390. {
  391. set_bit(flag, &zone->flags);
  392. }
  393. static inline int zone_test_and_set_flag(struct zone *zone, zone_flags_t flag)
  394. {
  395. return test_and_set_bit(flag, &zone->flags);
  396. }
  397. static inline void zone_clear_flag(struct zone *zone, zone_flags_t flag)
  398. {
  399. clear_bit(flag, &zone->flags);
  400. }
  401. static inline int zone_is_reclaim_congested(const struct zone *zone)
  402. {
  403. return test_bit(ZONE_CONGESTED, &zone->flags);
  404. }
  405. static inline int zone_is_reclaim_locked(const struct zone *zone)
  406. {
  407. return test_bit(ZONE_RECLAIM_LOCKED, &zone->flags);
  408. }
  409. static inline int zone_is_oom_locked(const struct zone *zone)
  410. {
  411. return test_bit(ZONE_OOM_LOCKED, &zone->flags);
  412. }
  413. /*
  414. * The "priority" of VM scanning is how much of the queues we will scan in one
  415. * go. A value of 12 for DEF_PRIORITY implies that we will scan 1/4096th of the
  416. * queues ("queue_length >> 12") during an aging round.
  417. */
  418. #define DEF_PRIORITY 12
  419. /* Maximum number of zones on a zonelist */
  420. #define MAX_ZONES_PER_ZONELIST (MAX_NUMNODES * MAX_NR_ZONES)
  421. #ifdef CONFIG_NUMA
  422. /*
  423. * The NUMA zonelists are doubled because we need zonelists that restrict the
  424. * allocations to a single node for GFP_THISNODE.
  425. *
  426. * [0] : Zonelist with fallback
  427. * [1] : No fallback (GFP_THISNODE)
  428. */
  429. #define MAX_ZONELISTS 2
  430. /*
  431. * We cache key information from each zonelist for smaller cache
  432. * footprint when scanning for free pages in get_page_from_freelist().
  433. *
  434. * 1) The BITMAP fullzones tracks which zones in a zonelist have come
  435. * up short of free memory since the last time (last_fullzone_zap)
  436. * we zero'd fullzones.
  437. * 2) The array z_to_n[] maps each zone in the zonelist to its node
  438. * id, so that we can efficiently evaluate whether that node is
  439. * set in the current tasks mems_allowed.
  440. *
  441. * Both fullzones and z_to_n[] are one-to-one with the zonelist,
  442. * indexed by a zones offset in the zonelist zones[] array.
  443. *
  444. * The get_page_from_freelist() routine does two scans. During the
  445. * first scan, we skip zones whose corresponding bit in 'fullzones'
  446. * is set or whose corresponding node in current->mems_allowed (which
  447. * comes from cpusets) is not set. During the second scan, we bypass
  448. * this zonelist_cache, to ensure we look methodically at each zone.
  449. *
  450. * Once per second, we zero out (zap) fullzones, forcing us to
  451. * reconsider nodes that might have regained more free memory.
  452. * The field last_full_zap is the time we last zapped fullzones.
  453. *
  454. * This mechanism reduces the amount of time we waste repeatedly
  455. * reexaming zones for free memory when they just came up low on
  456. * memory momentarilly ago.
  457. *
  458. * The zonelist_cache struct members logically belong in struct
  459. * zonelist. However, the mempolicy zonelists constructed for
  460. * MPOL_BIND are intentionally variable length (and usually much
  461. * shorter). A general purpose mechanism for handling structs with
  462. * multiple variable length members is more mechanism than we want
  463. * here. We resort to some special case hackery instead.
  464. *
  465. * The MPOL_BIND zonelists don't need this zonelist_cache (in good
  466. * part because they are shorter), so we put the fixed length stuff
  467. * at the front of the zonelist struct, ending in a variable length
  468. * zones[], as is needed by MPOL_BIND.
  469. *
  470. * Then we put the optional zonelist cache on the end of the zonelist
  471. * struct. This optional stuff is found by a 'zlcache_ptr' pointer in
  472. * the fixed length portion at the front of the struct. This pointer
  473. * both enables us to find the zonelist cache, and in the case of
  474. * MPOL_BIND zonelists, (which will just set the zlcache_ptr to NULL)
  475. * to know that the zonelist cache is not there.
  476. *
  477. * The end result is that struct zonelists come in two flavors:
  478. * 1) The full, fixed length version, shown below, and
  479. * 2) The custom zonelists for MPOL_BIND.
  480. * The custom MPOL_BIND zonelists have a NULL zlcache_ptr and no zlcache.
  481. *
  482. * Even though there may be multiple CPU cores on a node modifying
  483. * fullzones or last_full_zap in the same zonelist_cache at the same
  484. * time, we don't lock it. This is just hint data - if it is wrong now
  485. * and then, the allocator will still function, perhaps a bit slower.
  486. */
  487. struct zonelist_cache {
  488. unsigned short z_to_n[MAX_ZONES_PER_ZONELIST]; /* zone->nid */
  489. DECLARE_BITMAP(fullzones, MAX_ZONES_PER_ZONELIST); /* zone full? */
  490. unsigned long last_full_zap; /* when last zap'd (jiffies) */
  491. };
  492. #else
  493. #define MAX_ZONELISTS 1
  494. struct zonelist_cache;
  495. #endif
  496. /*
  497. * This struct contains information about a zone in a zonelist. It is stored
  498. * here to avoid dereferences into large structures and lookups of tables
  499. */
  500. struct zoneref {
  501. struct zone *zone; /* Pointer to actual zone */
  502. int zone_idx; /* zone_idx(zoneref->zone) */
  503. };
  504. /*
  505. * One allocation request operates on a zonelist. A zonelist
  506. * is a list of zones, the first one is the 'goal' of the
  507. * allocation, the other zones are fallback zones, in decreasing
  508. * priority.
  509. *
  510. * If zlcache_ptr is not NULL, then it is just the address of zlcache,
  511. * as explained above. If zlcache_ptr is NULL, there is no zlcache.
  512. * *
  513. * To speed the reading of the zonelist, the zonerefs contain the zone index
  514. * of the entry being read. Helper functions to access information given
  515. * a struct zoneref are
  516. *
  517. * zonelist_zone() - Return the struct zone * for an entry in _zonerefs
  518. * zonelist_zone_idx() - Return the index of the zone for an entry
  519. * zonelist_node_idx() - Return the index of the node for an entry
  520. */
  521. struct zonelist {
  522. struct zonelist_cache *zlcache_ptr; // NULL or &zlcache
  523. struct zoneref _zonerefs[MAX_ZONES_PER_ZONELIST + 1];
  524. #ifdef CONFIG_NUMA
  525. struct zonelist_cache zlcache; // optional ...
  526. #endif
  527. };
  528. #ifdef CONFIG_ARCH_POPULATES_NODE_MAP
  529. struct node_active_region {
  530. unsigned long start_pfn;
  531. unsigned long end_pfn;
  532. int nid;
  533. };
  534. #endif /* CONFIG_ARCH_POPULATES_NODE_MAP */
  535. #ifndef CONFIG_DISCONTIGMEM
  536. /* The array of struct pages - for discontigmem use pgdat->lmem_map */
  537. extern struct page *mem_map;
  538. #endif
  539. /*
  540. * The pg_data_t structure is used in machines with CONFIG_DISCONTIGMEM
  541. * (mostly NUMA machines?) to denote a higher-level memory zone than the
  542. * zone denotes.
  543. *
  544. * On NUMA machines, each NUMA node would have a pg_data_t to describe
  545. * it's memory layout.
  546. *
  547. * Memory statistics and page replacement data structures are maintained on a
  548. * per-zone basis.
  549. */
  550. struct bootmem_data;
  551. typedef struct pglist_data {
  552. struct zone node_zones[MAX_NR_ZONES];
  553. struct zonelist node_zonelists[MAX_ZONELISTS];
  554. int nr_zones;
  555. #ifdef CONFIG_FLAT_NODE_MEM_MAP /* means !SPARSEMEM */
  556. struct page *node_mem_map;
  557. #ifdef CONFIG_CGROUP_MEM_RES_CTLR
  558. struct page_cgroup *node_page_cgroup;
  559. #endif
  560. #endif
  561. #ifndef CONFIG_NO_BOOTMEM
  562. struct bootmem_data *bdata;
  563. #endif
  564. #ifdef CONFIG_MEMORY_HOTPLUG
  565. /*
  566. * Must be held any time you expect node_start_pfn, node_present_pages
  567. * or node_spanned_pages stay constant. Holding this will also
  568. * guarantee that any pfn_valid() stays that way.
  569. *
  570. * Nests above zone->lock and zone->size_seqlock.
  571. */
  572. spinlock_t node_size_lock;
  573. #endif
  574. unsigned long node_start_pfn;
  575. unsigned long node_present_pages; /* total number of physical pages */
  576. unsigned long node_spanned_pages; /* total size of physical page
  577. range, including holes */
  578. int node_id;
  579. wait_queue_head_t kswapd_wait;
  580. struct task_struct *kswapd;
  581. int kswapd_max_order;
  582. enum zone_type classzone_idx;
  583. } pg_data_t;
  584. #define node_present_pages(nid) (NODE_DATA(nid)->node_present_pages)
  585. #define node_spanned_pages(nid) (NODE_DATA(nid)->node_spanned_pages)
  586. #ifdef CONFIG_FLAT_NODE_MEM_MAP
  587. #define pgdat_page_nr(pgdat, pagenr) ((pgdat)->node_mem_map + (pagenr))
  588. #else
  589. #define pgdat_page_nr(pgdat, pagenr) pfn_to_page((pgdat)->node_start_pfn + (pagenr))
  590. #endif
  591. #define nid_page_nr(nid, pagenr) pgdat_page_nr(NODE_DATA(nid),(pagenr))
  592. #define node_start_pfn(nid) (NODE_DATA(nid)->node_start_pfn)
  593. #define node_end_pfn(nid) ({\
  594. pg_data_t *__pgdat = NODE_DATA(nid);\
  595. __pgdat->node_start_pfn + __pgdat->node_spanned_pages;\
  596. })
  597. #include <linux/memory_hotplug.h>
  598. extern struct mutex zonelists_mutex;
  599. void build_all_zonelists(void *data);
  600. void wakeup_kswapd(struct zone *zone, int order, enum zone_type classzone_idx);
  601. bool zone_watermark_ok(struct zone *z, int order, unsigned long mark,
  602. int classzone_idx, int alloc_flags);
  603. bool zone_watermark_ok_safe(struct zone *z, int order, unsigned long mark,
  604. int classzone_idx, int alloc_flags);
  605. enum memmap_context {
  606. MEMMAP_EARLY,
  607. MEMMAP_HOTPLUG,
  608. };
  609. extern int init_currently_empty_zone(struct zone *zone, unsigned long start_pfn,
  610. unsigned long size,
  611. enum memmap_context context);
  612. #ifdef CONFIG_HAVE_MEMORY_PRESENT
  613. void memory_present(int nid, unsigned long start, unsigned long end);
  614. #else
  615. static inline void memory_present(int nid, unsigned long start, unsigned long end) {}
  616. #endif
  617. #ifdef CONFIG_HAVE_MEMORYLESS_NODES
  618. int local_memory_node(int node_id);
  619. #else
  620. static inline int local_memory_node(int node_id) { return node_id; };
  621. #endif
  622. #ifdef CONFIG_NEED_NODE_MEMMAP_SIZE
  623. unsigned long __init node_memmap_size_bytes(int, unsigned long, unsigned long);
  624. #endif
  625. /*
  626. * zone_idx() returns 0 for the ZONE_DMA zone, 1 for the ZONE_NORMAL zone, etc.
  627. */
  628. #define zone_idx(zone) ((zone) - (zone)->zone_pgdat->node_zones)
  629. static inline int populated_zone(struct zone *zone)
  630. {
  631. return (!!zone->present_pages);
  632. }
  633. extern int movable_zone;
  634. static inline int zone_movable_is_highmem(void)
  635. {
  636. #if defined(CONFIG_HIGHMEM) && defined(CONFIG_ARCH_POPULATES_NODE_MAP)
  637. return movable_zone == ZONE_HIGHMEM;
  638. #else
  639. return 0;
  640. #endif
  641. }
  642. static inline int is_highmem_idx(enum zone_type idx)
  643. {
  644. #ifdef CONFIG_HIGHMEM
  645. return (idx == ZONE_HIGHMEM ||
  646. (idx == ZONE_MOVABLE && zone_movable_is_highmem()));
  647. #else
  648. return 0;
  649. #endif
  650. }
  651. static inline int is_normal_idx(enum zone_type idx)
  652. {
  653. return (idx == ZONE_NORMAL);
  654. }
  655. /**
  656. * is_highmem - helper function to quickly check if a struct zone is a
  657. * highmem zone or not. This is an attempt to keep references
  658. * to ZONE_{DMA/NORMAL/HIGHMEM/etc} in general code to a minimum.
  659. * @zone - pointer to struct zone variable
  660. */
  661. static inline int is_highmem(struct zone *zone)
  662. {
  663. #ifdef CONFIG_HIGHMEM
  664. int zone_off = (char *)zone - (char *)zone->zone_pgdat->node_zones;
  665. return zone_off == ZONE_HIGHMEM * sizeof(*zone) ||
  666. (zone_off == ZONE_MOVABLE * sizeof(*zone) &&
  667. zone_movable_is_highmem());
  668. #else
  669. return 0;
  670. #endif
  671. }
  672. static inline int is_normal(struct zone *zone)
  673. {
  674. return zone == zone->zone_pgdat->node_zones + ZONE_NORMAL;
  675. }
  676. static inline int is_dma32(struct zone *zone)
  677. {
  678. #ifdef CONFIG_ZONE_DMA32
  679. return zone == zone->zone_pgdat->node_zones + ZONE_DMA32;
  680. #else
  681. return 0;
  682. #endif
  683. }
  684. static inline int is_dma(struct zone *zone)
  685. {
  686. #ifdef CONFIG_ZONE_DMA
  687. return zone == zone->zone_pgdat->node_zones + ZONE_DMA;
  688. #else
  689. return 0;
  690. #endif
  691. }
  692. /* These two functions are used to setup the per zone pages min values */
  693. struct ctl_table;
  694. int min_free_kbytes_sysctl_handler(struct ctl_table *, int,
  695. void __user *, size_t *, loff_t *);
  696. extern int sysctl_lowmem_reserve_ratio[MAX_NR_ZONES-1];
  697. int lowmem_reserve_ratio_sysctl_handler(struct ctl_table *, int,
  698. void __user *, size_t *, loff_t *);
  699. int percpu_pagelist_fraction_sysctl_handler(struct ctl_table *, int,
  700. void __user *, size_t *, loff_t *);
  701. int sysctl_min_unmapped_ratio_sysctl_handler(struct ctl_table *, int,
  702. void __user *, size_t *, loff_t *);
  703. int sysctl_min_slab_ratio_sysctl_handler(struct ctl_table *, int,
  704. void __user *, size_t *, loff_t *);
  705. extern int numa_zonelist_order_handler(struct ctl_table *, int,
  706. void __user *, size_t *, loff_t *);
  707. extern char numa_zonelist_order[];
  708. #define NUMA_ZONELIST_ORDER_LEN 16 /* string buffer size */
  709. #ifndef CONFIG_NEED_MULTIPLE_NODES
  710. extern struct pglist_data contig_page_data;
  711. #define NODE_DATA(nid) (&contig_page_data)
  712. #define NODE_MEM_MAP(nid) mem_map
  713. #else /* CONFIG_NEED_MULTIPLE_NODES */
  714. #include <asm/mmzone.h>
  715. #endif /* !CONFIG_NEED_MULTIPLE_NODES */
  716. extern struct pglist_data *first_online_pgdat(void);
  717. extern struct pglist_data *next_online_pgdat(struct pglist_data *pgdat);
  718. extern struct zone *next_zone(struct zone *zone);
  719. /**
  720. * for_each_online_pgdat - helper macro to iterate over all online nodes
  721. * @pgdat - pointer to a pg_data_t variable
  722. */
  723. #define for_each_online_pgdat(pgdat) \
  724. for (pgdat = first_online_pgdat(); \
  725. pgdat; \
  726. pgdat = next_online_pgdat(pgdat))
  727. /**
  728. * for_each_zone - helper macro to iterate over all memory zones
  729. * @zone - pointer to struct zone variable
  730. *
  731. * The user only needs to declare the zone variable, for_each_zone
  732. * fills it in.
  733. */
  734. #define for_each_zone(zone) \
  735. for (zone = (first_online_pgdat())->node_zones; \
  736. zone; \
  737. zone = next_zone(zone))
  738. #define for_each_populated_zone(zone) \
  739. for (zone = (first_online_pgdat())->node_zones; \
  740. zone; \
  741. zone = next_zone(zone)) \
  742. if (!populated_zone(zone)) \
  743. ; /* do nothing */ \
  744. else
  745. static inline struct zone *zonelist_zone(struct zoneref *zoneref)
  746. {
  747. return zoneref->zone;
  748. }
  749. static inline int zonelist_zone_idx(struct zoneref *zoneref)
  750. {
  751. return zoneref->zone_idx;
  752. }
  753. static inline int zonelist_node_idx(struct zoneref *zoneref)
  754. {
  755. #ifdef CONFIG_NUMA
  756. /* zone_to_nid not available in this context */
  757. return zoneref->zone->node;
  758. #else
  759. return 0;
  760. #endif /* CONFIG_NUMA */
  761. }
  762. /**
  763. * next_zones_zonelist - Returns the next zone at or below highest_zoneidx within the allowed nodemask using a cursor within a zonelist as a starting point
  764. * @z - The cursor used as a starting point for the search
  765. * @highest_zoneidx - The zone index of the highest zone to return
  766. * @nodes - An optional nodemask to filter the zonelist with
  767. * @zone - The first suitable zone found is returned via this parameter
  768. *
  769. * This function returns the next zone at or below a given zone index that is
  770. * within the allowed nodemask using a cursor as the starting point for the
  771. * search. The zoneref returned is a cursor that represents the current zone
  772. * being examined. It should be advanced by one before calling
  773. * next_zones_zonelist again.
  774. */
  775. struct zoneref *next_zones_zonelist(struct zoneref *z,
  776. enum zone_type highest_zoneidx,
  777. nodemask_t *nodes,
  778. struct zone **zone);
  779. /**
  780. * first_zones_zonelist - Returns the first zone at or below highest_zoneidx within the allowed nodemask in a zonelist
  781. * @zonelist - The zonelist to search for a suitable zone
  782. * @highest_zoneidx - The zone index of the highest zone to return
  783. * @nodes - An optional nodemask to filter the zonelist with
  784. * @zone - The first suitable zone found is returned via this parameter
  785. *
  786. * This function returns the first zone at or below a given zone index that is
  787. * within the allowed nodemask. The zoneref returned is a cursor that can be
  788. * used to iterate the zonelist with next_zones_zonelist by advancing it by
  789. * one before calling.
  790. */
  791. static inline struct zoneref *first_zones_zonelist(struct zonelist *zonelist,
  792. enum zone_type highest_zoneidx,
  793. nodemask_t *nodes,
  794. struct zone **zone)
  795. {
  796. return next_zones_zonelist(zonelist->_zonerefs, highest_zoneidx, nodes,
  797. zone);
  798. }
  799. /**
  800. * for_each_zone_zonelist_nodemask - helper macro to iterate over valid zones in a zonelist at or below a given zone index and within a nodemask
  801. * @zone - The current zone in the iterator
  802. * @z - The current pointer within zonelist->zones being iterated
  803. * @zlist - The zonelist being iterated
  804. * @highidx - The zone index of the highest zone to return
  805. * @nodemask - Nodemask allowed by the allocator
  806. *
  807. * This iterator iterates though all zones at or below a given zone index and
  808. * within a given nodemask
  809. */
  810. #define for_each_zone_zonelist_nodemask(zone, z, zlist, highidx, nodemask) \
  811. for (z = first_zones_zonelist(zlist, highidx, nodemask, &zone); \
  812. zone; \
  813. z = next_zones_zonelist(++z, highidx, nodemask, &zone)) \
  814. /**
  815. * for_each_zone_zonelist - helper macro to iterate over valid zones in a zonelist at or below a given zone index
  816. * @zone - The current zone in the iterator
  817. * @z - The current pointer within zonelist->zones being iterated
  818. * @zlist - The zonelist being iterated
  819. * @highidx - The zone index of the highest zone to return
  820. *
  821. * This iterator iterates though all zones at or below a given zone index.
  822. */
  823. #define for_each_zone_zonelist(zone, z, zlist, highidx) \
  824. for_each_zone_zonelist_nodemask(zone, z, zlist, highidx, NULL)
  825. #ifdef CONFIG_SPARSEMEM
  826. #include <asm/sparsemem.h>
  827. #endif
  828. #if !defined(CONFIG_HAVE_ARCH_EARLY_PFN_TO_NID) && \
  829. !defined(CONFIG_ARCH_POPULATES_NODE_MAP)
  830. static inline unsigned long early_pfn_to_nid(unsigned long pfn)
  831. {
  832. return 0;
  833. }
  834. #endif
  835. #ifdef CONFIG_FLATMEM
  836. #define pfn_to_nid(pfn) (0)
  837. #endif
  838. #ifdef CONFIG_SPARSEMEM
  839. /*
  840. * SECTION_SHIFT #bits space required to store a section #
  841. *
  842. * PA_SECTION_SHIFT physical address to/from section number
  843. * PFN_SECTION_SHIFT pfn to/from section number
  844. */
  845. #define SECTIONS_SHIFT (MAX_PHYSMEM_BITS - SECTION_SIZE_BITS)
  846. #define PA_SECTION_SHIFT (SECTION_SIZE_BITS)
  847. #define PFN_SECTION_SHIFT (SECTION_SIZE_BITS - PAGE_SHIFT)
  848. #define NR_MEM_SECTIONS (1UL << SECTIONS_SHIFT)
  849. #define PAGES_PER_SECTION (1UL << PFN_SECTION_SHIFT)
  850. #define PAGE_SECTION_MASK (~(PAGES_PER_SECTION-1))
  851. #define SECTION_BLOCKFLAGS_BITS \
  852. ((1UL << (PFN_SECTION_SHIFT - pageblock_order)) * NR_PAGEBLOCK_BITS)
  853. #if (MAX_ORDER - 1 + PAGE_SHIFT) > SECTION_SIZE_BITS
  854. #error Allocator MAX_ORDER exceeds SECTION_SIZE
  855. #endif
  856. #define pfn_to_section_nr(pfn) ((pfn) >> PFN_SECTION_SHIFT)
  857. #define section_nr_to_pfn(sec) ((sec) << PFN_SECTION_SHIFT)
  858. #define SECTION_ALIGN_UP(pfn) (((pfn) + PAGES_PER_SECTION - 1) & PAGE_SECTION_MASK)
  859. #define SECTION_ALIGN_DOWN(pfn) ((pfn) & PAGE_SECTION_MASK)
  860. struct page;
  861. struct page_cgroup;
  862. struct mem_section {
  863. /*
  864. * This is, logically, a pointer to an array of struct
  865. * pages. However, it is stored with some other magic.
  866. * (see sparse.c::sparse_init_one_section())
  867. *
  868. * Additionally during early boot we encode node id of
  869. * the location of the section here to guide allocation.
  870. * (see sparse.c::memory_present())
  871. *
  872. * Making it a UL at least makes someone do a cast
  873. * before using it wrong.
  874. */
  875. unsigned long section_mem_map;
  876. /* See declaration of similar field in struct zone */
  877. unsigned long *pageblock_flags;
  878. #ifdef CONFIG_CGROUP_MEM_RES_CTLR
  879. /*
  880. * If !SPARSEMEM, pgdat doesn't have page_cgroup pointer. We use
  881. * section. (see memcontrol.h/page_cgroup.h about this.)
  882. */
  883. struct page_cgroup *page_cgroup;
  884. unsigned long pad;
  885. #endif
  886. };
  887. #ifdef CONFIG_SPARSEMEM_EXTREME
  888. #define SECTIONS_PER_ROOT (PAGE_SIZE / sizeof (struct mem_section))
  889. #else
  890. #define SECTIONS_PER_ROOT 1
  891. #endif
  892. #define SECTION_NR_TO_ROOT(sec) ((sec) / SECTIONS_PER_ROOT)
  893. #define NR_SECTION_ROOTS DIV_ROUND_UP(NR_MEM_SECTIONS, SECTIONS_PER_ROOT)
  894. #define SECTION_ROOT_MASK (SECTIONS_PER_ROOT - 1)
  895. #ifdef CONFIG_SPARSEMEM_EXTREME
  896. extern struct mem_section *mem_section[NR_SECTION_ROOTS];
  897. #else
  898. extern struct mem_section mem_section[NR_SECTION_ROOTS][SECTIONS_PER_ROOT];
  899. #endif
  900. static inline struct mem_section *__nr_to_section(unsigned long nr)
  901. {
  902. if (!mem_section[SECTION_NR_TO_ROOT(nr)])
  903. return NULL;
  904. return &mem_section[SECTION_NR_TO_ROOT(nr)][nr & SECTION_ROOT_MASK];
  905. }
  906. extern int __section_nr(struct mem_section* ms);
  907. extern unsigned long usemap_size(void);
  908. /*
  909. * We use the lower bits of the mem_map pointer to store
  910. * a little bit of information. There should be at least
  911. * 3 bits here due to 32-bit alignment.
  912. */
  913. #define SECTION_MARKED_PRESENT (1UL<<0)
  914. #define SECTION_HAS_MEM_MAP (1UL<<1)
  915. #define SECTION_MAP_LAST_BIT (1UL<<2)
  916. #define SECTION_MAP_MASK (~(SECTION_MAP_LAST_BIT-1))
  917. #define SECTION_NID_SHIFT 2
  918. static inline struct page *__section_mem_map_addr(struct mem_section *section)
  919. {
  920. unsigned long map = section->section_mem_map;
  921. map &= SECTION_MAP_MASK;
  922. return (struct page *)map;
  923. }
  924. static inline int present_section(struct mem_section *section)
  925. {
  926. return (section && (section->section_mem_map & SECTION_MARKED_PRESENT));
  927. }
  928. static inline int present_section_nr(unsigned long nr)
  929. {
  930. return present_section(__nr_to_section(nr));
  931. }
  932. static inline int valid_section(struct mem_section *section)
  933. {
  934. return (section && (section->section_mem_map & SECTION_HAS_MEM_MAP));
  935. }
  936. static inline int valid_section_nr(unsigned long nr)
  937. {
  938. return valid_section(__nr_to_section(nr));
  939. }
  940. static inline struct mem_section *__pfn_to_section(unsigned long pfn)
  941. {
  942. return __nr_to_section(pfn_to_section_nr(pfn));
  943. }
  944. #ifndef CONFIG_HAVE_ARCH_PFN_VALID
  945. static inline int pfn_valid(unsigned long pfn)
  946. {
  947. if (pfn_to_section_nr(pfn) >= NR_MEM_SECTIONS)
  948. return 0;
  949. return valid_section(__nr_to_section(pfn_to_section_nr(pfn)));
  950. }
  951. #endif
  952. static inline int pfn_present(unsigned long pfn)
  953. {
  954. if (pfn_to_section_nr(pfn) >= NR_MEM_SECTIONS)
  955. return 0;
  956. return present_section(__nr_to_section(pfn_to_section_nr(pfn)));
  957. }
  958. /*
  959. * These are _only_ used during initialisation, therefore they
  960. * can use __initdata ... They could have names to indicate
  961. * this restriction.
  962. */
  963. #ifdef CONFIG_NUMA
  964. #define pfn_to_nid(pfn) \
  965. ({ \
  966. unsigned long __pfn_to_nid_pfn = (pfn); \
  967. page_to_nid(pfn_to_page(__pfn_to_nid_pfn)); \
  968. })
  969. #else
  970. #define pfn_to_nid(pfn) (0)
  971. #endif
  972. #define early_pfn_valid(pfn) pfn_valid(pfn)
  973. void sparse_init(void);
  974. #else
  975. #define sparse_init() do {} while (0)
  976. #define sparse_index_init(_sec, _nid) do {} while (0)
  977. #endif /* CONFIG_SPARSEMEM */
  978. #ifdef CONFIG_NODES_SPAN_OTHER_NODES
  979. bool early_pfn_in_nid(unsigned long pfn, int nid);
  980. #else
  981. #define early_pfn_in_nid(pfn, nid) (1)
  982. #endif
  983. #ifndef early_pfn_valid
  984. #define early_pfn_valid(pfn) (1)
  985. #endif
  986. void memory_present(int nid, unsigned long start, unsigned long end);
  987. unsigned long __init node_memmap_size_bytes(int, unsigned long, unsigned long);
  988. /*
  989. * If it is possible to have holes within a MAX_ORDER_NR_PAGES, then we
  990. * need to check pfn validility within that MAX_ORDER_NR_PAGES block.
  991. * pfn_valid_within() should be used in this case; we optimise this away
  992. * when we have no holes within a MAX_ORDER_NR_PAGES block.
  993. */
  994. #ifdef CONFIG_HOLES_IN_ZONE
  995. #define pfn_valid_within(pfn) pfn_valid(pfn)
  996. #else
  997. #define pfn_valid_within(pfn) (1)
  998. #endif
  999. #ifdef CONFIG_ARCH_HAS_HOLES_MEMORYMODEL
  1000. /*
  1001. * pfn_valid() is meant to be able to tell if a given PFN has valid memmap
  1002. * associated with it or not. In FLATMEM, it is expected that holes always
  1003. * have valid memmap as long as there is valid PFNs either side of the hole.
  1004. * In SPARSEMEM, it is assumed that a valid section has a memmap for the
  1005. * entire section.
  1006. *
  1007. * However, an ARM, and maybe other embedded architectures in the future
  1008. * free memmap backing holes to save memory on the assumption the memmap is
  1009. * never used. The page_zone linkages are then broken even though pfn_valid()
  1010. * returns true. A walker of the full memmap must then do this additional
  1011. * check to ensure the memmap they are looking at is sane by making sure
  1012. * the zone and PFN linkages are still valid. This is expensive, but walkers
  1013. * of the full memmap are extremely rare.
  1014. */
  1015. int memmap_valid_within(unsigned long pfn,
  1016. struct page *page, struct zone *zone);
  1017. #else
  1018. static inline int memmap_valid_within(unsigned long pfn,
  1019. struct page *page, struct zone *zone)
  1020. {
  1021. return 1;
  1022. }
  1023. #endif /* CONFIG_ARCH_HAS_HOLES_MEMORYMODEL */
  1024. #endif /* !__GENERATING_BOUNDS.H */
  1025. #endif /* !__ASSEMBLY__ */
  1026. #endif /* _LINUX_MMZONE_H */