2 * Memory Device Interface
4 * Copyright ProfitBricks GmbH 2012
5 * Copyright (C) 2014 Red Hat Inc
6 * Copyright (c) 2018 Red Hat Inc
8 * This work is licensed under the terms of the GNU GPL, version 2 or later.
9 * See the COPYING file in the top-level directory.
12 #include "qemu/osdep.h"
13 #include "hw/mem/memory-device.h"
14 #include "qapi/error.h"
15 #include "hw/boards.h"
16 #include "qemu/range.h"
17 #include "hw/virtio/vhost.h"
18 #include "sysemu/kvm.h"
21 static gint memory_device_addr_sort(gconstpointer a, gconstpointer b)
23 const MemoryDeviceState *md_a = MEMORY_DEVICE(a);
24 const MemoryDeviceState *md_b = MEMORY_DEVICE(b);
25 const MemoryDeviceClass *mdc_a = MEMORY_DEVICE_GET_CLASS(a);
26 const MemoryDeviceClass *mdc_b = MEMORY_DEVICE_GET_CLASS(b);
27 const uint64_t addr_a = mdc_a->get_addr(md_a);
28 const uint64_t addr_b = mdc_b->get_addr(md_b);
30 if (addr_a > addr_b) {
32 } else if (addr_a < addr_b) {
38 static int memory_device_build_list(Object *obj, void *opaque)
40 GSList **list = opaque;
42 if (object_dynamic_cast(obj, TYPE_MEMORY_DEVICE)) {
43 DeviceState *dev = DEVICE(obj);
44 if (dev->realized) { /* only realized memory devices matter */
45 *list = g_slist_insert_sorted(*list, dev, memory_device_addr_sort);
49 object_child_foreach(obj, memory_device_build_list, opaque);
53 static int memory_device_used_region_size(Object *obj, void *opaque)
55 uint64_t *size = opaque;
57 if (object_dynamic_cast(obj, TYPE_MEMORY_DEVICE)) {
58 const DeviceState *dev = DEVICE(obj);
59 const MemoryDeviceState *md = MEMORY_DEVICE(obj);
62 *size += memory_device_get_region_size(md, &error_abort);
66 object_child_foreach(obj, memory_device_used_region_size, opaque);
70 static void memory_device_check_addable(MachineState *ms, uint64_t size,
73 uint64_t used_region_size = 0;
75 /* we will need a new memory slot for kvm and vhost */
76 if (kvm_enabled() && !kvm_has_free_slot(ms)) {
77 error_setg(errp, "hypervisor has no free memory slots left");
80 if (!vhost_has_free_slot()) {
81 error_setg(errp, "a used vhost backend has no free memory slots left");
85 /* will we exceed the total amount of memory specified */
86 memory_device_used_region_size(OBJECT(ms), &used_region_size);
87 if (used_region_size + size < used_region_size ||
88 used_region_size + size > ms->maxram_size - ms->ram_size) {
89 error_setg(errp, "not enough space, currently 0x%" PRIx64
90 " in use of total space for memory devices 0x" RAM_ADDR_FMT,
91 used_region_size, ms->maxram_size - ms->ram_size);
97 static uint64_t memory_device_get_free_addr(MachineState *ms,
99 uint64_t align, uint64_t size,
102 GSList *list = NULL, *item;
103 Range as, new = range_empty;
105 if (!ms->device_memory) {
106 error_setg(errp, "memory devices (e.g. for memory hotplug) are not "
107 "supported by the machine");
111 if (!memory_region_size(&ms->device_memory->mr)) {
112 error_setg(errp, "memory devices (e.g. for memory hotplug) are not "
113 "enabled, please specify the maxmem option");
116 range_init_nofail(&as, ms->device_memory->base,
117 memory_region_size(&ms->device_memory->mr));
119 /* start of address space indicates the maximum alignment we expect */
120 if (!QEMU_IS_ALIGNED(range_lob(&as), align)) {
121 error_setg(errp, "the alignment (0x%" PRIx64 ") is not supported",
126 memory_device_check_addable(ms, size, errp);
131 if (hint && !QEMU_IS_ALIGNED(*hint, align)) {
132 error_setg(errp, "address must be aligned to 0x%" PRIx64 " bytes",
137 if (!QEMU_IS_ALIGNED(size, align)) {
138 error_setg(errp, "backend memory size must be multiple of 0x%"
144 if (range_init(&new, *hint, size) || !range_contains_range(&as, &new)) {
145 error_setg(errp, "can't add memory device [0x%" PRIx64 ":0x%" PRIx64
146 "], usable range for memory devices [0x%" PRIx64 ":0x%"
147 PRIx64 "]", *hint, size, range_lob(&as),
152 if (range_init(&new, range_lob(&as), size)) {
153 error_setg(errp, "can't add memory device, device too big");
158 /* find address range that will fit new memory device */
159 object_child_foreach(OBJECT(ms), memory_device_build_list, &list);
160 for (item = list; item; item = g_slist_next(item)) {
161 const MemoryDeviceState *md = item->data;
162 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(OBJECT(md));
166 range_init_nofail(&tmp, mdc->get_addr(md),
167 memory_device_get_region_size(md, &error_abort));
169 if (range_overlaps_range(&tmp, &new)) {
171 const DeviceState *d = DEVICE(md);
172 error_setg(errp, "address range conflicts with memory device"
173 " id='%s'", d->id ? d->id : "(unnamed)");
177 next_addr = QEMU_ALIGN_UP(range_upb(&tmp) + 1, align);
178 if (!next_addr || range_init(&new, next_addr, range_size(&new))) {
179 range_make_empty(&new);
185 if (!range_contains_range(&as, &new)) {
186 error_setg(errp, "could not find position in guest address space for "
187 "memory device - memory fragmented due to alignments");
192 return range_lob(&new);
195 MemoryDeviceInfoList *qmp_memory_device_list(void)
197 GSList *devices = NULL, *item;
198 MemoryDeviceInfoList *list = NULL, *prev = NULL;
200 object_child_foreach(qdev_get_machine(), memory_device_build_list,
203 for (item = devices; item; item = g_slist_next(item)) {
204 const MemoryDeviceState *md = MEMORY_DEVICE(item->data);
205 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(item->data);
206 MemoryDeviceInfoList *elem = g_new0(MemoryDeviceInfoList, 1);
207 MemoryDeviceInfo *info = g_new0(MemoryDeviceInfo, 1);
209 mdc->fill_device_info(md, info);
221 g_slist_free(devices);
226 static int memory_device_plugged_size(Object *obj, void *opaque)
228 uint64_t *size = opaque;
230 if (object_dynamic_cast(obj, TYPE_MEMORY_DEVICE)) {
231 const DeviceState *dev = DEVICE(obj);
232 const MemoryDeviceState *md = MEMORY_DEVICE(obj);
233 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(obj);
236 *size += mdc->get_plugged_size(md, &error_abort);
240 object_child_foreach(obj, memory_device_plugged_size, opaque);
244 uint64_t get_plugged_memory_size(void)
248 memory_device_plugged_size(qdev_get_machine(), &size);
253 void memory_device_pre_plug(MemoryDeviceState *md, MachineState *ms,
254 const uint64_t *legacy_align, Error **errp)
256 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(md);
257 Error *local_err = NULL;
258 uint64_t addr, align;
261 mr = mdc->get_memory_region(md, &local_err);
266 align = legacy_align ? *legacy_align : memory_region_get_alignment(mr);
267 addr = mdc->get_addr(md);
268 addr = memory_device_get_free_addr(ms, !addr ? NULL : &addr, align,
269 memory_region_size(mr), &local_err);
273 mdc->set_addr(md, addr, &local_err);
275 trace_memory_device_pre_plug(DEVICE(md)->id ? DEVICE(md)->id : "",
279 error_propagate(errp, local_err);
282 void memory_device_plug(MemoryDeviceState *md, MachineState *ms)
284 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(md);
285 const uint64_t addr = mdc->get_addr(md);
289 * We expect that a previous call to memory_device_pre_plug() succeeded, so
290 * it can't fail at this point.
292 mr = mdc->get_memory_region(md, &error_abort);
293 g_assert(ms->device_memory);
295 memory_region_add_subregion(&ms->device_memory->mr,
296 addr - ms->device_memory->base, mr);
297 trace_memory_device_plug(DEVICE(md)->id ? DEVICE(md)->id : "", addr);
300 void memory_device_unplug(MemoryDeviceState *md, MachineState *ms)
302 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(md);
306 * We expect that a previous call to memory_device_pre_plug() succeeded, so
307 * it can't fail at this point.
309 mr = mdc->get_memory_region(md, &error_abort);
310 g_assert(ms->device_memory);
312 memory_region_del_subregion(&ms->device_memory->mr, mr);
313 trace_memory_device_unplug(DEVICE(md)->id ? DEVICE(md)->id : "",
317 uint64_t memory_device_get_region_size(const MemoryDeviceState *md,
320 const MemoryDeviceClass *mdc = MEMORY_DEVICE_GET_CLASS(md);
323 /* dropping const here is fine as we don't touch the memory region */
324 mr = mdc->get_memory_region((MemoryDeviceState *)md, errp);
329 return memory_region_size(mr);
332 static const TypeInfo memory_device_info = {
333 .name = TYPE_MEMORY_DEVICE,
334 .parent = TYPE_INTERFACE,
335 .class_size = sizeof(MemoryDeviceClass),
338 static void memory_device_register_types(void)
340 type_register_static(&memory_device_info);
343 type_init(memory_device_register_types)