Commit | Line | Data |
---|---|---|
a42089dd JF |
1 | /****************************************************************************** |
2 | * memory.h | |
3 | * | |
4 | * Memory reservation and information. | |
5 | * | |
6 | * Copyright (c) 2005, Keir Fraser <keir@xensource.com> | |
7 | */ | |
8 | ||
9 | #ifndef __XEN_PUBLIC_MEMORY_H__ | |
10 | #define __XEN_PUBLIC_MEMORY_H__ | |
11 | ||
19001c8c AN |
12 | #include <linux/spinlock.h> |
13 | ||
a42089dd JF |
14 | /* |
15 | * Increase or decrease the specified domain's memory reservation. Returns a | |
16 | * -ve errcode on failure, or the # extents successfully allocated or freed. | |
17 | * arg == addr of struct xen_memory_reservation. | |
18 | */ | |
19 | #define XENMEM_increase_reservation 0 | |
20 | #define XENMEM_decrease_reservation 1 | |
21 | #define XENMEM_populate_physmap 6 | |
22 | struct xen_memory_reservation { | |
23 | ||
24 | /* | |
25 | * XENMEM_increase_reservation: | |
26 | * OUT: MFN (*not* GMFN) bases of extents that were allocated | |
27 | * XENMEM_decrease_reservation: | |
28 | * IN: GMFN bases of extents to free | |
29 | * XENMEM_populate_physmap: | |
30 | * IN: GPFN bases of extents to populate with memory | |
31 | * OUT: GMFN bases of extents that were allocated | |
32 | * (NB. This command also updates the mach_to_phys translation table) | |
33 | */ | |
bd3f79b7 | 34 | GUEST_HANDLE(xen_pfn_t) extent_start; |
a42089dd JF |
35 | |
36 | /* Number of extents, and size/alignment of each (2^extent_order pages). */ | |
256f631f | 37 | xen_ulong_t nr_extents; |
a42089dd JF |
38 | unsigned int extent_order; |
39 | ||
40 | /* | |
41 | * Maximum # bits addressable by the user of the allocated region (e.g., | |
42 | * I/O devices often have a 32-bit limitation even in 64-bit systems). If | |
43 | * zero then the user has no addressing restriction. | |
44 | * This field is not used by XENMEM_decrease_reservation. | |
45 | */ | |
46 | unsigned int address_bits; | |
47 | ||
48 | /* | |
49 | * Domain whose reservation is being changed. | |
50 | * Unprivileged domains can specify only DOMID_SELF. | |
51 | */ | |
52 | domid_t domid; | |
53 | ||
54 | }; | |
bfdab126 | 55 | DEFINE_GUEST_HANDLE_STRUCT(xen_memory_reservation); |
a42089dd | 56 | |
08bbc9da AN |
57 | /* |
58 | * An atomic exchange of memory pages. If return code is zero then | |
59 | * @out.extent_list provides GMFNs of the newly-allocated memory. | |
60 | * Returns zero on complete success, otherwise a negative error code. | |
61 | * On complete success then always @nr_exchanged == @in.nr_extents. | |
62 | * On partial success @nr_exchanged indicates how much work was done. | |
63 | */ | |
64 | #define XENMEM_exchange 11 | |
65 | struct xen_memory_exchange { | |
66 | /* | |
67 | * [IN] Details of memory extents to be exchanged (GMFN bases). | |
68 | * Note that @in.address_bits is ignored and unused. | |
69 | */ | |
70 | struct xen_memory_reservation in; | |
71 | ||
72 | /* | |
73 | * [IN/OUT] Details of new memory extents. | |
74 | * We require that: | |
75 | * 1. @in.domid == @out.domid | |
76 | * 2. @in.nr_extents << @in.extent_order == | |
77 | * @out.nr_extents << @out.extent_order | |
78 | * 3. @in.extent_start and @out.extent_start lists must not overlap | |
79 | * 4. @out.extent_start lists GPFN bases to be populated | |
80 | * 5. @out.extent_start is overwritten with allocated GMFN bases | |
81 | */ | |
82 | struct xen_memory_reservation out; | |
83 | ||
84 | /* | |
85 | * [OUT] Number of input extents that were successfully exchanged: | |
86 | * 1. The first @nr_exchanged input extents were successfully | |
87 | * deallocated. | |
88 | * 2. The corresponding first entries in the output extent list correctly | |
89 | * indicate the GMFNs that were successfully exchanged. | |
90 | * 3. All other input and output extents are untouched. | |
91 | * 4. If not all input exents are exchanged then the return code of this | |
92 | * command will be non-zero. | |
93 | * 5. THIS FIELD MUST BE INITIALISED TO ZERO BY THE CALLER! | |
94 | */ | |
256f631f | 95 | xen_ulong_t nr_exchanged; |
08bbc9da AN |
96 | }; |
97 | ||
98 | DEFINE_GUEST_HANDLE_STRUCT(xen_memory_exchange); | |
a42089dd JF |
99 | /* |
100 | * Returns the maximum machine frame number of mapped RAM in this system. | |
101 | * This command always succeeds (it never returns an error code). | |
102 | * arg == NULL. | |
103 | */ | |
104 | #define XENMEM_maximum_ram_page 2 | |
105 | ||
106 | /* | |
107 | * Returns the current or maximum memory reservation, in pages, of the | |
108 | * specified domain (may be DOMID_SELF). Returns -ve errcode on failure. | |
109 | * arg == addr of domid_t. | |
110 | */ | |
111 | #define XENMEM_current_reservation 3 | |
112 | #define XENMEM_maximum_reservation 4 | |
113 | ||
114 | /* | |
115 | * Returns a list of MFN bases of 2MB extents comprising the machine_to_phys | |
116 | * mapping table. Architectures which do not have a m2p table do not implement | |
117 | * this command. | |
118 | * arg == addr of xen_machphys_mfn_list_t. | |
119 | */ | |
120 | #define XENMEM_machphys_mfn_list 5 | |
121 | struct xen_machphys_mfn_list { | |
122 | /* | |
123 | * Size of the 'extent_start' array. Fewer entries will be filled if the | |
124 | * machphys table is smaller than max_extents * 2MB. | |
125 | */ | |
126 | unsigned int max_extents; | |
127 | ||
128 | /* | |
129 | * Pointer to buffer to fill with list of extent starts. If there are | |
130 | * any large discontiguities in the machine address space, 2MB gaps in | |
131 | * the machphys table will be represented by an MFN base of zero. | |
132 | */ | |
bd3f79b7 | 133 | GUEST_HANDLE(xen_pfn_t) extent_start; |
a42089dd JF |
134 | |
135 | /* | |
136 | * Number of extents written to the above array. This will be smaller | |
137 | * than 'max_extents' if the machphys table is smaller than max_e * 2MB. | |
138 | */ | |
139 | unsigned int nr_extents; | |
140 | }; | |
bfdab126 | 141 | DEFINE_GUEST_HANDLE_STRUCT(xen_machphys_mfn_list); |
a42089dd | 142 | |
7e77506a IC |
143 | /* |
144 | * Returns the location in virtual address space of the machine_to_phys | |
145 | * mapping table. Architectures which do not have a m2p table, or which do not | |
146 | * map it by default into guest address space, do not implement this command. | |
147 | * arg == addr of xen_machphys_mapping_t. | |
148 | */ | |
149 | #define XENMEM_machphys_mapping 12 | |
150 | struct xen_machphys_mapping { | |
256f631f SS |
151 | xen_ulong_t v_start, v_end; /* Start and end virtual addresses. */ |
152 | xen_ulong_t max_mfn; /* Maximum MFN that can be looked up. */ | |
7e77506a IC |
153 | }; |
154 | DEFINE_GUEST_HANDLE_STRUCT(xen_machphys_mapping_t); | |
155 | ||
f832da06 IC |
156 | #define XENMAPSPACE_shared_info 0 /* shared info page */ |
157 | #define XENMAPSPACE_grant_table 1 /* grant table page */ | |
158 | #define XENMAPSPACE_gmfn 2 /* GMFN */ | |
159 | #define XENMAPSPACE_gmfn_range 3 /* GMFN range, XENMEM_add_to_physmap only. */ | |
160 | #define XENMAPSPACE_gmfn_foreign 4 /* GMFN from another dom, | |
161 | * XENMEM_add_to_physmap_range only. | |
162 | */ | |
712a5b77 | 163 | #define XENMAPSPACE_dev_mmio 5 /* device mmio region */ |
f832da06 | 164 | |
a42089dd JF |
165 | /* |
166 | * Sets the GPFN at which a particular page appears in the specified guest's | |
167 | * pseudophysical address space. | |
168 | * arg == addr of xen_add_to_physmap_t. | |
169 | */ | |
170 | #define XENMEM_add_to_physmap 7 | |
171 | struct xen_add_to_physmap { | |
172 | /* Which domain to change the mapping for. */ | |
173 | domid_t domid; | |
b58aaa4b SS |
174 | |
175 | /* Number of pages to go through for gmfn_range */ | |
176 | uint16_t size; | |
a42089dd JF |
177 | |
178 | /* Source mapping space. */ | |
a42089dd JF |
179 | unsigned int space; |
180 | ||
181 | /* Index into source mapping space. */ | |
256f631f | 182 | xen_ulong_t idx; |
a42089dd JF |
183 | |
184 | /* GPFN where the source mapping page should appear. */ | |
bd3f79b7 | 185 | xen_pfn_t gpfn; |
a42089dd | 186 | }; |
bfdab126 | 187 | DEFINE_GUEST_HANDLE_STRUCT(xen_add_to_physmap); |
a42089dd | 188 | |
e84fe8a1 IC |
189 | /*** REMOVED ***/ |
190 | /*#define XENMEM_translate_gpfn_list 8*/ | |
a42089dd | 191 | |
f832da06 IC |
192 | #define XENMEM_add_to_physmap_range 23 |
193 | struct xen_add_to_physmap_range { | |
07d0c943 | 194 | /* IN */ |
f832da06 IC |
195 | /* Which domain to change the mapping for. */ |
196 | domid_t domid; | |
197 | uint16_t space; /* => enum phys_map_space */ | |
198 | ||
199 | /* Number of pages to go through */ | |
200 | uint16_t size; | |
201 | domid_t foreign_domid; /* IFF gmfn_foreign */ | |
202 | ||
203 | /* Indexes into space being mapped. */ | |
204 | GUEST_HANDLE(xen_ulong_t) idxs; | |
205 | ||
206 | /* GPFN in domid where the source mapping page should appear. */ | |
207 | GUEST_HANDLE(xen_pfn_t) gpfns; | |
07d0c943 IC |
208 | |
209 | /* OUT */ | |
210 | ||
211 | /* Per index error code. */ | |
212 | GUEST_HANDLE(int) errs; | |
f832da06 IC |
213 | }; |
214 | DEFINE_GUEST_HANDLE_STRUCT(xen_add_to_physmap_range); | |
215 | ||
35ae11fd IC |
216 | /* |
217 | * Returns the pseudo-physical memory map as it was when the domain | |
218 | * was started (specified by XENMEM_set_memory_map). | |
219 | * arg == addr of struct xen_memory_map. | |
220 | */ | |
221 | #define XENMEM_memory_map 9 | |
222 | struct xen_memory_map { | |
223 | /* | |
224 | * On call the number of entries which can be stored in buffer. On | |
225 | * return the number of entries which have been stored in | |
226 | * buffer. | |
227 | */ | |
228 | unsigned int nr_entries; | |
229 | ||
230 | /* | |
231 | * Entries in the buffer are in the same format as returned by the | |
232 | * BIOS INT 0x15 EAX=0xE820 call. | |
233 | */ | |
234 | GUEST_HANDLE(void) buffer; | |
235 | }; | |
236 | DEFINE_GUEST_HANDLE_STRUCT(xen_memory_map); | |
237 | ||
238 | /* | |
239 | * Returns the real physical memory map. Passes the same structure as | |
240 | * XENMEM_memory_map. | |
241 | * arg == addr of struct xen_memory_map. | |
242 | */ | |
243 | #define XENMEM_machine_memory_map 10 | |
244 | ||
19001c8c AN |
245 | |
246 | /* | |
247 | * Prevent the balloon driver from changing the memory reservation | |
248 | * during a driver critical region. | |
249 | */ | |
250 | extern spinlock_t xen_reservation_lock; | |
f832da06 IC |
251 | |
252 | /* | |
253 | * Unmaps the page appearing at a particular GPFN from the specified guest's | |
254 | * pseudophysical address space. | |
255 | * arg == addr of xen_remove_from_physmap_t. | |
256 | */ | |
257 | #define XENMEM_remove_from_physmap 15 | |
258 | struct xen_remove_from_physmap { | |
259 | /* Which domain to change the mapping for. */ | |
260 | domid_t domid; | |
261 | ||
262 | /* GPFN of the current mapping of the page. */ | |
263 | xen_pfn_t gpfn; | |
264 | }; | |
265 | DEFINE_GUEST_HANDLE_STRUCT(xen_remove_from_physmap); | |
266 | ||
a42089dd | 267 | #endif /* __XEN_PUBLIC_MEMORY_H__ */ |