page-flags.h 23 KB

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