ia64/xen-unstable

annotate xen/include/xen/mm.h @ 15580:29761c9b9105

Add new domctl hypercall to expose current heap values. This
functionality is needed for probing how much memory is available in a
given node prior to VM creation.

Signed-off-by: Ryan Harper <ryanh@us.ibm.com>
Signed-off-by: Keir Fraser <keir@xensource.com>
author kfraser@localhost.localdomain
date Wed Jul 11 13:03:57 2007 +0100 (2007-07-11)
parents 215b799fa181
children 3052a8f07a18
rev   line source
kaf24@8726 1 /******************************************************************************
kaf24@8726 2 * include/xen/mm.h
kaf24@8726 3 *
kaf24@8726 4 * Definitions for memory pages, frame numbers, addresses, allocations, etc.
kaf24@8726 5 *
kaf24@8726 6 * Note that Xen must handle several different physical 'address spaces' and
kaf24@8726 7 * there is a consistent terminology for these:
kaf24@8726 8 *
kaf24@8726 9 * 1. gpfn/gpaddr: A guest-specific pseudo-physical frame number or address.
kaf24@8726 10 * 2. gmfn/gmaddr: A machine address from the p.o.v. of a particular guest.
kaf24@8726 11 * 3. mfn/maddr: A real machine frame number or address.
kaf24@8726 12 * 4. pfn/paddr: Used in 'polymorphic' functions that work across all
kaf24@8726 13 * address spaces, depending on context. See the pagetable
kaf24@8726 14 * conversion macros in asm-x86/page.h for examples.
kaf24@8726 15 * Also 'paddr_t' is big enough to store any physical address.
kaf24@8726 16 *
kaf24@8726 17 * This scheme provides consistent function and variable names even when
kaf24@8726 18 * different guests are running in different memory-management modes.
kaf24@8726 19 * 1. A guest running in auto-translated mode (e.g., shadow_mode_translate())
kaf24@8726 20 * will have gpfn == gmfn and gmfn != mfn.
kaf24@8726 21 * 2. A paravirtualised x86 guest will have gpfn != gmfn and gmfn == mfn.
kaf24@8726 22 * 3. A paravirtualised guest with no pseudophysical overlay will have
kaf24@8726 23 * gpfn == gpmfn == mfn.
kaf24@8726 24 *
kaf24@8726 25 * Copyright (c) 2002-2006, K A Fraser <keir@xensource.com>
kaf24@8726 26 */
kaf24@1210 27
kaf24@1211 28 #ifndef __XEN_MM_H__
kaf24@1211 29 #define __XEN_MM_H__
kaf24@1210 30
kaf24@4267 31 #include <xen/config.h>
kaf24@5398 32 #include <xen/types.h>
kaf24@4267 33 #include <xen/list.h>
kaf24@4267 34 #include <xen/spinlock.h>
kaf24@4267 35
kaf24@1941 36 struct domain;
kaf24@8726 37 struct page_info;
kaf24@1936 38
kaf24@3354 39 /* Boot-time allocator. Turns into generic allocator after bootstrap. */
kaf24@8726 40 paddr_t init_boot_allocator(paddr_t bitmap_start);
kaf24@8726 41 void init_boot_pages(paddr_t ps, paddr_t pe);
kfraser@14083 42 unsigned long alloc_boot_pages(
kfraser@14083 43 unsigned long nr_pfns, unsigned long pfn_align);
kfraser@14083 44 unsigned long alloc_boot_low_pages(
kfraser@14083 45 unsigned long nr_pfns, unsigned long pfn_align);
kfraser@14083 46 int reserve_boot_pages(unsigned long first_pfn, unsigned long nr_pfns);
kaf24@3354 47 void end_boot_allocator(void);
kaf24@3354 48
kaf24@2806 49 /* Xen suballocator. These functions are interrupt-safe. */
kaf24@8726 50 void init_xenheap_pages(paddr_t ps, paddr_t pe);
kaf24@5398 51 void *alloc_xenheap_pages(unsigned int order);
kaf24@5398 52 void free_xenheap_pages(void *v, unsigned int order);
kaf24@1920 53 #define alloc_xenheap_page() (alloc_xenheap_pages(0))
kaf24@5398 54 #define free_xenheap_page(v) (free_xenheap_pages(v,0))
kaf24@1749 55
kaf24@2806 56 /* Domain suballocator. These functions are *not* interrupt-safe.*/
kaf24@8726 57 void init_domheap_pages(paddr_t ps, paddr_t pe);
kaf24@8726 58 struct page_info *alloc_domheap_pages(
kfraser@10418 59 struct domain *d, unsigned int order, unsigned int memflags);
kfraser@11972 60 struct page_info *__alloc_domheap_pages(
kfraser@11972 61 struct domain *d, unsigned int cpu, unsigned int order,
kfraser@11972 62 unsigned int memflags);
kaf24@8726 63 void free_domheap_pages(struct page_info *pg, unsigned int order);
kfraser@15580 64 unsigned long avail_domheap_pages_region(
kfraser@15580 65 unsigned int node, unsigned int min_width, unsigned int max_width);
kaf24@1936 66 unsigned long avail_domheap_pages(void);
kaf24@5929 67 #define alloc_domheap_page(d) (alloc_domheap_pages(d,0,0))
kaf24@5398 68 #define free_domheap_page(p) (free_domheap_pages(p,0))
kaf24@1210 69
kfraser@14098 70 void scrub_heap_pages(void);
kfraser@14098 71
kfraser@10418 72 int assign_pages(
kfraser@10418 73 struct domain *d,
kfraser@10418 74 struct page_info *pg,
kfraser@10418 75 unsigned int order,
kfraser@10418 76 unsigned int memflags);
kfraser@10418 77
kfraser@10418 78 /* memflags: */
kfraser@14103 79 #define _MEMF_no_refcount 0
kfraser@10418 80 #define MEMF_no_refcount (1U<<_MEMF_no_refcount)
kfraser@14103 81 #define _MEMF_bits 24
kfraser@14103 82 #define MEMF_bits(n) ((n)<<_MEMF_bits)
kaf24@5929 83
kaf24@10340 84 #ifdef CONFIG_PAGEALLOC_MAX_ORDER
kaf24@10340 85 #define MAX_ORDER CONFIG_PAGEALLOC_MAX_ORDER
kaf24@10340 86 #else
kaf24@10341 87 #define MAX_ORDER 20 /* 2^20 contiguous pages */
kaf24@10340 88 #endif
kaf24@9456 89
kaf24@4267 90 /* Automatic page scrubbing for dead domains. */
kaf24@4267 91 extern struct list_head page_scrub_list;
kaf24@4267 92 #define page_scrub_schedule_work() \
kaf24@4267 93 do { \
kaf24@4267 94 if ( !list_empty(&page_scrub_list) ) \
kaf24@4267 95 raise_softirq(PAGE_SCRUB_SOFTIRQ); \
kaf24@4267 96 } while ( 0 )
kfraser@14340 97 #define page_scrub_kick() \
kfraser@14340 98 do { \
kfraser@14340 99 if ( !list_empty(&page_scrub_list) ) \
kfraser@14340 100 cpumask_raise_softirq(cpu_online_map, PAGE_SCRUB_SOFTIRQ); \
kfraser@14340 101 } while ( 0 )
kaf24@10541 102 unsigned long avail_scrub_pages(void);
kaf24@4267 103
kaf24@1941 104 #include <asm/mm.h>
kaf24@1941 105
cl349@9211 106 int guest_remove_page(struct domain *d, unsigned long gmfn);
cl349@9211 107
kfraser@11177 108 /* Returns TRUE if the memory at address @p is ordinary RAM. */
kfraser@11177 109 int memory_is_conventional_ram(paddr_t p);
kfraser@11177 110
kaf24@1211 111 #endif /* __XEN_MM_H__ */