grant-table.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559
  1. /******************************************************************************
  2. * grant_table.c
  3. *
  4. * Granting foreign access to our memory reservation.
  5. *
  6. * Copyright (c) 2005-2006, Christopher Clark
  7. * Copyright (c) 2004-2005, K A Fraser
  8. *
  9. * This program is free software; you can redistribute it and/or
  10. * modify it under the terms of the GNU General Public License version 2
  11. * as published by the Free Software Foundation; or, when distributed
  12. * separately from the Linux kernel or incorporated into other
  13. * software packages, subject to the following license:
  14. *
  15. * Permission is hereby granted, free of charge, to any person obtaining a copy
  16. * of this source file (the "Software"), to deal in the Software without
  17. * restriction, including without limitation the rights to use, copy, modify,
  18. * merge, publish, distribute, sublicense, and/or sell copies of the Software,
  19. * and to permit persons to whom the Software is furnished to do so, subject to
  20. * the following conditions:
  21. *
  22. * The above copyright notice and this permission notice shall be included in
  23. * all copies or substantial portions of the Software.
  24. *
  25. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  26. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  27. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  28. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  29. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  30. * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  31. * IN THE SOFTWARE.
  32. */
  33. #include <linux/module.h>
  34. #include <linux/sched.h>
  35. #include <linux/mm.h>
  36. #include <linux/vmalloc.h>
  37. #include <linux/uaccess.h>
  38. #include <xen/xen.h>
  39. #include <xen/interface/xen.h>
  40. #include <xen/page.h>
  41. #include <xen/grant_table.h>
  42. #include <asm/xen/hypercall.h>
  43. #include <asm/pgtable.h>
  44. #include <asm/sync_bitops.h>
  45. /* External tools reserve first few grant table entries. */
  46. #define NR_RESERVED_ENTRIES 8
  47. #define GNTTAB_LIST_END 0xffffffff
  48. #define GREFS_PER_GRANT_FRAME (PAGE_SIZE / sizeof(struct grant_entry))
  49. static grant_ref_t **gnttab_list;
  50. static unsigned int nr_grant_frames;
  51. static unsigned int boot_max_nr_grant_frames;
  52. static int gnttab_free_count;
  53. static grant_ref_t gnttab_free_head;
  54. static DEFINE_SPINLOCK(gnttab_list_lock);
  55. static struct grant_entry *shared;
  56. static struct gnttab_free_callback *gnttab_free_callback_list;
  57. static int gnttab_expand(unsigned int req_entries);
  58. #define RPP (PAGE_SIZE / sizeof(grant_ref_t))
  59. static inline grant_ref_t *__gnttab_entry(grant_ref_t entry)
  60. {
  61. return &gnttab_list[(entry) / RPP][(entry) % RPP];
  62. }
  63. /* This can be used as an l-value */
  64. #define gnttab_entry(entry) (*__gnttab_entry(entry))
  65. static int get_free_entries(unsigned count)
  66. {
  67. unsigned long flags;
  68. int ref, rc;
  69. grant_ref_t head;
  70. spin_lock_irqsave(&gnttab_list_lock, flags);
  71. if ((gnttab_free_count < count) &&
  72. ((rc = gnttab_expand(count - gnttab_free_count)) < 0)) {
  73. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  74. return rc;
  75. }
  76. ref = head = gnttab_free_head;
  77. gnttab_free_count -= count;
  78. while (count-- > 1)
  79. head = gnttab_entry(head);
  80. gnttab_free_head = gnttab_entry(head);
  81. gnttab_entry(head) = GNTTAB_LIST_END;
  82. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  83. return ref;
  84. }
  85. static void do_free_callbacks(void)
  86. {
  87. struct gnttab_free_callback *callback, *next;
  88. callback = gnttab_free_callback_list;
  89. gnttab_free_callback_list = NULL;
  90. while (callback != NULL) {
  91. next = callback->next;
  92. if (gnttab_free_count >= callback->count) {
  93. callback->next = NULL;
  94. callback->fn(callback->arg);
  95. } else {
  96. callback->next = gnttab_free_callback_list;
  97. gnttab_free_callback_list = callback;
  98. }
  99. callback = next;
  100. }
  101. }
  102. static inline void check_free_callbacks(void)
  103. {
  104. if (unlikely(gnttab_free_callback_list))
  105. do_free_callbacks();
  106. }
  107. static void put_free_entry(grant_ref_t ref)
  108. {
  109. unsigned long flags;
  110. spin_lock_irqsave(&gnttab_list_lock, flags);
  111. gnttab_entry(ref) = gnttab_free_head;
  112. gnttab_free_head = ref;
  113. gnttab_free_count++;
  114. check_free_callbacks();
  115. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  116. }
  117. static void update_grant_entry(grant_ref_t ref, domid_t domid,
  118. unsigned long frame, unsigned flags)
  119. {
  120. /*
  121. * Introducing a valid entry into the grant table:
  122. * 1. Write ent->domid.
  123. * 2. Write ent->frame:
  124. * GTF_permit_access: Frame to which access is permitted.
  125. * GTF_accept_transfer: Pseudo-phys frame slot being filled by new
  126. * frame, or zero if none.
  127. * 3. Write memory barrier (WMB).
  128. * 4. Write ent->flags, inc. valid type.
  129. */
  130. shared[ref].frame = frame;
  131. shared[ref].domid = domid;
  132. wmb();
  133. shared[ref].flags = flags;
  134. }
  135. /*
  136. * Public grant-issuing interface functions
  137. */
  138. void gnttab_grant_foreign_access_ref(grant_ref_t ref, domid_t domid,
  139. unsigned long frame, int readonly)
  140. {
  141. update_grant_entry(ref, domid, frame,
  142. GTF_permit_access | (readonly ? GTF_readonly : 0));
  143. }
  144. EXPORT_SYMBOL_GPL(gnttab_grant_foreign_access_ref);
  145. int gnttab_grant_foreign_access(domid_t domid, unsigned long frame,
  146. int readonly)
  147. {
  148. int ref;
  149. ref = get_free_entries(1);
  150. if (unlikely(ref < 0))
  151. return -ENOSPC;
  152. gnttab_grant_foreign_access_ref(ref, domid, frame, readonly);
  153. return ref;
  154. }
  155. EXPORT_SYMBOL_GPL(gnttab_grant_foreign_access);
  156. int gnttab_query_foreign_access(grant_ref_t ref)
  157. {
  158. u16 nflags;
  159. nflags = shared[ref].flags;
  160. return (nflags & (GTF_reading|GTF_writing));
  161. }
  162. EXPORT_SYMBOL_GPL(gnttab_query_foreign_access);
  163. int gnttab_end_foreign_access_ref(grant_ref_t ref, int readonly)
  164. {
  165. u16 flags, nflags;
  166. nflags = shared[ref].flags;
  167. do {
  168. flags = nflags;
  169. if (flags & (GTF_reading|GTF_writing)) {
  170. printk(KERN_ALERT "WARNING: g.e. still in use!\n");
  171. return 0;
  172. }
  173. } while ((nflags = sync_cmpxchg(&shared[ref].flags, flags, 0)) != flags);
  174. return 1;
  175. }
  176. EXPORT_SYMBOL_GPL(gnttab_end_foreign_access_ref);
  177. void gnttab_end_foreign_access(grant_ref_t ref, int readonly,
  178. unsigned long page)
  179. {
  180. if (gnttab_end_foreign_access_ref(ref, readonly)) {
  181. put_free_entry(ref);
  182. if (page != 0)
  183. free_page(page);
  184. } else {
  185. /* XXX This needs to be fixed so that the ref and page are
  186. placed on a list to be freed up later. */
  187. printk(KERN_WARNING
  188. "WARNING: leaking g.e. and page still in use!\n");
  189. }
  190. }
  191. EXPORT_SYMBOL_GPL(gnttab_end_foreign_access);
  192. int gnttab_grant_foreign_transfer(domid_t domid, unsigned long pfn)
  193. {
  194. int ref;
  195. ref = get_free_entries(1);
  196. if (unlikely(ref < 0))
  197. return -ENOSPC;
  198. gnttab_grant_foreign_transfer_ref(ref, domid, pfn);
  199. return ref;
  200. }
  201. EXPORT_SYMBOL_GPL(gnttab_grant_foreign_transfer);
  202. void gnttab_grant_foreign_transfer_ref(grant_ref_t ref, domid_t domid,
  203. unsigned long pfn)
  204. {
  205. update_grant_entry(ref, domid, pfn, GTF_accept_transfer);
  206. }
  207. EXPORT_SYMBOL_GPL(gnttab_grant_foreign_transfer_ref);
  208. unsigned long gnttab_end_foreign_transfer_ref(grant_ref_t ref)
  209. {
  210. unsigned long frame;
  211. u16 flags;
  212. /*
  213. * If a transfer is not even yet started, try to reclaim the grant
  214. * reference and return failure (== 0).
  215. */
  216. while (!((flags = shared[ref].flags) & GTF_transfer_committed)) {
  217. if (sync_cmpxchg(&shared[ref].flags, flags, 0) == flags)
  218. return 0;
  219. cpu_relax();
  220. }
  221. /* If a transfer is in progress then wait until it is completed. */
  222. while (!(flags & GTF_transfer_completed)) {
  223. flags = shared[ref].flags;
  224. cpu_relax();
  225. }
  226. rmb(); /* Read the frame number /after/ reading completion status. */
  227. frame = shared[ref].frame;
  228. BUG_ON(frame == 0);
  229. return frame;
  230. }
  231. EXPORT_SYMBOL_GPL(gnttab_end_foreign_transfer_ref);
  232. unsigned long gnttab_end_foreign_transfer(grant_ref_t ref)
  233. {
  234. unsigned long frame = gnttab_end_foreign_transfer_ref(ref);
  235. put_free_entry(ref);
  236. return frame;
  237. }
  238. EXPORT_SYMBOL_GPL(gnttab_end_foreign_transfer);
  239. void gnttab_free_grant_reference(grant_ref_t ref)
  240. {
  241. put_free_entry(ref);
  242. }
  243. EXPORT_SYMBOL_GPL(gnttab_free_grant_reference);
  244. void gnttab_free_grant_references(grant_ref_t head)
  245. {
  246. grant_ref_t ref;
  247. unsigned long flags;
  248. int count = 1;
  249. if (head == GNTTAB_LIST_END)
  250. return;
  251. spin_lock_irqsave(&gnttab_list_lock, flags);
  252. ref = head;
  253. while (gnttab_entry(ref) != GNTTAB_LIST_END) {
  254. ref = gnttab_entry(ref);
  255. count++;
  256. }
  257. gnttab_entry(ref) = gnttab_free_head;
  258. gnttab_free_head = head;
  259. gnttab_free_count += count;
  260. check_free_callbacks();
  261. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  262. }
  263. EXPORT_SYMBOL_GPL(gnttab_free_grant_references);
  264. int gnttab_alloc_grant_references(u16 count, grant_ref_t *head)
  265. {
  266. int h = get_free_entries(count);
  267. if (h < 0)
  268. return -ENOSPC;
  269. *head = h;
  270. return 0;
  271. }
  272. EXPORT_SYMBOL_GPL(gnttab_alloc_grant_references);
  273. int gnttab_empty_grant_references(const grant_ref_t *private_head)
  274. {
  275. return (*private_head == GNTTAB_LIST_END);
  276. }
  277. EXPORT_SYMBOL_GPL(gnttab_empty_grant_references);
  278. int gnttab_claim_grant_reference(grant_ref_t *private_head)
  279. {
  280. grant_ref_t g = *private_head;
  281. if (unlikely(g == GNTTAB_LIST_END))
  282. return -ENOSPC;
  283. *private_head = gnttab_entry(g);
  284. return g;
  285. }
  286. EXPORT_SYMBOL_GPL(gnttab_claim_grant_reference);
  287. void gnttab_release_grant_reference(grant_ref_t *private_head,
  288. grant_ref_t release)
  289. {
  290. gnttab_entry(release) = *private_head;
  291. *private_head = release;
  292. }
  293. EXPORT_SYMBOL_GPL(gnttab_release_grant_reference);
  294. void gnttab_request_free_callback(struct gnttab_free_callback *callback,
  295. void (*fn)(void *), void *arg, u16 count)
  296. {
  297. unsigned long flags;
  298. spin_lock_irqsave(&gnttab_list_lock, flags);
  299. if (callback->next)
  300. goto out;
  301. callback->fn = fn;
  302. callback->arg = arg;
  303. callback->count = count;
  304. callback->next = gnttab_free_callback_list;
  305. gnttab_free_callback_list = callback;
  306. check_free_callbacks();
  307. out:
  308. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  309. }
  310. EXPORT_SYMBOL_GPL(gnttab_request_free_callback);
  311. void gnttab_cancel_free_callback(struct gnttab_free_callback *callback)
  312. {
  313. struct gnttab_free_callback **pcb;
  314. unsigned long flags;
  315. spin_lock_irqsave(&gnttab_list_lock, flags);
  316. for (pcb = &gnttab_free_callback_list; *pcb; pcb = &(*pcb)->next) {
  317. if (*pcb == callback) {
  318. *pcb = callback->next;
  319. break;
  320. }
  321. }
  322. spin_unlock_irqrestore(&gnttab_list_lock, flags);
  323. }
  324. EXPORT_SYMBOL_GPL(gnttab_cancel_free_callback);
  325. static int grow_gnttab_list(unsigned int more_frames)
  326. {
  327. unsigned int new_nr_grant_frames, extra_entries, i;
  328. unsigned int nr_glist_frames, new_nr_glist_frames;
  329. new_nr_grant_frames = nr_grant_frames + more_frames;
  330. extra_entries = more_frames * GREFS_PER_GRANT_FRAME;
  331. nr_glist_frames = (nr_grant_frames * GREFS_PER_GRANT_FRAME + RPP - 1) / RPP;
  332. new_nr_glist_frames =
  333. (new_nr_grant_frames * GREFS_PER_GRANT_FRAME + RPP - 1) / RPP;
  334. for (i = nr_glist_frames; i < new_nr_glist_frames; i++) {
  335. gnttab_list[i] = (grant_ref_t *)__get_free_page(GFP_ATOMIC);
  336. if (!gnttab_list[i])
  337. goto grow_nomem;
  338. }
  339. for (i = GREFS_PER_GRANT_FRAME * nr_grant_frames;
  340. i < GREFS_PER_GRANT_FRAME * new_nr_grant_frames - 1; i++)
  341. gnttab_entry(i) = i + 1;
  342. gnttab_entry(i) = gnttab_free_head;
  343. gnttab_free_head = GREFS_PER_GRANT_FRAME * nr_grant_frames;
  344. gnttab_free_count += extra_entries;
  345. nr_grant_frames = new_nr_grant_frames;
  346. check_free_callbacks();
  347. return 0;
  348. grow_nomem:
  349. for ( ; i >= nr_glist_frames; i--)
  350. free_page((unsigned long) gnttab_list[i]);
  351. return -ENOMEM;
  352. }
  353. static unsigned int __max_nr_grant_frames(void)
  354. {
  355. struct gnttab_query_size query;
  356. int rc;
  357. query.dom = DOMID_SELF;
  358. rc = HYPERVISOR_grant_table_op(GNTTABOP_query_size, &query, 1);
  359. if ((rc < 0) || (query.status != GNTST_okay))
  360. return 4; /* Legacy max supported number of frames */
  361. return query.max_nr_frames;
  362. }
  363. static inline unsigned int max_nr_grant_frames(void)
  364. {
  365. unsigned int xen_max = __max_nr_grant_frames();
  366. if (xen_max > boot_max_nr_grant_frames)
  367. return boot_max_nr_grant_frames;
  368. return xen_max;
  369. }
  370. static int gnttab_map(unsigned int start_idx, unsigned int end_idx)
  371. {
  372. struct gnttab_setup_table setup;
  373. unsigned long *frames;
  374. unsigned int nr_gframes = end_idx + 1;
  375. int rc;
  376. frames = kmalloc(nr_gframes * sizeof(unsigned long), GFP_ATOMIC);
  377. if (!frames)
  378. return -ENOMEM;
  379. setup.dom = DOMID_SELF;
  380. setup.nr_frames = nr_gframes;
  381. set_xen_guest_handle(setup.frame_list, frames);
  382. rc = HYPERVISOR_grant_table_op(GNTTABOP_setup_table, &setup, 1);
  383. if (rc == -ENOSYS) {
  384. kfree(frames);
  385. return -ENOSYS;
  386. }
  387. BUG_ON(rc || setup.status);
  388. rc = arch_gnttab_map_shared(frames, nr_gframes, max_nr_grant_frames(),
  389. &shared);
  390. BUG_ON(rc);
  391. kfree(frames);
  392. return 0;
  393. }
  394. int gnttab_resume(void)
  395. {
  396. if (max_nr_grant_frames() < nr_grant_frames)
  397. return -ENOSYS;
  398. return gnttab_map(0, nr_grant_frames - 1);
  399. }
  400. int gnttab_suspend(void)
  401. {
  402. arch_gnttab_unmap_shared(shared, nr_grant_frames);
  403. return 0;
  404. }
  405. static int gnttab_expand(unsigned int req_entries)
  406. {
  407. int rc;
  408. unsigned int cur, extra;
  409. cur = nr_grant_frames;
  410. extra = ((req_entries + (GREFS_PER_GRANT_FRAME-1)) /
  411. GREFS_PER_GRANT_FRAME);
  412. if (cur + extra > max_nr_grant_frames())
  413. return -ENOSPC;
  414. rc = gnttab_map(cur, cur + extra - 1);
  415. if (rc == 0)
  416. rc = grow_gnttab_list(extra);
  417. return rc;
  418. }
  419. static int __devinit gnttab_init(void)
  420. {
  421. int i;
  422. unsigned int max_nr_glist_frames, nr_glist_frames;
  423. unsigned int nr_init_grefs;
  424. if (!xen_domain())
  425. return -ENODEV;
  426. nr_grant_frames = 1;
  427. boot_max_nr_grant_frames = __max_nr_grant_frames();
  428. /* Determine the maximum number of frames required for the
  429. * grant reference free list on the current hypervisor.
  430. */
  431. max_nr_glist_frames = (boot_max_nr_grant_frames *
  432. GREFS_PER_GRANT_FRAME / RPP);
  433. gnttab_list = kmalloc(max_nr_glist_frames * sizeof(grant_ref_t *),
  434. GFP_KERNEL);
  435. if (gnttab_list == NULL)
  436. return -ENOMEM;
  437. nr_glist_frames = (nr_grant_frames * GREFS_PER_GRANT_FRAME + RPP - 1) / RPP;
  438. for (i = 0; i < nr_glist_frames; i++) {
  439. gnttab_list[i] = (grant_ref_t *)__get_free_page(GFP_KERNEL);
  440. if (gnttab_list[i] == NULL)
  441. goto ini_nomem;
  442. }
  443. if (gnttab_resume() < 0)
  444. return -ENODEV;
  445. nr_init_grefs = nr_grant_frames * GREFS_PER_GRANT_FRAME;
  446. for (i = NR_RESERVED_ENTRIES; i < nr_init_grefs - 1; i++)
  447. gnttab_entry(i) = i + 1;
  448. gnttab_entry(nr_init_grefs - 1) = GNTTAB_LIST_END;
  449. gnttab_free_count = nr_init_grefs - NR_RESERVED_ENTRIES;
  450. gnttab_free_head = NR_RESERVED_ENTRIES;
  451. printk("Grant table initialized\n");
  452. return 0;
  453. ini_nomem:
  454. for (i--; i >= 0; i--)
  455. free_page((unsigned long)gnttab_list[i]);
  456. kfree(gnttab_list);
  457. return -ENOMEM;
  458. }
  459. core_initcall(gnttab_init);