2 * Xen implementation for transcendent memory (tmem)
4 * Copyright (C) 2009-2011 Oracle Corp. All rights reserved.
5 * Author: Dan Magenheimer
8 #define pr_fmt(fmt) "xen:" KBUILD_MODNAME ": " fmt
10 #include <linux/module.h>
11 #include <linux/kernel.h>
12 #include <linux/types.h>
13 #include <linux/init.h>
14 #include <linux/pagemap.h>
15 #include <linux/cleancache.h>
16 #include <linux/frontswap.h>
19 #include <xen/interface/xen.h>
20 #include <asm/xen/hypercall.h>
21 #include <asm/xen/page.h>
22 #include <asm/xen/hypervisor.h>
25 #ifndef CONFIG_XEN_TMEM_MODULE
26 bool __read_mostly tmem_enabled = false;
28 static int __init enable_tmem(char *s)
33 __setup("tmem", enable_tmem);
36 #ifdef CONFIG_CLEANCACHE
37 static bool cleancache __read_mostly = true;
38 module_param(cleancache, bool, S_IRUGO);
39 static bool selfballooning __read_mostly = true;
40 module_param(selfballooning, bool, S_IRUGO);
41 #endif /* CONFIG_CLEANCACHE */
43 #ifdef CONFIG_FRONTSWAP
44 static bool frontswap __read_mostly = true;
45 module_param(frontswap, bool, S_IRUGO);
46 #else /* CONFIG_FRONTSWAP */
48 #endif /* CONFIG_FRONTSWAP */
50 #ifdef CONFIG_XEN_SELFBALLOONING
51 static bool selfshrinking __read_mostly = true;
52 module_param(selfshrinking, bool, S_IRUGO);
53 #endif /* CONFIG_XEN_SELFBALLOONING */
55 #define TMEM_CONTROL 0
56 #define TMEM_NEW_POOL 1
57 #define TMEM_DESTROY_POOL 2
58 #define TMEM_NEW_PAGE 3
59 #define TMEM_PUT_PAGE 4
60 #define TMEM_GET_PAGE 5
61 #define TMEM_FLUSH_PAGE 6
62 #define TMEM_FLUSH_OBJECT 7
67 /* Bits for HYPERVISOR_tmem_op(TMEM_NEW_POOL) */
68 #define TMEM_POOL_PERSIST 1
69 #define TMEM_POOL_SHARED 2
70 #define TMEM_POOL_PAGESIZE_SHIFT 4
71 #define TMEM_VERSION_SHIFT 24
74 struct tmem_pool_uuid {
83 #define TMEM_POOL_PRIVATE_UUID { 0, 0 }
85 /* flags for tmem_ops.new_pool */
86 #define TMEM_POOL_PERSIST 1
87 #define TMEM_POOL_SHARED 2
89 /* xen tmem foundation ops/hypercalls */
91 static inline int xen_tmem_op(u32 tmem_cmd, u32 tmem_pool, struct tmem_oid oid,
92 u32 index, unsigned long gmfn, u32 tmem_offset, u32 pfn_offset, u32 len)
98 op.pool_id = tmem_pool;
99 op.u.gen.oid[0] = oid.oid[0];
100 op.u.gen.oid[1] = oid.oid[1];
101 op.u.gen.oid[2] = oid.oid[2];
102 op.u.gen.index = index;
103 op.u.gen.tmem_offset = tmem_offset;
104 op.u.gen.pfn_offset = pfn_offset;
106 set_xen_guest_handle(op.u.gen.gmfn, (void *)gmfn);
107 rc = HYPERVISOR_tmem_op(&op);
111 static int xen_tmem_new_pool(struct tmem_pool_uuid uuid,
112 u32 flags, unsigned long pagesize)
115 int rc = 0, pageshift;
117 for (pageshift = 0; pagesize != 1; pageshift++)
119 flags |= (pageshift - 12) << TMEM_POOL_PAGESIZE_SHIFT;
120 flags |= TMEM_SPEC_VERSION << TMEM_VERSION_SHIFT;
121 op.cmd = TMEM_NEW_POOL;
122 op.u.new.uuid[0] = uuid.uuid_lo;
123 op.u.new.uuid[1] = uuid.uuid_hi;
124 op.u.new.flags = flags;
125 rc = HYPERVISOR_tmem_op(&op);
129 /* xen generic tmem ops */
131 static int xen_tmem_put_page(u32 pool_id, struct tmem_oid oid,
132 u32 index, unsigned long pfn)
134 unsigned long gmfn = xen_pv_domain() ? pfn_to_mfn(pfn) : pfn;
136 return xen_tmem_op(TMEM_PUT_PAGE, pool_id, oid, index,
140 static int xen_tmem_get_page(u32 pool_id, struct tmem_oid oid,
141 u32 index, unsigned long pfn)
143 unsigned long gmfn = xen_pv_domain() ? pfn_to_mfn(pfn) : pfn;
145 return xen_tmem_op(TMEM_GET_PAGE, pool_id, oid, index,
149 static int xen_tmem_flush_page(u32 pool_id, struct tmem_oid oid, u32 index)
151 return xen_tmem_op(TMEM_FLUSH_PAGE, pool_id, oid, index,
155 static int xen_tmem_flush_object(u32 pool_id, struct tmem_oid oid)
157 return xen_tmem_op(TMEM_FLUSH_OBJECT, pool_id, oid, 0, 0, 0, 0, 0);
161 #ifdef CONFIG_CLEANCACHE
162 static int xen_tmem_destroy_pool(u32 pool_id)
164 struct tmem_oid oid = { { 0 } };
166 return xen_tmem_op(TMEM_DESTROY_POOL, pool_id, oid, 0, 0, 0, 0, 0);
171 static void tmem_cleancache_put_page(int pool, struct cleancache_filekey key,
172 pgoff_t index, struct page *page)
174 u32 ind = (u32) index;
175 struct tmem_oid oid = *(struct tmem_oid *)&key;
176 unsigned long pfn = page_to_pfn(page);
182 mb(); /* ensure page is quiescent; tmem may address it with an alias */
183 (void)xen_tmem_put_page((u32)pool, oid, ind, pfn);
186 static int tmem_cleancache_get_page(int pool, struct cleancache_filekey key,
187 pgoff_t index, struct page *page)
189 u32 ind = (u32) index;
190 struct tmem_oid oid = *(struct tmem_oid *)&key;
191 unsigned long pfn = page_to_pfn(page);
194 /* translate return values to linux semantics */
199 ret = xen_tmem_get_page((u32)pool, oid, ind, pfn);
206 static void tmem_cleancache_flush_page(int pool, struct cleancache_filekey key,
209 u32 ind = (u32) index;
210 struct tmem_oid oid = *(struct tmem_oid *)&key;
216 (void)xen_tmem_flush_page((u32)pool, oid, ind);
219 static void tmem_cleancache_flush_inode(int pool, struct cleancache_filekey key)
221 struct tmem_oid oid = *(struct tmem_oid *)&key;
225 (void)xen_tmem_flush_object((u32)pool, oid);
228 static void tmem_cleancache_flush_fs(int pool)
232 (void)xen_tmem_destroy_pool((u32)pool);
235 static int tmem_cleancache_init_fs(size_t pagesize)
237 struct tmem_pool_uuid uuid_private = TMEM_POOL_PRIVATE_UUID;
239 return xen_tmem_new_pool(uuid_private, 0, pagesize);
242 static int tmem_cleancache_init_shared_fs(char *uuid, size_t pagesize)
244 struct tmem_pool_uuid shared_uuid;
246 shared_uuid.uuid_lo = *(u64 *)uuid;
247 shared_uuid.uuid_hi = *(u64 *)(&uuid[8]);
248 return xen_tmem_new_pool(shared_uuid, TMEM_POOL_SHARED, pagesize);
251 static struct cleancache_ops tmem_cleancache_ops = {
252 .put_page = tmem_cleancache_put_page,
253 .get_page = tmem_cleancache_get_page,
254 .invalidate_page = tmem_cleancache_flush_page,
255 .invalidate_inode = tmem_cleancache_flush_inode,
256 .invalidate_fs = tmem_cleancache_flush_fs,
257 .init_shared_fs = tmem_cleancache_init_shared_fs,
258 .init_fs = tmem_cleancache_init_fs
262 #ifdef CONFIG_FRONTSWAP
263 /* frontswap tmem operations */
265 /* a single tmem poolid is used for all frontswap "types" (swapfiles) */
266 static int tmem_frontswap_poolid;
269 * Swizzling increases objects per swaptype, increasing tmem concurrency
270 * for heavy swaploads. Later, larger nr_cpus -> larger SWIZ_BITS
273 #define SWIZ_MASK ((1 << SWIZ_BITS) - 1)
274 #define _oswiz(_type, _ind) ((_type << SWIZ_BITS) | (_ind & SWIZ_MASK))
275 #define iswiz(_ind) (_ind >> SWIZ_BITS)
277 static inline struct tmem_oid oswiz(unsigned type, u32 ind)
279 struct tmem_oid oid = { .oid = { 0 } };
280 oid.oid[0] = _oswiz(type, ind);
284 /* returns 0 if the page was successfully put into frontswap, -1 if not */
285 static int tmem_frontswap_store(unsigned type, pgoff_t offset,
288 u64 ind64 = (u64)offset;
289 u32 ind = (u32)offset;
290 unsigned long pfn = page_to_pfn(page);
291 int pool = tmem_frontswap_poolid;
298 mb(); /* ensure page is quiescent; tmem may address it with an alias */
299 ret = xen_tmem_put_page(pool, oswiz(type, ind), iswiz(ind), pfn);
300 /* translate Xen tmem return values to linux semantics */
308 * returns 0 if the page was successfully gotten from frontswap, -1 if
309 * was not present (should never happen!)
311 static int tmem_frontswap_load(unsigned type, pgoff_t offset,
314 u64 ind64 = (u64)offset;
315 u32 ind = (u32)offset;
316 unsigned long pfn = page_to_pfn(page);
317 int pool = tmem_frontswap_poolid;
324 ret = xen_tmem_get_page(pool, oswiz(type, ind), iswiz(ind), pfn);
325 /* translate Xen tmem return values to linux semantics */
332 /* flush a single page from frontswap */
333 static void tmem_frontswap_flush_page(unsigned type, pgoff_t offset)
335 u64 ind64 = (u64)offset;
336 u32 ind = (u32)offset;
337 int pool = tmem_frontswap_poolid;
343 (void) xen_tmem_flush_page(pool, oswiz(type, ind), iswiz(ind));
346 /* flush all pages from the passed swaptype */
347 static void tmem_frontswap_flush_area(unsigned type)
349 int pool = tmem_frontswap_poolid;
354 for (ind = SWIZ_MASK; ind >= 0; ind--)
355 (void)xen_tmem_flush_object(pool, oswiz(type, ind));
358 static void tmem_frontswap_init(unsigned ignored)
360 struct tmem_pool_uuid private = TMEM_POOL_PRIVATE_UUID;
362 /* a single tmem poolid is used for all frontswap "types" (swapfiles) */
363 if (tmem_frontswap_poolid < 0)
364 tmem_frontswap_poolid =
365 xen_tmem_new_pool(private, TMEM_POOL_PERSIST, PAGE_SIZE);
368 static struct frontswap_ops tmem_frontswap_ops = {
369 .store = tmem_frontswap_store,
370 .load = tmem_frontswap_load,
371 .invalidate_page = tmem_frontswap_flush_page,
372 .invalidate_area = tmem_frontswap_flush_area,
373 .init = tmem_frontswap_init
377 static int xen_tmem_init(void)
381 #ifdef CONFIG_FRONTSWAP
382 if (tmem_enabled && frontswap) {
384 struct frontswap_ops *old_ops;
386 tmem_frontswap_poolid = -1;
387 old_ops = frontswap_register_ops(&tmem_frontswap_ops);
388 if (IS_ERR(old_ops) || old_ops) {
390 return PTR_ERR(old_ops);
391 s = " (WARNING: frontswap_ops overridden)";
393 pr_info("frontswap enabled, RAM provided by Xen Transcendent Memory%s\n",
397 #ifdef CONFIG_CLEANCACHE
398 BUG_ON(sizeof(struct cleancache_filekey) != sizeof(struct tmem_oid));
399 if (tmem_enabled && cleancache) {
401 struct cleancache_ops *old_ops =
402 cleancache_register_ops(&tmem_cleancache_ops);
404 s = " (WARNING: cleancache_ops overridden)";
405 pr_info("cleancache enabled, RAM provided by Xen Transcendent Memory%s\n",
409 #ifdef CONFIG_XEN_SELFBALLOONING
411 * There is no point of driving pages to the swap system if they
412 * aren't going anywhere in tmem universe.
415 selfshrinking = false;
416 selfballooning = false;
418 xen_selfballoon_init(selfballooning, selfshrinking);
423 module_init(xen_tmem_init)
424 MODULE_LICENSE("GPL");
425 MODULE_AUTHOR("Dan Magenheimer <dan.magenheimer@oracle.com>");
426 MODULE_DESCRIPTION("Shim to Xen transcendent memory");