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