page-flags.h 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762
  1. /*
  2. * Macros for manipulating and testing page->flags
  3. */
  4. #ifndef PAGE_FLAGS_H
  5. #define PAGE_FLAGS_H
  6. #include <linux/types.h>
  7. #include <linux/bug.h>
  8. #include <linux/mmdebug.h>
  9. #ifndef __GENERATING_BOUNDS_H
  10. #include <linux/mm_types.h>
  11. #include <generated/bounds.h>
  12. #endif /* !__GENERATING_BOUNDS_H */
  13. /*
  14. * Various page->flags bits:
  15. *
  16. * PG_reserved is set for special pages, which can never be swapped out. Some
  17. * of them might not even exist (eg empty_bad_page)...
  18. *
  19. * The PG_private bitflag is set on pagecache pages if they contain filesystem
  20. * specific data (which is normally at page->private). It can be used by
  21. * private allocations for its own usage.
  22. *
  23. * During initiation of disk I/O, PG_locked is set. This bit is set before I/O
  24. * and cleared when writeback _starts_ or when read _completes_. PG_writeback
  25. * is set before writeback starts and cleared when it finishes.
  26. *
  27. * PG_locked also pins a page in pagecache, and blocks truncation of the file
  28. * while it is held.
  29. *
  30. * page_waitqueue(page) is a wait queue of all tasks waiting for the page
  31. * to become unlocked.
  32. *
  33. * PG_uptodate tells whether the page's contents is valid. When a read
  34. * completes, the page becomes uptodate, unless a disk I/O error happened.
  35. *
  36. * PG_referenced, PG_reclaim are used for page reclaim for anonymous and
  37. * file-backed pagecache (see mm/vmscan.c).
  38. *
  39. * PG_error is set to indicate that an I/O error occurred on this page.
  40. *
  41. * PG_arch_1 is an architecture specific page state bit. The generic code
  42. * guarantees that this bit is cleared for a page when it first is entered into
  43. * the page cache.
  44. *
  45. * PG_highmem pages are not permanently mapped into the kernel virtual address
  46. * space, they need to be kmapped separately for doing IO on the pages. The
  47. * struct page (these bits with information) are always mapped into kernel
  48. * address space...
  49. *
  50. * PG_hwpoison indicates that a page got corrupted in hardware and contains
  51. * data with incorrect ECC bits that triggered a machine check. Accessing is
  52. * not safe since it may cause another machine check. Don't touch!
  53. */
  54. /*
  55. * Don't use the *_dontuse flags. Use the macros. Otherwise you'll break
  56. * locked- and dirty-page accounting.
  57. *
  58. * The page flags field is split into two parts, the main flags area
  59. * which extends from the low bits upwards, and the fields area which
  60. * extends from the high bits downwards.
  61. *
  62. * | FIELD | ... | FLAGS |
  63. * N-1 ^ 0
  64. * (NR_PAGEFLAGS)
  65. *
  66. * The fields area is reserved for fields mapping zone, node (for NUMA) and
  67. * SPARSEMEM section (for variants of SPARSEMEM that require section ids like
  68. * SPARSEMEM_EXTREME with !SPARSEMEM_VMEMMAP).
  69. */
  70. enum pageflags {
  71. PG_locked, /* Page is locked. Don't touch. */
  72. PG_error,
  73. PG_referenced,
  74. PG_uptodate,
  75. PG_dirty,
  76. PG_lru,
  77. PG_active,
  78. PG_waiters, /* Page has waiters, check its waitqueue. Must be bit #7 and in the same byte as "PG_locked" */
  79. PG_slab,
  80. PG_owner_priv_1, /* Owner use. If pagecache, fs may use*/
  81. PG_arch_1,
  82. PG_reserved,
  83. PG_private, /* If pagecache, has fs-private data */
  84. PG_private_2, /* If pagecache, has fs aux data */
  85. PG_writeback, /* Page is under writeback */
  86. PG_head, /* A head page */
  87. PG_mappedtodisk, /* Has blocks allocated on-disk */
  88. PG_reclaim, /* To be reclaimed asap */
  89. PG_swapbacked, /* Page is backed by RAM/swap */
  90. PG_unevictable, /* Page is "unevictable" */
  91. #ifdef CONFIG_MMU
  92. PG_mlocked, /* Page is vma mlocked */
  93. #endif
  94. #ifdef CONFIG_ARCH_USES_PG_UNCACHED
  95. PG_uncached, /* Page has been mapped as uncached */
  96. #endif
  97. #ifdef CONFIG_MEMORY_FAILURE
  98. PG_hwpoison, /* hardware poisoned page. Don't touch */
  99. #endif
  100. #if defined(CONFIG_IDLE_PAGE_TRACKING) && defined(CONFIG_64BIT)
  101. PG_young,
  102. PG_idle,
  103. #endif
  104. __NR_PAGEFLAGS,
  105. /* Filesystems */
  106. PG_checked = PG_owner_priv_1,
  107. /* SwapBacked */
  108. PG_swapcache = PG_owner_priv_1, /* Swap page: swp_entry_t in private */
  109. /* Two page bits are conscripted by FS-Cache to maintain local caching
  110. * state. These bits are set on pages belonging to the netfs's inodes
  111. * when those inodes are being locally cached.
  112. */
  113. PG_fscache = PG_private_2, /* page backed by cache */
  114. /* XEN */
  115. /* Pinned in Xen as a read-only pagetable page. */
  116. PG_pinned = PG_owner_priv_1,
  117. /* Pinned as part of domain save (see xen_mm_pin_all()). */
  118. PG_savepinned = PG_dirty,
  119. /* Has a grant mapping of another (foreign) domain's page. */
  120. PG_foreign = PG_owner_priv_1,
  121. /* SLOB */
  122. PG_slob_free = PG_private,
  123. /* Compound pages. Stored in first tail page's flags */
  124. PG_double_map = PG_private_2,
  125. /* non-lru isolated movable page */
  126. PG_isolated = PG_reclaim,
  127. };
  128. #ifndef __GENERATING_BOUNDS_H
  129. struct page; /* forward declaration */
  130. static inline struct page *compound_head(struct page *page)
  131. {
  132. unsigned long head = READ_ONCE(page->compound_head);
  133. if (unlikely(head & 1))
  134. return (struct page *) (head - 1);
  135. return page;
  136. }
  137. static __always_inline int PageTail(struct page *page)
  138. {
  139. return READ_ONCE(page->compound_head) & 1;
  140. }
  141. static __always_inline int PageCompound(struct page *page)
  142. {
  143. return test_bit(PG_head, &page->flags) || PageTail(page);
  144. }
  145. /*
  146. * Page flags policies wrt compound pages
  147. *
  148. * PF_ANY:
  149. * the page flag is relevant for small, head and tail pages.
  150. *
  151. * PF_HEAD:
  152. * for compound page all operations related to the page flag applied to
  153. * head page.
  154. *
  155. * PF_ONLY_HEAD:
  156. * for compound page, callers only ever operate on the head page.
  157. *
  158. * PF_NO_TAIL:
  159. * modifications of the page flag must be done on small or head pages,
  160. * checks can be done on tail pages too.
  161. *
  162. * PF_NO_COMPOUND:
  163. * the page flag is not relevant for compound pages.
  164. */
  165. #define PF_ANY(page, enforce) page
  166. #define PF_HEAD(page, enforce) compound_head(page)
  167. #define PF_ONLY_HEAD(page, enforce) ({ \
  168. VM_BUG_ON_PGFLAGS(PageTail(page), page); \
  169. page;})
  170. #define PF_NO_TAIL(page, enforce) ({ \
  171. VM_BUG_ON_PGFLAGS(enforce && PageTail(page), page); \
  172. compound_head(page);})
  173. #define PF_NO_COMPOUND(page, enforce) ({ \
  174. VM_BUG_ON_PGFLAGS(enforce && PageCompound(page), page); \
  175. page;})
  176. /*
  177. * Macros to create function definitions for page flags
  178. */
  179. #define TESTPAGEFLAG(uname, lname, policy) \
  180. static __always_inline int Page##uname(struct page *page) \
  181. { return test_bit(PG_##lname, &policy(page, 0)->flags); }
  182. #define SETPAGEFLAG(uname, lname, policy) \
  183. static __always_inline void SetPage##uname(struct page *page) \
  184. { set_bit(PG_##lname, &policy(page, 1)->flags); }
  185. #define CLEARPAGEFLAG(uname, lname, policy) \
  186. static __always_inline void ClearPage##uname(struct page *page) \
  187. { clear_bit(PG_##lname, &policy(page, 1)->flags); }
  188. #define __SETPAGEFLAG(uname, lname, policy) \
  189. static __always_inline void __SetPage##uname(struct page *page) \
  190. { __set_bit(PG_##lname, &policy(page, 1)->flags); }
  191. #define __CLEARPAGEFLAG(uname, lname, policy) \
  192. static __always_inline void __ClearPage##uname(struct page *page) \
  193. { __clear_bit(PG_##lname, &policy(page, 1)->flags); }
  194. #define TESTSETFLAG(uname, lname, policy) \
  195. static __always_inline int TestSetPage##uname(struct page *page) \
  196. { return test_and_set_bit(PG_##lname, &policy(page, 1)->flags); }
  197. #define TESTCLEARFLAG(uname, lname, policy) \
  198. static __always_inline int TestClearPage##uname(struct page *page) \
  199. { return test_and_clear_bit(PG_##lname, &policy(page, 1)->flags); }
  200. #define PAGEFLAG(uname, lname, policy) \
  201. TESTPAGEFLAG(uname, lname, policy) \
  202. SETPAGEFLAG(uname, lname, policy) \
  203. CLEARPAGEFLAG(uname, lname, policy)
  204. #define __PAGEFLAG(uname, lname, policy) \
  205. TESTPAGEFLAG(uname, lname, policy) \
  206. __SETPAGEFLAG(uname, lname, policy) \
  207. __CLEARPAGEFLAG(uname, lname, policy)
  208. #define TESTSCFLAG(uname, lname, policy) \
  209. TESTSETFLAG(uname, lname, policy) \
  210. TESTCLEARFLAG(uname, lname, policy)
  211. #define TESTPAGEFLAG_FALSE(uname) \
  212. static inline int Page##uname(const struct page *page) { return 0; }
  213. #define SETPAGEFLAG_NOOP(uname) \
  214. static inline void SetPage##uname(struct page *page) { }
  215. #define CLEARPAGEFLAG_NOOP(uname) \
  216. static inline void ClearPage##uname(struct page *page) { }
  217. #define __CLEARPAGEFLAG_NOOP(uname) \
  218. static inline void __ClearPage##uname(struct page *page) { }
  219. #define TESTSETFLAG_FALSE(uname) \
  220. static inline int TestSetPage##uname(struct page *page) { return 0; }
  221. #define TESTCLEARFLAG_FALSE(uname) \
  222. static inline int TestClearPage##uname(struct page *page) { return 0; }
  223. #define PAGEFLAG_FALSE(uname) TESTPAGEFLAG_FALSE(uname) \
  224. SETPAGEFLAG_NOOP(uname) CLEARPAGEFLAG_NOOP(uname)
  225. #define TESTSCFLAG_FALSE(uname) \
  226. TESTSETFLAG_FALSE(uname) TESTCLEARFLAG_FALSE(uname)
  227. __PAGEFLAG(Locked, locked, PF_NO_TAIL)
  228. PAGEFLAG(Waiters, waiters, PF_ONLY_HEAD) __CLEARPAGEFLAG(Waiters, waiters, PF_ONLY_HEAD)
  229. PAGEFLAG(Error, error, PF_NO_COMPOUND) TESTCLEARFLAG(Error, error, PF_NO_COMPOUND)
  230. PAGEFLAG(Referenced, referenced, PF_HEAD)
  231. TESTCLEARFLAG(Referenced, referenced, PF_HEAD)
  232. __SETPAGEFLAG(Referenced, referenced, PF_HEAD)
  233. PAGEFLAG(Dirty, dirty, PF_HEAD) TESTSCFLAG(Dirty, dirty, PF_HEAD)
  234. __CLEARPAGEFLAG(Dirty, dirty, PF_HEAD)
  235. PAGEFLAG(LRU, lru, PF_HEAD) __CLEARPAGEFLAG(LRU, lru, PF_HEAD)
  236. PAGEFLAG(Active, active, PF_HEAD) __CLEARPAGEFLAG(Active, active, PF_HEAD)
  237. TESTCLEARFLAG(Active, active, PF_HEAD)
  238. __PAGEFLAG(Slab, slab, PF_NO_TAIL)
  239. __PAGEFLAG(SlobFree, slob_free, PF_NO_TAIL)
  240. PAGEFLAG(Checked, checked, PF_NO_COMPOUND) /* Used by some filesystems */
  241. /* Xen */
  242. PAGEFLAG(Pinned, pinned, PF_NO_COMPOUND)
  243. TESTSCFLAG(Pinned, pinned, PF_NO_COMPOUND)
  244. PAGEFLAG(SavePinned, savepinned, PF_NO_COMPOUND);
  245. PAGEFLAG(Foreign, foreign, PF_NO_COMPOUND);
  246. PAGEFLAG(Reserved, reserved, PF_NO_COMPOUND)
  247. __CLEARPAGEFLAG(Reserved, reserved, PF_NO_COMPOUND)
  248. PAGEFLAG(SwapBacked, swapbacked, PF_NO_TAIL)
  249. __CLEARPAGEFLAG(SwapBacked, swapbacked, PF_NO_TAIL)
  250. __SETPAGEFLAG(SwapBacked, swapbacked, PF_NO_TAIL)
  251. /*
  252. * Private page markings that may be used by the filesystem that owns the page
  253. * for its own purposes.
  254. * - PG_private and PG_private_2 cause releasepage() and co to be invoked
  255. */
  256. PAGEFLAG(Private, private, PF_ANY) __SETPAGEFLAG(Private, private, PF_ANY)
  257. __CLEARPAGEFLAG(Private, private, PF_ANY)
  258. PAGEFLAG(Private2, private_2, PF_ANY) TESTSCFLAG(Private2, private_2, PF_ANY)
  259. PAGEFLAG(OwnerPriv1, owner_priv_1, PF_ANY)
  260. TESTCLEARFLAG(OwnerPriv1, owner_priv_1, PF_ANY)
  261. /*
  262. * Only test-and-set exist for PG_writeback. The unconditional operators are
  263. * risky: they bypass page accounting.
  264. */
  265. TESTPAGEFLAG(Writeback, writeback, PF_NO_COMPOUND)
  266. TESTSCFLAG(Writeback, writeback, PF_NO_COMPOUND)
  267. PAGEFLAG(MappedToDisk, mappedtodisk, PF_NO_TAIL)
  268. /* PG_readahead is only used for reads; PG_reclaim is only for writes */
  269. PAGEFLAG(Reclaim, reclaim, PF_NO_TAIL)
  270. TESTCLEARFLAG(Reclaim, reclaim, PF_NO_TAIL)
  271. PAGEFLAG(Readahead, reclaim, PF_NO_COMPOUND)
  272. TESTCLEARFLAG(Readahead, reclaim, PF_NO_COMPOUND)
  273. #ifdef CONFIG_HIGHMEM
  274. /*
  275. * Must use a macro here due to header dependency issues. page_zone() is not
  276. * available at this point.
  277. */
  278. #define PageHighMem(__p) is_highmem_idx(page_zonenum(__p))
  279. #else
  280. PAGEFLAG_FALSE(HighMem)
  281. #endif
  282. #ifdef CONFIG_SWAP
  283. static __always_inline int PageSwapCache(struct page *page)
  284. {
  285. #ifdef CONFIG_THP_SWAP
  286. page = compound_head(page);
  287. #endif
  288. return PageSwapBacked(page) && test_bit(PG_swapcache, &page->flags);
  289. }
  290. SETPAGEFLAG(SwapCache, swapcache, PF_NO_TAIL)
  291. CLEARPAGEFLAG(SwapCache, swapcache, PF_NO_TAIL)
  292. #else
  293. PAGEFLAG_FALSE(SwapCache)
  294. #endif
  295. PAGEFLAG(Unevictable, unevictable, PF_HEAD)
  296. __CLEARPAGEFLAG(Unevictable, unevictable, PF_HEAD)
  297. TESTCLEARFLAG(Unevictable, unevictable, PF_HEAD)
  298. #ifdef CONFIG_MMU
  299. PAGEFLAG(Mlocked, mlocked, PF_NO_TAIL)
  300. __CLEARPAGEFLAG(Mlocked, mlocked, PF_NO_TAIL)
  301. TESTSCFLAG(Mlocked, mlocked, PF_NO_TAIL)
  302. #else
  303. PAGEFLAG_FALSE(Mlocked) __CLEARPAGEFLAG_NOOP(Mlocked)
  304. TESTSCFLAG_FALSE(Mlocked)
  305. #endif
  306. #ifdef CONFIG_ARCH_USES_PG_UNCACHED
  307. PAGEFLAG(Uncached, uncached, PF_NO_COMPOUND)
  308. #else
  309. PAGEFLAG_FALSE(Uncached)
  310. #endif
  311. #ifdef CONFIG_MEMORY_FAILURE
  312. PAGEFLAG(HWPoison, hwpoison, PF_ANY)
  313. TESTSCFLAG(HWPoison, hwpoison, PF_ANY)
  314. #define __PG_HWPOISON (1UL << PG_hwpoison)
  315. #else
  316. PAGEFLAG_FALSE(HWPoison)
  317. #define __PG_HWPOISON 0
  318. #endif
  319. #if defined(CONFIG_IDLE_PAGE_TRACKING) && defined(CONFIG_64BIT)
  320. TESTPAGEFLAG(Young, young, PF_ANY)
  321. SETPAGEFLAG(Young, young, PF_ANY)
  322. TESTCLEARFLAG(Young, young, PF_ANY)
  323. PAGEFLAG(Idle, idle, PF_ANY)
  324. #endif
  325. /*
  326. * On an anonymous page mapped into a user virtual memory area,
  327. * page->mapping points to its anon_vma, not to a struct address_space;
  328. * with the PAGE_MAPPING_ANON bit set to distinguish it. See rmap.h.
  329. *
  330. * On an anonymous page in a VM_MERGEABLE area, if CONFIG_KSM is enabled,
  331. * the PAGE_MAPPING_MOVABLE bit may be set along with the PAGE_MAPPING_ANON
  332. * bit; and then page->mapping points, not to an anon_vma, but to a private
  333. * structure which KSM associates with that merged page. See ksm.h.
  334. *
  335. * PAGE_MAPPING_KSM without PAGE_MAPPING_ANON is used for non-lru movable
  336. * page and then page->mapping points a struct address_space.
  337. *
  338. * Please note that, confusingly, "page_mapping" refers to the inode
  339. * address_space which maps the page from disk; whereas "page_mapped"
  340. * refers to user virtual address space into which the page is mapped.
  341. */
  342. #define PAGE_MAPPING_ANON 0x1
  343. #define PAGE_MAPPING_MOVABLE 0x2
  344. #define PAGE_MAPPING_KSM (PAGE_MAPPING_ANON | PAGE_MAPPING_MOVABLE)
  345. #define PAGE_MAPPING_FLAGS (PAGE_MAPPING_ANON | PAGE_MAPPING_MOVABLE)
  346. static __always_inline int PageMappingFlags(struct page *page)
  347. {
  348. return ((unsigned long)page->mapping & PAGE_MAPPING_FLAGS) != 0;
  349. }
  350. static __always_inline int PageAnon(struct page *page)
  351. {
  352. page = compound_head(page);
  353. return ((unsigned long)page->mapping & PAGE_MAPPING_ANON) != 0;
  354. }
  355. static __always_inline int __PageMovable(struct page *page)
  356. {
  357. return ((unsigned long)page->mapping & PAGE_MAPPING_FLAGS) ==
  358. PAGE_MAPPING_MOVABLE;
  359. }
  360. #ifdef CONFIG_KSM
  361. /*
  362. * A KSM page is one of those write-protected "shared pages" or "merged pages"
  363. * which KSM maps into multiple mms, wherever identical anonymous page content
  364. * is found in VM_MERGEABLE vmas. It's a PageAnon page, pointing not to any
  365. * anon_vma, but to that page's node of the stable tree.
  366. */
  367. static __always_inline int PageKsm(struct page *page)
  368. {
  369. page = compound_head(page);
  370. return ((unsigned long)page->mapping & PAGE_MAPPING_FLAGS) ==
  371. PAGE_MAPPING_KSM;
  372. }
  373. #else
  374. TESTPAGEFLAG_FALSE(Ksm)
  375. #endif
  376. u64 stable_page_flags(struct page *page);
  377. static inline int PageUptodate(struct page *page)
  378. {
  379. int ret;
  380. page = compound_head(page);
  381. ret = test_bit(PG_uptodate, &(page)->flags);
  382. /*
  383. * Must ensure that the data we read out of the page is loaded
  384. * _after_ we've loaded page->flags to check for PageUptodate.
  385. * We can skip the barrier if the page is not uptodate, because
  386. * we wouldn't be reading anything from it.
  387. *
  388. * See SetPageUptodate() for the other side of the story.
  389. */
  390. if (ret)
  391. smp_rmb();
  392. return ret;
  393. }
  394. static __always_inline void __SetPageUptodate(struct page *page)
  395. {
  396. VM_BUG_ON_PAGE(PageTail(page), page);
  397. smp_wmb();
  398. __set_bit(PG_uptodate, &page->flags);
  399. }
  400. static __always_inline void SetPageUptodate(struct page *page)
  401. {
  402. VM_BUG_ON_PAGE(PageTail(page), page);
  403. /*
  404. * Memory barrier must be issued before setting the PG_uptodate bit,
  405. * so that all previous stores issued in order to bring the page
  406. * uptodate are actually visible before PageUptodate becomes true.
  407. */
  408. smp_wmb();
  409. set_bit(PG_uptodate, &page->flags);
  410. }
  411. CLEARPAGEFLAG(Uptodate, uptodate, PF_NO_TAIL)
  412. int test_clear_page_writeback(struct page *page);
  413. int __test_set_page_writeback(struct page *page, bool keep_write);
  414. #define test_set_page_writeback(page) \
  415. __test_set_page_writeback(page, false)
  416. #define test_set_page_writeback_keepwrite(page) \
  417. __test_set_page_writeback(page, true)
  418. static inline void set_page_writeback(struct page *page)
  419. {
  420. test_set_page_writeback(page);
  421. }
  422. static inline void set_page_writeback_keepwrite(struct page *page)
  423. {
  424. test_set_page_writeback_keepwrite(page);
  425. }
  426. __PAGEFLAG(Head, head, PF_ANY) CLEARPAGEFLAG(Head, head, PF_ANY)
  427. static __always_inline void set_compound_head(struct page *page, struct page *head)
  428. {
  429. WRITE_ONCE(page->compound_head, (unsigned long)head + 1);
  430. }
  431. static __always_inline void clear_compound_head(struct page *page)
  432. {
  433. WRITE_ONCE(page->compound_head, 0);
  434. }
  435. #ifdef CONFIG_TRANSPARENT_HUGEPAGE
  436. static inline void ClearPageCompound(struct page *page)
  437. {
  438. BUG_ON(!PageHead(page));
  439. ClearPageHead(page);
  440. }
  441. #endif
  442. #define PG_head_mask ((1UL << PG_head))
  443. #ifdef CONFIG_HUGETLB_PAGE
  444. int PageHuge(struct page *page);
  445. int PageHeadHuge(struct page *page);
  446. bool page_huge_active(struct page *page);
  447. #else
  448. TESTPAGEFLAG_FALSE(Huge)
  449. TESTPAGEFLAG_FALSE(HeadHuge)
  450. static inline bool page_huge_active(struct page *page)
  451. {
  452. return 0;
  453. }
  454. #endif
  455. #ifdef CONFIG_TRANSPARENT_HUGEPAGE
  456. /*
  457. * PageHuge() only returns true for hugetlbfs pages, but not for
  458. * normal or transparent huge pages.
  459. *
  460. * PageTransHuge() returns true for both transparent huge and
  461. * hugetlbfs pages, but not normal pages. PageTransHuge() can only be
  462. * called only in the core VM paths where hugetlbfs pages can't exist.
  463. */
  464. static inline int PageTransHuge(struct page *page)
  465. {
  466. VM_BUG_ON_PAGE(PageTail(page), page);
  467. return PageHead(page);
  468. }
  469. /*
  470. * PageTransCompound returns true for both transparent huge pages
  471. * and hugetlbfs pages, so it should only be called when it's known
  472. * that hugetlbfs pages aren't involved.
  473. */
  474. static inline int PageTransCompound(struct page *page)
  475. {
  476. return PageCompound(page);
  477. }
  478. /*
  479. * PageTransCompoundMap is the same as PageTransCompound, but it also
  480. * guarantees the primary MMU has the entire compound page mapped
  481. * through pmd_trans_huge, which in turn guarantees the secondary MMUs
  482. * can also map the entire compound page. This allows the secondary
  483. * MMUs to call get_user_pages() only once for each compound page and
  484. * to immediately map the entire compound page with a single secondary
  485. * MMU fault. If there will be a pmd split later, the secondary MMUs
  486. * will get an update through the MMU notifier invalidation through
  487. * split_huge_pmd().
  488. *
  489. * Unlike PageTransCompound, this is safe to be called only while
  490. * split_huge_pmd() cannot run from under us, like if protected by the
  491. * MMU notifier, otherwise it may result in page->_mapcount < 0 false
  492. * positives.
  493. */
  494. static inline int PageTransCompoundMap(struct page *page)
  495. {
  496. return PageTransCompound(page) && atomic_read(&page->_mapcount) < 0;
  497. }
  498. /*
  499. * PageTransTail returns true for both transparent huge pages
  500. * and hugetlbfs pages, so it should only be called when it's known
  501. * that hugetlbfs pages aren't involved.
  502. */
  503. static inline int PageTransTail(struct page *page)
  504. {
  505. return PageTail(page);
  506. }
  507. /*
  508. * PageDoubleMap indicates that the compound page is mapped with PTEs as well
  509. * as PMDs.
  510. *
  511. * This is required for optimization of rmap operations for THP: we can postpone
  512. * per small page mapcount accounting (and its overhead from atomic operations)
  513. * until the first PMD split.
  514. *
  515. * For the page PageDoubleMap means ->_mapcount in all sub-pages is offset up
  516. * by one. This reference will go away with last compound_mapcount.
  517. *
  518. * See also __split_huge_pmd_locked() and page_remove_anon_compound_rmap().
  519. */
  520. static inline int PageDoubleMap(struct page *page)
  521. {
  522. return PageHead(page) && test_bit(PG_double_map, &page[1].flags);
  523. }
  524. static inline void SetPageDoubleMap(struct page *page)
  525. {
  526. VM_BUG_ON_PAGE(!PageHead(page), page);
  527. set_bit(PG_double_map, &page[1].flags);
  528. }
  529. static inline void ClearPageDoubleMap(struct page *page)
  530. {
  531. VM_BUG_ON_PAGE(!PageHead(page), page);
  532. clear_bit(PG_double_map, &page[1].flags);
  533. }
  534. static inline int TestSetPageDoubleMap(struct page *page)
  535. {
  536. VM_BUG_ON_PAGE(!PageHead(page), page);
  537. return test_and_set_bit(PG_double_map, &page[1].flags);
  538. }
  539. static inline int TestClearPageDoubleMap(struct page *page)
  540. {
  541. VM_BUG_ON_PAGE(!PageHead(page), page);
  542. return test_and_clear_bit(PG_double_map, &page[1].flags);
  543. }
  544. #else
  545. TESTPAGEFLAG_FALSE(TransHuge)
  546. TESTPAGEFLAG_FALSE(TransCompound)
  547. TESTPAGEFLAG_FALSE(TransCompoundMap)
  548. TESTPAGEFLAG_FALSE(TransTail)
  549. PAGEFLAG_FALSE(DoubleMap)
  550. TESTSETFLAG_FALSE(DoubleMap)
  551. TESTCLEARFLAG_FALSE(DoubleMap)
  552. #endif
  553. /*
  554. * For pages that are never mapped to userspace, page->mapcount may be
  555. * used for storing extra information about page type. Any value used
  556. * for this purpose must be <= -2, but it's better start not too close
  557. * to -2 so that an underflow of the page_mapcount() won't be mistaken
  558. * for a special page.
  559. */
  560. #define PAGE_MAPCOUNT_OPS(uname, lname) \
  561. static __always_inline int Page##uname(struct page *page) \
  562. { \
  563. return atomic_read(&page->_mapcount) == \
  564. PAGE_##lname##_MAPCOUNT_VALUE; \
  565. } \
  566. static __always_inline void __SetPage##uname(struct page *page) \
  567. { \
  568. VM_BUG_ON_PAGE(atomic_read(&page->_mapcount) != -1, page); \
  569. atomic_set(&page->_mapcount, PAGE_##lname##_MAPCOUNT_VALUE); \
  570. } \
  571. static __always_inline void __ClearPage##uname(struct page *page) \
  572. { \
  573. VM_BUG_ON_PAGE(!Page##uname(page), page); \
  574. atomic_set(&page->_mapcount, -1); \
  575. }
  576. /*
  577. * PageBuddy() indicate that the page is free and in the buddy system
  578. * (see mm/page_alloc.c).
  579. */
  580. #define PAGE_BUDDY_MAPCOUNT_VALUE (-128)
  581. PAGE_MAPCOUNT_OPS(Buddy, BUDDY)
  582. /*
  583. * PageBalloon() is set on pages that are on the balloon page list
  584. * (see mm/balloon_compaction.c).
  585. */
  586. #define PAGE_BALLOON_MAPCOUNT_VALUE (-256)
  587. PAGE_MAPCOUNT_OPS(Balloon, BALLOON)
  588. /*
  589. * If kmemcg is enabled, the buddy allocator will set PageKmemcg() on
  590. * pages allocated with __GFP_ACCOUNT. It gets cleared on page free.
  591. */
  592. #define PAGE_KMEMCG_MAPCOUNT_VALUE (-512)
  593. PAGE_MAPCOUNT_OPS(Kmemcg, KMEMCG)
  594. extern bool is_free_buddy_page(struct page *page);
  595. __PAGEFLAG(Isolated, isolated, PF_ANY);
  596. /*
  597. * If network-based swap is enabled, sl*b must keep track of whether pages
  598. * were allocated from pfmemalloc reserves.
  599. */
  600. static inline int PageSlabPfmemalloc(struct page *page)
  601. {
  602. VM_BUG_ON_PAGE(!PageSlab(page), page);
  603. return PageActive(page);
  604. }
  605. static inline void SetPageSlabPfmemalloc(struct page *page)
  606. {
  607. VM_BUG_ON_PAGE(!PageSlab(page), page);
  608. SetPageActive(page);
  609. }
  610. static inline void __ClearPageSlabPfmemalloc(struct page *page)
  611. {
  612. VM_BUG_ON_PAGE(!PageSlab(page), page);
  613. __ClearPageActive(page);
  614. }
  615. static inline void ClearPageSlabPfmemalloc(struct page *page)
  616. {
  617. VM_BUG_ON_PAGE(!PageSlab(page), page);
  618. ClearPageActive(page);
  619. }
  620. #ifdef CONFIG_MMU
  621. #define __PG_MLOCKED (1UL << PG_mlocked)
  622. #else
  623. #define __PG_MLOCKED 0
  624. #endif
  625. /*
  626. * Flags checked when a page is freed. Pages being freed should not have
  627. * these flags set. It they are, there is a problem.
  628. */
  629. #define PAGE_FLAGS_CHECK_AT_FREE \
  630. (1UL << PG_lru | 1UL << PG_locked | \
  631. 1UL << PG_private | 1UL << PG_private_2 | \
  632. 1UL << PG_writeback | 1UL << PG_reserved | \
  633. 1UL << PG_slab | 1UL << PG_active | \
  634. 1UL << PG_unevictable | __PG_MLOCKED)
  635. /*
  636. * Flags checked when a page is prepped for return by the page allocator.
  637. * Pages being prepped should not have these flags set. It they are set,
  638. * there has been a kernel bug or struct page corruption.
  639. *
  640. * __PG_HWPOISON is exceptional because it needs to be kept beyond page's
  641. * alloc-free cycle to prevent from reusing the page.
  642. */
  643. #define PAGE_FLAGS_CHECK_AT_PREP \
  644. (((1UL << NR_PAGEFLAGS) - 1) & ~__PG_HWPOISON)
  645. #define PAGE_FLAGS_PRIVATE \
  646. (1UL << PG_private | 1UL << PG_private_2)
  647. /**
  648. * page_has_private - Determine if page has private stuff
  649. * @page: The page to be checked
  650. *
  651. * Determine if a page has private stuff, indicating that release routines
  652. * should be invoked upon it.
  653. */
  654. static inline int page_has_private(struct page *page)
  655. {
  656. return !!(page->flags & PAGE_FLAGS_PRIVATE);
  657. }
  658. #undef PF_ANY
  659. #undef PF_HEAD
  660. #undef PF_ONLY_HEAD
  661. #undef PF_NO_TAIL
  662. #undef PF_NO_COMPOUND
  663. #endif /* !__GENERATING_BOUNDS_H */
  664. #endif /* PAGE_FLAGS_H */