frontswap.c 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348
  1. /*
  2. * Frontswap frontend
  3. *
  4. * This code provides the generic "frontend" layer to call a matching
  5. * "backend" driver implementation of frontswap. See
  6. * Documentation/vm/frontswap.txt for more information.
  7. *
  8. * Copyright (C) 2009-2012 Oracle Corp. All rights reserved.
  9. * Author: Dan Magenheimer
  10. *
  11. * This work is licensed under the terms of the GNU GPL, version 2.
  12. */
  13. #include <linux/mm.h>
  14. #include <linux/mman.h>
  15. #include <linux/swap.h>
  16. #include <linux/swapops.h>
  17. #include <linux/proc_fs.h>
  18. #include <linux/security.h>
  19. #include <linux/capability.h>
  20. #include <linux/module.h>
  21. #include <linux/uaccess.h>
  22. #include <linux/debugfs.h>
  23. #include <linux/frontswap.h>
  24. #include <linux/swapfile.h>
  25. /*
  26. * frontswap_ops is set by frontswap_register_ops to contain the pointers
  27. * to the frontswap "backend" implementation functions.
  28. */
  29. static struct frontswap_ops frontswap_ops __read_mostly;
  30. /*
  31. * This global enablement flag reduces overhead on systems where frontswap_ops
  32. * has not been registered, so is preferred to the slower alternative: a
  33. * function call that checks a non-global.
  34. */
  35. bool frontswap_enabled __read_mostly;
  36. EXPORT_SYMBOL(frontswap_enabled);
  37. /*
  38. * If enabled, frontswap_store will return failure even on success. As
  39. * a result, the swap subsystem will always write the page to swap, in
  40. * effect converting frontswap into a writethrough cache. In this mode,
  41. * there is no direct reduction in swap writes, but a frontswap backend
  42. * can unilaterally "reclaim" any pages in use with no data loss, thus
  43. * providing increases control over maximum memory usage due to frontswap.
  44. */
  45. static bool frontswap_writethrough_enabled __read_mostly;
  46. #ifdef CONFIG_DEBUG_FS
  47. /*
  48. * Counters available via /sys/kernel/debug/frontswap (if debugfs is
  49. * properly configured). These are for information only so are not protected
  50. * against increment races.
  51. */
  52. static u64 frontswap_loads;
  53. static u64 frontswap_succ_stores;
  54. static u64 frontswap_failed_stores;
  55. static u64 frontswap_invalidates;
  56. static inline void inc_frontswap_loads(void) {
  57. frontswap_loads++;
  58. }
  59. static inline void inc_frontswap_succ_stores(void) {
  60. frontswap_succ_stores++;
  61. }
  62. static inline void inc_frontswap_failed_stores(void) {
  63. frontswap_failed_stores++;
  64. }
  65. static inline void inc_frontswap_invalidates(void) {
  66. frontswap_invalidates++;
  67. }
  68. #else
  69. static inline void inc_frontswap_loads(void) { }
  70. static inline void inc_frontswap_succ_stores(void) { }
  71. static inline void inc_frontswap_failed_stores(void) { }
  72. static inline void inc_frontswap_invalidates(void) { }
  73. #endif
  74. /*
  75. * Register operations for frontswap, returning previous thus allowing
  76. * detection of multiple backends and possible nesting.
  77. */
  78. struct frontswap_ops frontswap_register_ops(struct frontswap_ops *ops)
  79. {
  80. struct frontswap_ops old = frontswap_ops;
  81. frontswap_ops = *ops;
  82. frontswap_enabled = true;
  83. return old;
  84. }
  85. EXPORT_SYMBOL(frontswap_register_ops);
  86. /*
  87. * Enable/disable frontswap writethrough (see above).
  88. */
  89. void frontswap_writethrough(bool enable)
  90. {
  91. frontswap_writethrough_enabled = enable;
  92. }
  93. EXPORT_SYMBOL(frontswap_writethrough);
  94. /*
  95. * Called when a swap device is swapon'd.
  96. */
  97. void __frontswap_init(unsigned type)
  98. {
  99. struct swap_info_struct *sis = swap_info[type];
  100. BUG_ON(sis == NULL);
  101. if (sis->frontswap_map == NULL)
  102. return;
  103. frontswap_ops.init(type);
  104. }
  105. EXPORT_SYMBOL(__frontswap_init);
  106. static inline void __frontswap_clear(struct swap_info_struct *sis, pgoff_t offset)
  107. {
  108. frontswap_clear(sis, offset);
  109. atomic_dec(&sis->frontswap_pages);
  110. }
  111. /*
  112. * "Store" data from a page to frontswap and associate it with the page's
  113. * swaptype and offset. Page must be locked and in the swap cache.
  114. * If frontswap already contains a page with matching swaptype and
  115. * offset, the frontswap implmentation may either overwrite the data and
  116. * return success or invalidate the page from frontswap and return failure.
  117. */
  118. int __frontswap_store(struct page *page)
  119. {
  120. int ret = -1, dup = 0;
  121. swp_entry_t entry = { .val = page_private(page), };
  122. int type = swp_type(entry);
  123. struct swap_info_struct *sis = swap_info[type];
  124. pgoff_t offset = swp_offset(entry);
  125. BUG_ON(!PageLocked(page));
  126. BUG_ON(sis == NULL);
  127. if (frontswap_test(sis, offset))
  128. dup = 1;
  129. ret = frontswap_ops.store(type, offset, page);
  130. if (ret == 0) {
  131. frontswap_set(sis, offset);
  132. inc_frontswap_succ_stores();
  133. if (!dup)
  134. atomic_inc(&sis->frontswap_pages);
  135. } else {
  136. /*
  137. failed dup always results in automatic invalidate of
  138. the (older) page from frontswap
  139. */
  140. inc_frontswap_failed_stores();
  141. if (dup)
  142. __frontswap_clear(sis, offset);
  143. }
  144. if (frontswap_writethrough_enabled)
  145. /* report failure so swap also writes to swap device */
  146. ret = -1;
  147. return ret;
  148. }
  149. EXPORT_SYMBOL(__frontswap_store);
  150. /*
  151. * "Get" data from frontswap associated with swaptype and offset that were
  152. * specified when the data was put to frontswap and use it to fill the
  153. * specified page with data. Page must be locked and in the swap cache.
  154. */
  155. int __frontswap_load(struct page *page)
  156. {
  157. int ret = -1;
  158. swp_entry_t entry = { .val = page_private(page), };
  159. int type = swp_type(entry);
  160. struct swap_info_struct *sis = swap_info[type];
  161. pgoff_t offset = swp_offset(entry);
  162. BUG_ON(!PageLocked(page));
  163. BUG_ON(sis == NULL);
  164. if (frontswap_test(sis, offset))
  165. ret = frontswap_ops.load(type, offset, page);
  166. if (ret == 0)
  167. inc_frontswap_loads();
  168. return ret;
  169. }
  170. EXPORT_SYMBOL(__frontswap_load);
  171. /*
  172. * Invalidate any data from frontswap associated with the specified swaptype
  173. * and offset so that a subsequent "get" will fail.
  174. */
  175. void __frontswap_invalidate_page(unsigned type, pgoff_t offset)
  176. {
  177. struct swap_info_struct *sis = swap_info[type];
  178. BUG_ON(sis == NULL);
  179. if (frontswap_test(sis, offset)) {
  180. frontswap_ops.invalidate_page(type, offset);
  181. __frontswap_clear(sis, offset);
  182. inc_frontswap_invalidates();
  183. }
  184. }
  185. EXPORT_SYMBOL(__frontswap_invalidate_page);
  186. /*
  187. * Invalidate all data from frontswap associated with all offsets for the
  188. * specified swaptype.
  189. */
  190. void __frontswap_invalidate_area(unsigned type)
  191. {
  192. struct swap_info_struct *sis = swap_info[type];
  193. BUG_ON(sis == NULL);
  194. if (sis->frontswap_map == NULL)
  195. return;
  196. frontswap_ops.invalidate_area(type);
  197. atomic_set(&sis->frontswap_pages, 0);
  198. memset(sis->frontswap_map, 0, sis->max / sizeof(long));
  199. }
  200. EXPORT_SYMBOL(__frontswap_invalidate_area);
  201. static unsigned long __frontswap_curr_pages(void)
  202. {
  203. int type;
  204. unsigned long totalpages = 0;
  205. struct swap_info_struct *si = NULL;
  206. assert_spin_locked(&swap_lock);
  207. for (type = swap_list.head; type >= 0; type = si->next) {
  208. si = swap_info[type];
  209. totalpages += atomic_read(&si->frontswap_pages);
  210. }
  211. return totalpages;
  212. }
  213. static int __frontswap_unuse_pages(unsigned long total, unsigned long *unused,
  214. int *swapid)
  215. {
  216. int ret = -EINVAL;
  217. struct swap_info_struct *si = NULL;
  218. int si_frontswap_pages;
  219. unsigned long total_pages_to_unuse = total;
  220. unsigned long pages = 0, pages_to_unuse = 0;
  221. int type;
  222. assert_spin_locked(&swap_lock);
  223. for (type = swap_list.head; type >= 0; type = si->next) {
  224. si = swap_info[type];
  225. si_frontswap_pages = atomic_read(&si->frontswap_pages);
  226. if (total_pages_to_unuse < si_frontswap_pages) {
  227. pages = pages_to_unuse = total_pages_to_unuse;
  228. } else {
  229. pages = si_frontswap_pages;
  230. pages_to_unuse = 0; /* unuse all */
  231. }
  232. /* ensure there is enough RAM to fetch pages from frontswap */
  233. if (security_vm_enough_memory_mm(current->mm, pages)) {
  234. ret = -ENOMEM;
  235. continue;
  236. }
  237. vm_unacct_memory(pages);
  238. *unused = pages_to_unuse;
  239. *swapid = type;
  240. ret = 0;
  241. break;
  242. }
  243. return ret;
  244. }
  245. static int __frontswap_shrink(unsigned long target_pages,
  246. unsigned long *pages_to_unuse,
  247. int *type)
  248. {
  249. unsigned long total_pages = 0, total_pages_to_unuse;
  250. assert_spin_locked(&swap_lock);
  251. total_pages = __frontswap_curr_pages();
  252. if (total_pages <= target_pages) {
  253. /* Nothing to do */
  254. *pages_to_unuse = 0;
  255. return 0;
  256. }
  257. total_pages_to_unuse = total_pages - target_pages;
  258. return __frontswap_unuse_pages(total_pages_to_unuse, pages_to_unuse, type);
  259. }
  260. /*
  261. * Frontswap, like a true swap device, may unnecessarily retain pages
  262. * under certain circumstances; "shrink" frontswap is essentially a
  263. * "partial swapoff" and works by calling try_to_unuse to attempt to
  264. * unuse enough frontswap pages to attempt to -- subject to memory
  265. * constraints -- reduce the number of pages in frontswap to the
  266. * number given in the parameter target_pages.
  267. */
  268. void frontswap_shrink(unsigned long target_pages)
  269. {
  270. unsigned long pages_to_unuse = 0;
  271. int type, ret;
  272. /*
  273. * we don't want to hold swap_lock while doing a very
  274. * lengthy try_to_unuse, but swap_list may change
  275. * so restart scan from swap_list.head each time
  276. */
  277. spin_lock(&swap_lock);
  278. ret = __frontswap_shrink(target_pages, &pages_to_unuse, &type);
  279. spin_unlock(&swap_lock);
  280. if (ret == 0 && pages_to_unuse)
  281. try_to_unuse(type, true, pages_to_unuse);
  282. return;
  283. }
  284. EXPORT_SYMBOL(frontswap_shrink);
  285. /*
  286. * Count and return the number of frontswap pages across all
  287. * swap devices. This is exported so that backend drivers can
  288. * determine current usage without reading debugfs.
  289. */
  290. unsigned long frontswap_curr_pages(void)
  291. {
  292. unsigned long totalpages = 0;
  293. spin_lock(&swap_lock);
  294. totalpages = __frontswap_curr_pages();
  295. spin_unlock(&swap_lock);
  296. return totalpages;
  297. }
  298. EXPORT_SYMBOL(frontswap_curr_pages);
  299. static int __init init_frontswap(void)
  300. {
  301. #ifdef CONFIG_DEBUG_FS
  302. struct dentry *root = debugfs_create_dir("frontswap", NULL);
  303. if (root == NULL)
  304. return -ENXIO;
  305. debugfs_create_u64("loads", S_IRUGO, root, &frontswap_loads);
  306. debugfs_create_u64("succ_stores", S_IRUGO, root, &frontswap_succ_stores);
  307. debugfs_create_u64("failed_stores", S_IRUGO, root,
  308. &frontswap_failed_stores);
  309. debugfs_create_u64("invalidates", S_IRUGO,
  310. root, &frontswap_invalidates);
  311. #endif
  312. return 0;
  313. }
  314. module_init(init_frontswap);