xref: /qemu/hw/core/machine.c (revision 2b52619994ab48504c5fc0d32a1af24159405ce0)
1 /*
2  * QEMU Machine
3  *
4  * Copyright (C) 2014 Red Hat Inc
5  *
6  * Authors:
7  *   Marcel Apfelbaum <marcel.a@redhat.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2 or later.
10  * See the COPYING file in the top-level directory.
11  */
12 
13 #include "qemu/osdep.h"
14 #include "qemu/option.h"
15 #include "qapi/qmp/qerror.h"
16 #include "sysemu/replay.h"
17 #include "qemu/units.h"
18 #include "hw/boards.h"
19 #include "hw/loader.h"
20 #include "qapi/error.h"
21 #include "qapi/qapi-visit-common.h"
22 #include "qapi/qapi-visit-machine.h"
23 #include "qapi/visitor.h"
24 #include "hw/sysbus.h"
25 #include "sysemu/cpus.h"
26 #include "sysemu/sysemu.h"
27 #include "sysemu/reset.h"
28 #include "sysemu/runstate.h"
29 #include "sysemu/numa.h"
30 #include "qemu/error-report.h"
31 #include "sysemu/qtest.h"
32 #include "hw/pci/pci.h"
33 #include "hw/mem/nvdimm.h"
34 #include "migration/global_state.h"
35 #include "migration/vmstate.h"
36 #include "exec/confidential-guest-support.h"
37 #include "hw/virtio/virtio.h"
38 #include "hw/virtio/virtio-pci.h"
39 
40 GlobalProperty hw_compat_6_1[] = {};
41 const size_t hw_compat_6_1_len = G_N_ELEMENTS(hw_compat_6_1);
42 
43 GlobalProperty hw_compat_6_0[] = {
44     { "gpex-pcihost", "allow-unmapped-accesses", "false" },
45     { "i8042", "extended-state", "false"},
46     { "nvme-ns", "eui64-default", "off"},
47     { "e1000", "init-vet", "off" },
48     { "e1000e", "init-vet", "off" },
49 };
50 const size_t hw_compat_6_0_len = G_N_ELEMENTS(hw_compat_6_0);
51 
52 GlobalProperty hw_compat_5_2[] = {
53     { "ICH9-LPC", "smm-compat", "on"},
54     { "PIIX4_PM", "smm-compat", "on"},
55     { "virtio-blk-device", "report-discard-granularity", "off" },
56     { "virtio-net-pci", "vectors", "3"},
57 };
58 const size_t hw_compat_5_2_len = G_N_ELEMENTS(hw_compat_5_2);
59 
60 GlobalProperty hw_compat_5_1[] = {
61     { "vhost-scsi", "num_queues", "1"},
62     { "vhost-user-blk", "num-queues", "1"},
63     { "vhost-user-scsi", "num_queues", "1"},
64     { "virtio-blk-device", "num-queues", "1"},
65     { "virtio-scsi-device", "num_queues", "1"},
66     { "nvme", "use-intel-id", "on"},
67     { "pvpanic", "events", "1"}, /* PVPANIC_PANICKED */
68     { "pl011", "migrate-clk", "off" },
69     { "virtio-pci", "x-ats-page-aligned", "off"},
70 };
71 const size_t hw_compat_5_1_len = G_N_ELEMENTS(hw_compat_5_1);
72 
73 GlobalProperty hw_compat_5_0[] = {
74     { "pci-host-bridge", "x-config-reg-migration-enabled", "off" },
75     { "virtio-balloon-device", "page-poison", "false" },
76     { "vmport", "x-read-set-eax", "off" },
77     { "vmport", "x-signal-unsupported-cmd", "off" },
78     { "vmport", "x-report-vmx-type", "off" },
79     { "vmport", "x-cmds-v2", "off" },
80     { "virtio-device", "x-disable-legacy-check", "true" },
81 };
82 const size_t hw_compat_5_0_len = G_N_ELEMENTS(hw_compat_5_0);
83 
84 GlobalProperty hw_compat_4_2[] = {
85     { "virtio-blk-device", "queue-size", "128"},
86     { "virtio-scsi-device", "virtqueue_size", "128"},
87     { "virtio-blk-device", "x-enable-wce-if-config-wce", "off" },
88     { "virtio-blk-device", "seg-max-adjust", "off"},
89     { "virtio-scsi-device", "seg_max_adjust", "off"},
90     { "vhost-blk-device", "seg_max_adjust", "off"},
91     { "usb-host", "suppress-remote-wake", "off" },
92     { "usb-redir", "suppress-remote-wake", "off" },
93     { "qxl", "revision", "4" },
94     { "qxl-vga", "revision", "4" },
95     { "fw_cfg", "acpi-mr-restore", "false" },
96     { "virtio-device", "use-disabled-flag", "false" },
97 };
98 const size_t hw_compat_4_2_len = G_N_ELEMENTS(hw_compat_4_2);
99 
100 GlobalProperty hw_compat_4_1[] = {
101     { "virtio-pci", "x-pcie-flr-init", "off" },
102 };
103 const size_t hw_compat_4_1_len = G_N_ELEMENTS(hw_compat_4_1);
104 
105 GlobalProperty hw_compat_4_0[] = {
106     { "VGA",            "edid", "false" },
107     { "secondary-vga",  "edid", "false" },
108     { "bochs-display",  "edid", "false" },
109     { "virtio-vga",     "edid", "false" },
110     { "virtio-gpu-device", "edid", "false" },
111     { "virtio-device", "use-started", "false" },
112     { "virtio-balloon-device", "qemu-4-0-config-size", "true" },
113     { "pl031", "migrate-tick-offset", "false" },
114 };
115 const size_t hw_compat_4_0_len = G_N_ELEMENTS(hw_compat_4_0);
116 
117 GlobalProperty hw_compat_3_1[] = {
118     { "pcie-root-port", "x-speed", "2_5" },
119     { "pcie-root-port", "x-width", "1" },
120     { "memory-backend-file", "x-use-canonical-path-for-ramblock-id", "true" },
121     { "memory-backend-memfd", "x-use-canonical-path-for-ramblock-id", "true" },
122     { "tpm-crb", "ppi", "false" },
123     { "tpm-tis", "ppi", "false" },
124     { "usb-kbd", "serial", "42" },
125     { "usb-mouse", "serial", "42" },
126     { "usb-tablet", "serial", "42" },
127     { "virtio-blk-device", "discard", "false" },
128     { "virtio-blk-device", "write-zeroes", "false" },
129     { "virtio-balloon-device", "qemu-4-0-config-size", "false" },
130     { "pcie-root-port-base", "disable-acs", "true" }, /* Added in 4.1 */
131 };
132 const size_t hw_compat_3_1_len = G_N_ELEMENTS(hw_compat_3_1);
133 
134 GlobalProperty hw_compat_3_0[] = {};
135 const size_t hw_compat_3_0_len = G_N_ELEMENTS(hw_compat_3_0);
136 
137 GlobalProperty hw_compat_2_12[] = {
138     { "migration", "decompress-error-check", "off" },
139     { "hda-audio", "use-timer", "false" },
140     { "cirrus-vga", "global-vmstate", "true" },
141     { "VGA", "global-vmstate", "true" },
142     { "vmware-svga", "global-vmstate", "true" },
143     { "qxl-vga", "global-vmstate", "true" },
144 };
145 const size_t hw_compat_2_12_len = G_N_ELEMENTS(hw_compat_2_12);
146 
147 GlobalProperty hw_compat_2_11[] = {
148     { "hpet", "hpet-offset-saved", "false" },
149     { "virtio-blk-pci", "vectors", "2" },
150     { "vhost-user-blk-pci", "vectors", "2" },
151     { "e1000", "migrate_tso_props", "off" },
152 };
153 const size_t hw_compat_2_11_len = G_N_ELEMENTS(hw_compat_2_11);
154 
155 GlobalProperty hw_compat_2_10[] = {
156     { "virtio-mouse-device", "wheel-axis", "false" },
157     { "virtio-tablet-device", "wheel-axis", "false" },
158 };
159 const size_t hw_compat_2_10_len = G_N_ELEMENTS(hw_compat_2_10);
160 
161 GlobalProperty hw_compat_2_9[] = {
162     { "pci-bridge", "shpc", "off" },
163     { "intel-iommu", "pt", "off" },
164     { "virtio-net-device", "x-mtu-bypass-backend", "off" },
165     { "pcie-root-port", "x-migrate-msix", "false" },
166 };
167 const size_t hw_compat_2_9_len = G_N_ELEMENTS(hw_compat_2_9);
168 
169 GlobalProperty hw_compat_2_8[] = {
170     { "fw_cfg_mem", "x-file-slots", "0x10" },
171     { "fw_cfg_io", "x-file-slots", "0x10" },
172     { "pflash_cfi01", "old-multiple-chip-handling", "on" },
173     { "pci-bridge", "shpc", "on" },
174     { TYPE_PCI_DEVICE, "x-pcie-extcap-init", "off" },
175     { "virtio-pci", "x-pcie-deverr-init", "off" },
176     { "virtio-pci", "x-pcie-lnkctl-init", "off" },
177     { "virtio-pci", "x-pcie-pm-init", "off" },
178     { "cirrus-vga", "vgamem_mb", "8" },
179     { "isa-cirrus-vga", "vgamem_mb", "8" },
180 };
181 const size_t hw_compat_2_8_len = G_N_ELEMENTS(hw_compat_2_8);
182 
183 GlobalProperty hw_compat_2_7[] = {
184     { "virtio-pci", "page-per-vq", "on" },
185     { "virtio-serial-device", "emergency-write", "off" },
186     { "ioapic", "version", "0x11" },
187     { "intel-iommu", "x-buggy-eim", "true" },
188     { "virtio-pci", "x-ignore-backend-features", "on" },
189 };
190 const size_t hw_compat_2_7_len = G_N_ELEMENTS(hw_compat_2_7);
191 
192 GlobalProperty hw_compat_2_6[] = {
193     { "virtio-mmio", "format_transport_address", "off" },
194     /* Optional because not all virtio-pci devices support legacy mode */
195     { "virtio-pci", "disable-modern", "on",  .optional = true },
196     { "virtio-pci", "disable-legacy", "off", .optional = true },
197 };
198 const size_t hw_compat_2_6_len = G_N_ELEMENTS(hw_compat_2_6);
199 
200 GlobalProperty hw_compat_2_5[] = {
201     { "isa-fdc", "fallback", "144" },
202     { "pvscsi", "x-old-pci-configuration", "on" },
203     { "pvscsi", "x-disable-pcie", "on" },
204     { "vmxnet3", "x-old-msi-offsets", "on" },
205     { "vmxnet3", "x-disable-pcie", "on" },
206 };
207 const size_t hw_compat_2_5_len = G_N_ELEMENTS(hw_compat_2_5);
208 
209 GlobalProperty hw_compat_2_4[] = {
210     /* Optional because the 'scsi' property is Linux-only */
211     { "virtio-blk-device", "scsi", "true", .optional = true },
212     { "e1000", "extra_mac_registers", "off" },
213     { "virtio-pci", "x-disable-pcie", "on" },
214     { "virtio-pci", "migrate-extra", "off" },
215     { "fw_cfg_mem", "dma_enabled", "off" },
216     { "fw_cfg_io", "dma_enabled", "off" }
217 };
218 const size_t hw_compat_2_4_len = G_N_ELEMENTS(hw_compat_2_4);
219 
220 GlobalProperty hw_compat_2_3[] = {
221     { "virtio-blk-pci", "any_layout", "off" },
222     { "virtio-balloon-pci", "any_layout", "off" },
223     { "virtio-serial-pci", "any_layout", "off" },
224     { "virtio-9p-pci", "any_layout", "off" },
225     { "virtio-rng-pci", "any_layout", "off" },
226     { TYPE_PCI_DEVICE, "x-pcie-lnksta-dllla", "off" },
227     { "migration", "send-configuration", "off" },
228     { "migration", "send-section-footer", "off" },
229     { "migration", "store-global-state", "off" },
230 };
231 const size_t hw_compat_2_3_len = G_N_ELEMENTS(hw_compat_2_3);
232 
233 GlobalProperty hw_compat_2_2[] = {};
234 const size_t hw_compat_2_2_len = G_N_ELEMENTS(hw_compat_2_2);
235 
236 GlobalProperty hw_compat_2_1[] = {
237     { "intel-hda", "old_msi_addr", "on" },
238     { "VGA", "qemu-extended-regs", "off" },
239     { "secondary-vga", "qemu-extended-regs", "off" },
240     { "virtio-scsi-pci", "any_layout", "off" },
241     { "usb-mouse", "usb_version", "1" },
242     { "usb-kbd", "usb_version", "1" },
243     { "virtio-pci", "virtio-pci-bus-master-bug-migration", "on" },
244 };
245 const size_t hw_compat_2_1_len = G_N_ELEMENTS(hw_compat_2_1);
246 
247 MachineState *current_machine;
248 
249 static char *machine_get_kernel(Object *obj, Error **errp)
250 {
251     MachineState *ms = MACHINE(obj);
252 
253     return g_strdup(ms->kernel_filename);
254 }
255 
256 static void machine_set_kernel(Object *obj, const char *value, Error **errp)
257 {
258     MachineState *ms = MACHINE(obj);
259 
260     g_free(ms->kernel_filename);
261     ms->kernel_filename = g_strdup(value);
262 }
263 
264 static char *machine_get_initrd(Object *obj, Error **errp)
265 {
266     MachineState *ms = MACHINE(obj);
267 
268     return g_strdup(ms->initrd_filename);
269 }
270 
271 static void machine_set_initrd(Object *obj, const char *value, Error **errp)
272 {
273     MachineState *ms = MACHINE(obj);
274 
275     g_free(ms->initrd_filename);
276     ms->initrd_filename = g_strdup(value);
277 }
278 
279 static char *machine_get_append(Object *obj, Error **errp)
280 {
281     MachineState *ms = MACHINE(obj);
282 
283     return g_strdup(ms->kernel_cmdline);
284 }
285 
286 static void machine_set_append(Object *obj, const char *value, Error **errp)
287 {
288     MachineState *ms = MACHINE(obj);
289 
290     g_free(ms->kernel_cmdline);
291     ms->kernel_cmdline = g_strdup(value);
292 }
293 
294 static char *machine_get_dtb(Object *obj, Error **errp)
295 {
296     MachineState *ms = MACHINE(obj);
297 
298     return g_strdup(ms->dtb);
299 }
300 
301 static void machine_set_dtb(Object *obj, const char *value, Error **errp)
302 {
303     MachineState *ms = MACHINE(obj);
304 
305     g_free(ms->dtb);
306     ms->dtb = g_strdup(value);
307 }
308 
309 static char *machine_get_dumpdtb(Object *obj, Error **errp)
310 {
311     MachineState *ms = MACHINE(obj);
312 
313     return g_strdup(ms->dumpdtb);
314 }
315 
316 static void machine_set_dumpdtb(Object *obj, const char *value, Error **errp)
317 {
318     MachineState *ms = MACHINE(obj);
319 
320     g_free(ms->dumpdtb);
321     ms->dumpdtb = g_strdup(value);
322 }
323 
324 static void machine_get_phandle_start(Object *obj, Visitor *v,
325                                       const char *name, void *opaque,
326                                       Error **errp)
327 {
328     MachineState *ms = MACHINE(obj);
329     int64_t value = ms->phandle_start;
330 
331     visit_type_int(v, name, &value, errp);
332 }
333 
334 static void machine_set_phandle_start(Object *obj, Visitor *v,
335                                       const char *name, void *opaque,
336                                       Error **errp)
337 {
338     MachineState *ms = MACHINE(obj);
339     int64_t value;
340 
341     if (!visit_type_int(v, name, &value, errp)) {
342         return;
343     }
344 
345     ms->phandle_start = value;
346 }
347 
348 static char *machine_get_dt_compatible(Object *obj, Error **errp)
349 {
350     MachineState *ms = MACHINE(obj);
351 
352     return g_strdup(ms->dt_compatible);
353 }
354 
355 static void machine_set_dt_compatible(Object *obj, const char *value, Error **errp)
356 {
357     MachineState *ms = MACHINE(obj);
358 
359     g_free(ms->dt_compatible);
360     ms->dt_compatible = g_strdup(value);
361 }
362 
363 static bool machine_get_dump_guest_core(Object *obj, Error **errp)
364 {
365     MachineState *ms = MACHINE(obj);
366 
367     return ms->dump_guest_core;
368 }
369 
370 static void machine_set_dump_guest_core(Object *obj, bool value, Error **errp)
371 {
372     MachineState *ms = MACHINE(obj);
373 
374     ms->dump_guest_core = value;
375 }
376 
377 static bool machine_get_mem_merge(Object *obj, Error **errp)
378 {
379     MachineState *ms = MACHINE(obj);
380 
381     return ms->mem_merge;
382 }
383 
384 static void machine_set_mem_merge(Object *obj, bool value, Error **errp)
385 {
386     MachineState *ms = MACHINE(obj);
387 
388     ms->mem_merge = value;
389 }
390 
391 static bool machine_get_usb(Object *obj, Error **errp)
392 {
393     MachineState *ms = MACHINE(obj);
394 
395     return ms->usb;
396 }
397 
398 static void machine_set_usb(Object *obj, bool value, Error **errp)
399 {
400     MachineState *ms = MACHINE(obj);
401 
402     ms->usb = value;
403     ms->usb_disabled = !value;
404 }
405 
406 static bool machine_get_graphics(Object *obj, Error **errp)
407 {
408     MachineState *ms = MACHINE(obj);
409 
410     return ms->enable_graphics;
411 }
412 
413 static void machine_set_graphics(Object *obj, bool value, Error **errp)
414 {
415     MachineState *ms = MACHINE(obj);
416 
417     ms->enable_graphics = value;
418 }
419 
420 static char *machine_get_firmware(Object *obj, Error **errp)
421 {
422     MachineState *ms = MACHINE(obj);
423 
424     return g_strdup(ms->firmware);
425 }
426 
427 static void machine_set_firmware(Object *obj, const char *value, Error **errp)
428 {
429     MachineState *ms = MACHINE(obj);
430 
431     g_free(ms->firmware);
432     ms->firmware = g_strdup(value);
433 }
434 
435 static void machine_set_suppress_vmdesc(Object *obj, bool value, Error **errp)
436 {
437     MachineState *ms = MACHINE(obj);
438 
439     ms->suppress_vmdesc = value;
440 }
441 
442 static bool machine_get_suppress_vmdesc(Object *obj, Error **errp)
443 {
444     MachineState *ms = MACHINE(obj);
445 
446     return ms->suppress_vmdesc;
447 }
448 
449 static char *machine_get_memory_encryption(Object *obj, Error **errp)
450 {
451     MachineState *ms = MACHINE(obj);
452 
453     if (ms->cgs) {
454         return g_strdup(object_get_canonical_path_component(OBJECT(ms->cgs)));
455     }
456 
457     return NULL;
458 }
459 
460 static void machine_set_memory_encryption(Object *obj, const char *value,
461                                         Error **errp)
462 {
463     Object *cgs =
464         object_resolve_path_component(object_get_objects_root(), value);
465 
466     if (!cgs) {
467         error_setg(errp, "No such memory encryption object '%s'", value);
468         return;
469     }
470 
471     object_property_set_link(obj, "confidential-guest-support", cgs, errp);
472 }
473 
474 static void machine_check_confidential_guest_support(const Object *obj,
475                                                      const char *name,
476                                                      Object *new_target,
477                                                      Error **errp)
478 {
479     /*
480      * So far the only constraint is that the target has the
481      * TYPE_CONFIDENTIAL_GUEST_SUPPORT interface, and that's checked
482      * by the QOM core
483      */
484 }
485 
486 static bool machine_get_nvdimm(Object *obj, Error **errp)
487 {
488     MachineState *ms = MACHINE(obj);
489 
490     return ms->nvdimms_state->is_enabled;
491 }
492 
493 static void machine_set_nvdimm(Object *obj, bool value, Error **errp)
494 {
495     MachineState *ms = MACHINE(obj);
496 
497     ms->nvdimms_state->is_enabled = value;
498 }
499 
500 static bool machine_get_hmat(Object *obj, Error **errp)
501 {
502     MachineState *ms = MACHINE(obj);
503 
504     return ms->numa_state->hmat_enabled;
505 }
506 
507 static void machine_set_hmat(Object *obj, bool value, Error **errp)
508 {
509     MachineState *ms = MACHINE(obj);
510 
511     ms->numa_state->hmat_enabled = value;
512 }
513 
514 static char *machine_get_nvdimm_persistence(Object *obj, Error **errp)
515 {
516     MachineState *ms = MACHINE(obj);
517 
518     return g_strdup(ms->nvdimms_state->persistence_string);
519 }
520 
521 static void machine_set_nvdimm_persistence(Object *obj, const char *value,
522                                            Error **errp)
523 {
524     MachineState *ms = MACHINE(obj);
525     NVDIMMState *nvdimms_state = ms->nvdimms_state;
526 
527     if (strcmp(value, "cpu") == 0) {
528         nvdimms_state->persistence = 3;
529     } else if (strcmp(value, "mem-ctrl") == 0) {
530         nvdimms_state->persistence = 2;
531     } else {
532         error_setg(errp, "-machine nvdimm-persistence=%s: unsupported option",
533                    value);
534         return;
535     }
536 
537     g_free(nvdimms_state->persistence_string);
538     nvdimms_state->persistence_string = g_strdup(value);
539 }
540 
541 void machine_class_allow_dynamic_sysbus_dev(MachineClass *mc, const char *type)
542 {
543     QAPI_LIST_PREPEND(mc->allowed_dynamic_sysbus_devices, g_strdup(type));
544 }
545 
546 bool device_is_dynamic_sysbus(MachineClass *mc, DeviceState *dev)
547 {
548     bool allowed = false;
549     strList *wl;
550     Object *obj = OBJECT(dev);
551 
552     if (!object_dynamic_cast(obj, TYPE_SYS_BUS_DEVICE)) {
553         return false;
554     }
555 
556     for (wl = mc->allowed_dynamic_sysbus_devices;
557          !allowed && wl;
558          wl = wl->next) {
559         allowed |= !!object_dynamic_cast(obj, wl->value);
560     }
561 
562     return allowed;
563 }
564 
565 static void validate_sysbus_device(SysBusDevice *sbdev, void *opaque)
566 {
567     MachineState *machine = opaque;
568     MachineClass *mc = MACHINE_GET_CLASS(machine);
569 
570     if (!device_is_dynamic_sysbus(mc, DEVICE(sbdev))) {
571         error_report("Option '-device %s' cannot be handled by this machine",
572                      object_class_get_name(object_get_class(OBJECT(sbdev))));
573         exit(1);
574     }
575 }
576 
577 static char *machine_get_memdev(Object *obj, Error **errp)
578 {
579     MachineState *ms = MACHINE(obj);
580 
581     return g_strdup(ms->ram_memdev_id);
582 }
583 
584 static void machine_set_memdev(Object *obj, const char *value, Error **errp)
585 {
586     MachineState *ms = MACHINE(obj);
587 
588     g_free(ms->ram_memdev_id);
589     ms->ram_memdev_id = g_strdup(value);
590 }
591 
592 static void machine_init_notify(Notifier *notifier, void *data)
593 {
594     MachineState *machine = MACHINE(qdev_get_machine());
595 
596     /*
597      * Loop through all dynamically created sysbus devices and check if they are
598      * all allowed.  If a device is not allowed, error out.
599      */
600     foreach_dynamic_sysbus_device(validate_sysbus_device, machine);
601 }
602 
603 HotpluggableCPUList *machine_query_hotpluggable_cpus(MachineState *machine)
604 {
605     int i;
606     HotpluggableCPUList *head = NULL;
607     MachineClass *mc = MACHINE_GET_CLASS(machine);
608 
609     /* force board to initialize possible_cpus if it hasn't been done yet */
610     mc->possible_cpu_arch_ids(machine);
611 
612     for (i = 0; i < machine->possible_cpus->len; i++) {
613         Object *cpu;
614         HotpluggableCPU *cpu_item = g_new0(typeof(*cpu_item), 1);
615 
616         cpu_item->type = g_strdup(machine->possible_cpus->cpus[i].type);
617         cpu_item->vcpus_count = machine->possible_cpus->cpus[i].vcpus_count;
618         cpu_item->props = g_memdup(&machine->possible_cpus->cpus[i].props,
619                                    sizeof(*cpu_item->props));
620 
621         cpu = machine->possible_cpus->cpus[i].cpu;
622         if (cpu) {
623             cpu_item->has_qom_path = true;
624             cpu_item->qom_path = object_get_canonical_path(cpu);
625         }
626         QAPI_LIST_PREPEND(head, cpu_item);
627     }
628     return head;
629 }
630 
631 /**
632  * machine_set_cpu_numa_node:
633  * @machine: machine object to modify
634  * @props: specifies which cpu objects to assign to
635  *         numa node specified by @props.node_id
636  * @errp: if an error occurs, a pointer to an area to store the error
637  *
638  * Associate NUMA node specified by @props.node_id with cpu slots that
639  * match socket/core/thread-ids specified by @props. It's recommended to use
640  * query-hotpluggable-cpus.props values to specify affected cpu slots,
641  * which would lead to exact 1:1 mapping of cpu slots to NUMA node.
642  *
643  * However for CLI convenience it's possible to pass in subset of properties,
644  * which would affect all cpu slots that match it.
645  * Ex for pc machine:
646  *    -smp 4,cores=2,sockets=2 -numa node,nodeid=0 -numa node,nodeid=1 \
647  *    -numa cpu,node-id=0,socket_id=0 \
648  *    -numa cpu,node-id=1,socket_id=1
649  * will assign all child cores of socket 0 to node 0 and
650  * of socket 1 to node 1.
651  *
652  * On attempt of reassigning (already assigned) cpu slot to another NUMA node,
653  * return error.
654  * Empty subset is disallowed and function will return with error in this case.
655  */
656 void machine_set_cpu_numa_node(MachineState *machine,
657                                const CpuInstanceProperties *props, Error **errp)
658 {
659     MachineClass *mc = MACHINE_GET_CLASS(machine);
660     NodeInfo *numa_info = machine->numa_state->nodes;
661     bool match = false;
662     int i;
663 
664     if (!mc->possible_cpu_arch_ids) {
665         error_setg(errp, "mapping of CPUs to NUMA node is not supported");
666         return;
667     }
668 
669     /* disabling node mapping is not supported, forbid it */
670     assert(props->has_node_id);
671 
672     /* force board to initialize possible_cpus if it hasn't been done yet */
673     mc->possible_cpu_arch_ids(machine);
674 
675     for (i = 0; i < machine->possible_cpus->len; i++) {
676         CPUArchId *slot = &machine->possible_cpus->cpus[i];
677 
678         /* reject unsupported by board properties */
679         if (props->has_thread_id && !slot->props.has_thread_id) {
680             error_setg(errp, "thread-id is not supported");
681             return;
682         }
683 
684         if (props->has_core_id && !slot->props.has_core_id) {
685             error_setg(errp, "core-id is not supported");
686             return;
687         }
688 
689         if (props->has_socket_id && !slot->props.has_socket_id) {
690             error_setg(errp, "socket-id is not supported");
691             return;
692         }
693 
694         if (props->has_die_id && !slot->props.has_die_id) {
695             error_setg(errp, "die-id is not supported");
696             return;
697         }
698 
699         /* skip slots with explicit mismatch */
700         if (props->has_thread_id && props->thread_id != slot->props.thread_id) {
701                 continue;
702         }
703 
704         if (props->has_core_id && props->core_id != slot->props.core_id) {
705                 continue;
706         }
707 
708         if (props->has_die_id && props->die_id != slot->props.die_id) {
709                 continue;
710         }
711 
712         if (props->has_socket_id && props->socket_id != slot->props.socket_id) {
713                 continue;
714         }
715 
716         /* reject assignment if slot is already assigned, for compatibility
717          * of legacy cpu_index mapping with SPAPR core based mapping do not
718          * error out if cpu thread and matched core have the same node-id */
719         if (slot->props.has_node_id &&
720             slot->props.node_id != props->node_id) {
721             error_setg(errp, "CPU is already assigned to node-id: %" PRId64,
722                        slot->props.node_id);
723             return;
724         }
725 
726         /* assign slot to node as it's matched '-numa cpu' key */
727         match = true;
728         slot->props.node_id = props->node_id;
729         slot->props.has_node_id = props->has_node_id;
730 
731         if (machine->numa_state->hmat_enabled) {
732             if ((numa_info[props->node_id].initiator < MAX_NODES) &&
733                 (props->node_id != numa_info[props->node_id].initiator)) {
734                 error_setg(errp, "The initiator of CPU NUMA node %" PRId64
735                            " should be itself (got %" PRIu16 ")",
736                            props->node_id, numa_info[props->node_id].initiator);
737                 return;
738             }
739             numa_info[props->node_id].has_cpu = true;
740             numa_info[props->node_id].initiator = props->node_id;
741         }
742     }
743 
744     if (!match) {
745         error_setg(errp, "no match found");
746     }
747 }
748 
749 /*
750  * Report information of a machine's supported CPU topology hierarchy.
751  * Topology members will be ordered from the largest to the smallest
752  * in the string.
753  */
754 static char *cpu_hierarchy_to_string(MachineState *ms)
755 {
756     MachineClass *mc = MACHINE_GET_CLASS(ms);
757     GString *s = g_string_new(NULL);
758 
759     g_string_append_printf(s, "sockets (%u)", ms->smp.sockets);
760 
761     if (mc->smp_props.dies_supported) {
762         g_string_append_printf(s, " * dies (%u)", ms->smp.dies);
763     }
764 
765     g_string_append_printf(s, " * cores (%u)", ms->smp.cores);
766     g_string_append_printf(s, " * threads (%u)", ms->smp.threads);
767 
768     return g_string_free(s, false);
769 }
770 
771 /*
772  * smp_parse - Generic function used to parse the given SMP configuration
773  *
774  * Any missing parameter in "cpus/maxcpus/sockets/cores/threads" will be
775  * automatically computed based on the provided ones.
776  *
777  * In the calculation of omitted sockets/cores/threads: we prefer sockets
778  * over cores over threads before 6.2, while preferring cores over sockets
779  * over threads since 6.2.
780  *
781  * In the calculation of cpus/maxcpus: When both maxcpus and cpus are omitted,
782  * maxcpus will be computed from the given parameters and cpus will be set
783  * equal to maxcpus. When only one of maxcpus and cpus is given then the
784  * omitted one will be set to its given counterpart's value. Both maxcpus and
785  * cpus may be specified, but maxcpus must be equal to or greater than cpus.
786  *
787  * For compatibility, apart from the parameters that will be computed, newly
788  * introduced topology members which are likely to be target specific should
789  * be directly set as 1 if they are omitted (e.g. dies for PC since 4.1).
790  */
791 static void smp_parse(MachineState *ms, SMPConfiguration *config, Error **errp)
792 {
793     MachineClass *mc = MACHINE_GET_CLASS(ms);
794     unsigned cpus    = config->has_cpus ? config->cpus : 0;
795     unsigned sockets = config->has_sockets ? config->sockets : 0;
796     unsigned dies    = config->has_dies ? config->dies : 0;
797     unsigned cores   = config->has_cores ? config->cores : 0;
798     unsigned threads = config->has_threads ? config->threads : 0;
799     unsigned maxcpus = config->has_maxcpus ? config->maxcpus : 0;
800 
801     /*
802      * If not supported by the machine, a topology parameter must be
803      * omitted or specified equal to 1.
804      */
805     if (!mc->smp_props.dies_supported && dies > 1) {
806         error_setg(errp, "dies not supported by this machine's CPU topology");
807         return;
808     }
809 
810     dies = dies > 0 ? dies : 1;
811 
812     /* compute missing values based on the provided ones */
813     if (cpus == 0 && maxcpus == 0) {
814         sockets = sockets > 0 ? sockets : 1;
815         cores = cores > 0 ? cores : 1;
816         threads = threads > 0 ? threads : 1;
817     } else {
818         maxcpus = maxcpus > 0 ? maxcpus : cpus;
819 
820         if (mc->smp_props.prefer_sockets) {
821             /* prefer sockets over cores before 6.2 */
822             if (sockets == 0) {
823                 cores = cores > 0 ? cores : 1;
824                 threads = threads > 0 ? threads : 1;
825                 sockets = maxcpus / (dies * cores * threads);
826             } else if (cores == 0) {
827                 threads = threads > 0 ? threads : 1;
828                 cores = maxcpus / (sockets * dies * threads);
829             }
830         } else {
831             /* prefer cores over sockets since 6.2 */
832             if (cores == 0) {
833                 sockets = sockets > 0 ? sockets : 1;
834                 threads = threads > 0 ? threads : 1;
835                 cores = maxcpus / (sockets * dies * threads);
836             } else if (sockets == 0) {
837                 threads = threads > 0 ? threads : 1;
838                 sockets = maxcpus / (dies * cores * threads);
839             }
840         }
841 
842         /* try to calculate omitted threads at last */
843         if (threads == 0) {
844             threads = maxcpus / (sockets * dies * cores);
845         }
846     }
847 
848     maxcpus = maxcpus > 0 ? maxcpus : sockets * dies * cores * threads;
849     cpus = cpus > 0 ? cpus : maxcpus;
850 
851     ms->smp.cpus = cpus;
852     ms->smp.sockets = sockets;
853     ms->smp.dies = dies;
854     ms->smp.cores = cores;
855     ms->smp.threads = threads;
856     ms->smp.max_cpus = maxcpus;
857 
858     /* sanity-check of the computed topology */
859     if (sockets * dies * cores * threads != maxcpus) {
860         g_autofree char *topo_msg = cpu_hierarchy_to_string(ms);
861         error_setg(errp, "Invalid CPU topology: "
862                    "product of the hierarchy must match maxcpus: "
863                    "%s != maxcpus (%u)",
864                    topo_msg, maxcpus);
865         return;
866     }
867 
868     if (maxcpus < cpus) {
869         g_autofree char *topo_msg = cpu_hierarchy_to_string(ms);
870         error_setg(errp, "Invalid CPU topology: "
871                    "maxcpus must be equal to or greater than smp: "
872                    "%s == maxcpus (%u) < smp_cpus (%u)",
873                    topo_msg, maxcpus, cpus);
874         return;
875     }
876 }
877 
878 static void machine_get_smp(Object *obj, Visitor *v, const char *name,
879                             void *opaque, Error **errp)
880 {
881     MachineState *ms = MACHINE(obj);
882     SMPConfiguration *config = &(SMPConfiguration){
883         .has_cpus = true, .cpus = ms->smp.cpus,
884         .has_sockets = true, .sockets = ms->smp.sockets,
885         .has_dies = true, .dies = ms->smp.dies,
886         .has_cores = true, .cores = ms->smp.cores,
887         .has_threads = true, .threads = ms->smp.threads,
888         .has_maxcpus = true, .maxcpus = ms->smp.max_cpus,
889     };
890     if (!visit_type_SMPConfiguration(v, name, &config, &error_abort)) {
891         return;
892     }
893 }
894 
895 static void machine_set_smp(Object *obj, Visitor *v, const char *name,
896                             void *opaque, Error **errp)
897 {
898     MachineClass *mc = MACHINE_GET_CLASS(obj);
899     MachineState *ms = MACHINE(obj);
900     SMPConfiguration *config;
901     ERRP_GUARD();
902 
903     if (!visit_type_SMPConfiguration(v, name, &config, errp)) {
904         return;
905     }
906 
907     /*
908      * Specified CPU topology parameters must be greater than zero,
909      * explicit configuration like "cpus=0" is not allowed.
910      */
911     if ((config->has_cpus && config->cpus == 0) ||
912         (config->has_sockets && config->sockets == 0) ||
913         (config->has_dies && config->dies == 0) ||
914         (config->has_cores && config->cores == 0) ||
915         (config->has_threads && config->threads == 0) ||
916         (config->has_maxcpus && config->maxcpus == 0)) {
917         warn_report("Deprecated CPU topology (considered invalid): "
918                     "CPU topology parameters must be greater than zero");
919     }
920 
921     smp_parse(ms, config, errp);
922     if (*errp) {
923         goto out_free;
924     }
925 
926     /* sanity-check smp_cpus and max_cpus against mc */
927     if (ms->smp.cpus < mc->min_cpus) {
928         error_setg(errp, "Invalid SMP CPUs %d. The min CPUs "
929                    "supported by machine '%s' is %d",
930                    ms->smp.cpus,
931                    mc->name, mc->min_cpus);
932     } else if (ms->smp.max_cpus > mc->max_cpus) {
933         error_setg(errp, "Invalid SMP CPUs %d. The max CPUs "
934                    "supported by machine '%s' is %d",
935                    ms->smp.max_cpus,
936                    mc->name, mc->max_cpus);
937     }
938 
939 out_free:
940     qapi_free_SMPConfiguration(config);
941 }
942 
943 static void machine_class_init(ObjectClass *oc, void *data)
944 {
945     MachineClass *mc = MACHINE_CLASS(oc);
946 
947     /* Default 128 MB as guest ram size */
948     mc->default_ram_size = 128 * MiB;
949     mc->rom_file_has_mr = true;
950 
951     /* numa node memory size aligned on 8MB by default.
952      * On Linux, each node's border has to be 8MB aligned
953      */
954     mc->numa_mem_align_shift = 23;
955 
956     object_class_property_add_str(oc, "kernel",
957         machine_get_kernel, machine_set_kernel);
958     object_class_property_set_description(oc, "kernel",
959         "Linux kernel image file");
960 
961     object_class_property_add_str(oc, "initrd",
962         machine_get_initrd, machine_set_initrd);
963     object_class_property_set_description(oc, "initrd",
964         "Linux initial ramdisk file");
965 
966     object_class_property_add_str(oc, "append",
967         machine_get_append, machine_set_append);
968     object_class_property_set_description(oc, "append",
969         "Linux kernel command line");
970 
971     object_class_property_add_str(oc, "dtb",
972         machine_get_dtb, machine_set_dtb);
973     object_class_property_set_description(oc, "dtb",
974         "Linux kernel device tree file");
975 
976     object_class_property_add_str(oc, "dumpdtb",
977         machine_get_dumpdtb, machine_set_dumpdtb);
978     object_class_property_set_description(oc, "dumpdtb",
979         "Dump current dtb to a file and quit");
980 
981     object_class_property_add(oc, "smp", "SMPConfiguration",
982         machine_get_smp, machine_set_smp,
983         NULL, NULL);
984     object_class_property_set_description(oc, "smp",
985         "CPU topology");
986 
987     object_class_property_add(oc, "phandle-start", "int",
988         machine_get_phandle_start, machine_set_phandle_start,
989         NULL, NULL);
990     object_class_property_set_description(oc, "phandle-start",
991         "The first phandle ID we may generate dynamically");
992 
993     object_class_property_add_str(oc, "dt-compatible",
994         machine_get_dt_compatible, machine_set_dt_compatible);
995     object_class_property_set_description(oc, "dt-compatible",
996         "Overrides the \"compatible\" property of the dt root node");
997 
998     object_class_property_add_bool(oc, "dump-guest-core",
999         machine_get_dump_guest_core, machine_set_dump_guest_core);
1000     object_class_property_set_description(oc, "dump-guest-core",
1001         "Include guest memory in a core dump");
1002 
1003     object_class_property_add_bool(oc, "mem-merge",
1004         machine_get_mem_merge, machine_set_mem_merge);
1005     object_class_property_set_description(oc, "mem-merge",
1006         "Enable/disable memory merge support");
1007 
1008     object_class_property_add_bool(oc, "usb",
1009         machine_get_usb, machine_set_usb);
1010     object_class_property_set_description(oc, "usb",
1011         "Set on/off to enable/disable usb");
1012 
1013     object_class_property_add_bool(oc, "graphics",
1014         machine_get_graphics, machine_set_graphics);
1015     object_class_property_set_description(oc, "graphics",
1016         "Set on/off to enable/disable graphics emulation");
1017 
1018     object_class_property_add_str(oc, "firmware",
1019         machine_get_firmware, machine_set_firmware);
1020     object_class_property_set_description(oc, "firmware",
1021         "Firmware image");
1022 
1023     object_class_property_add_bool(oc, "suppress-vmdesc",
1024         machine_get_suppress_vmdesc, machine_set_suppress_vmdesc);
1025     object_class_property_set_description(oc, "suppress-vmdesc",
1026         "Set on to disable self-describing migration");
1027 
1028     object_class_property_add_link(oc, "confidential-guest-support",
1029                                    TYPE_CONFIDENTIAL_GUEST_SUPPORT,
1030                                    offsetof(MachineState, cgs),
1031                                    machine_check_confidential_guest_support,
1032                                    OBJ_PROP_LINK_STRONG);
1033     object_class_property_set_description(oc, "confidential-guest-support",
1034                                           "Set confidential guest scheme to support");
1035 
1036     /* For compatibility */
1037     object_class_property_add_str(oc, "memory-encryption",
1038         machine_get_memory_encryption, machine_set_memory_encryption);
1039     object_class_property_set_description(oc, "memory-encryption",
1040         "Set memory encryption object to use");
1041 
1042     object_class_property_add_str(oc, "memory-backend",
1043                                   machine_get_memdev, machine_set_memdev);
1044     object_class_property_set_description(oc, "memory-backend",
1045                                           "Set RAM backend"
1046                                           "Valid value is ID of hostmem based backend");
1047 }
1048 
1049 static void machine_class_base_init(ObjectClass *oc, void *data)
1050 {
1051     MachineClass *mc = MACHINE_CLASS(oc);
1052     mc->max_cpus = mc->max_cpus ?: 1;
1053     mc->min_cpus = mc->min_cpus ?: 1;
1054     mc->default_cpus = mc->default_cpus ?: 1;
1055 
1056     if (!object_class_is_abstract(oc)) {
1057         const char *cname = object_class_get_name(oc);
1058         assert(g_str_has_suffix(cname, TYPE_MACHINE_SUFFIX));
1059         mc->name = g_strndup(cname,
1060                             strlen(cname) - strlen(TYPE_MACHINE_SUFFIX));
1061         mc->compat_props = g_ptr_array_new();
1062     }
1063 }
1064 
1065 static void machine_initfn(Object *obj)
1066 {
1067     MachineState *ms = MACHINE(obj);
1068     MachineClass *mc = MACHINE_GET_CLASS(obj);
1069 
1070     container_get(obj, "/peripheral");
1071     container_get(obj, "/peripheral-anon");
1072 
1073     ms->dump_guest_core = true;
1074     ms->mem_merge = true;
1075     ms->enable_graphics = true;
1076     ms->kernel_cmdline = g_strdup("");
1077 
1078     if (mc->nvdimm_supported) {
1079         Object *obj = OBJECT(ms);
1080 
1081         ms->nvdimms_state = g_new0(NVDIMMState, 1);
1082         object_property_add_bool(obj, "nvdimm",
1083                                  machine_get_nvdimm, machine_set_nvdimm);
1084         object_property_set_description(obj, "nvdimm",
1085                                         "Set on/off to enable/disable "
1086                                         "NVDIMM instantiation");
1087 
1088         object_property_add_str(obj, "nvdimm-persistence",
1089                                 machine_get_nvdimm_persistence,
1090                                 machine_set_nvdimm_persistence);
1091         object_property_set_description(obj, "nvdimm-persistence",
1092                                         "Set NVDIMM persistence"
1093                                         "Valid values are cpu, mem-ctrl");
1094     }
1095 
1096     if (mc->cpu_index_to_instance_props && mc->get_default_cpu_node_id) {
1097         ms->numa_state = g_new0(NumaState, 1);
1098         object_property_add_bool(obj, "hmat",
1099                                  machine_get_hmat, machine_set_hmat);
1100         object_property_set_description(obj, "hmat",
1101                                         "Set on/off to enable/disable "
1102                                         "ACPI Heterogeneous Memory Attribute "
1103                                         "Table (HMAT)");
1104     }
1105 
1106     /* Register notifier when init is done for sysbus sanity checks */
1107     ms->sysbus_notifier.notify = machine_init_notify;
1108     qemu_add_machine_init_done_notifier(&ms->sysbus_notifier);
1109 
1110     /* default to mc->default_cpus */
1111     ms->smp.cpus = mc->default_cpus;
1112     ms->smp.max_cpus = mc->default_cpus;
1113     ms->smp.sockets = 1;
1114     ms->smp.dies = 1;
1115     ms->smp.cores = 1;
1116     ms->smp.threads = 1;
1117 }
1118 
1119 static void machine_finalize(Object *obj)
1120 {
1121     MachineState *ms = MACHINE(obj);
1122 
1123     g_free(ms->kernel_filename);
1124     g_free(ms->initrd_filename);
1125     g_free(ms->kernel_cmdline);
1126     g_free(ms->dtb);
1127     g_free(ms->dumpdtb);
1128     g_free(ms->dt_compatible);
1129     g_free(ms->firmware);
1130     g_free(ms->device_memory);
1131     g_free(ms->nvdimms_state);
1132     g_free(ms->numa_state);
1133 }
1134 
1135 bool machine_usb(MachineState *machine)
1136 {
1137     return machine->usb;
1138 }
1139 
1140 int machine_phandle_start(MachineState *machine)
1141 {
1142     return machine->phandle_start;
1143 }
1144 
1145 bool machine_dump_guest_core(MachineState *machine)
1146 {
1147     return machine->dump_guest_core;
1148 }
1149 
1150 bool machine_mem_merge(MachineState *machine)
1151 {
1152     return machine->mem_merge;
1153 }
1154 
1155 static char *cpu_slot_to_string(const CPUArchId *cpu)
1156 {
1157     GString *s = g_string_new(NULL);
1158     if (cpu->props.has_socket_id) {
1159         g_string_append_printf(s, "socket-id: %"PRId64, cpu->props.socket_id);
1160     }
1161     if (cpu->props.has_die_id) {
1162         g_string_append_printf(s, "die-id: %"PRId64, cpu->props.die_id);
1163     }
1164     if (cpu->props.has_core_id) {
1165         if (s->len) {
1166             g_string_append_printf(s, ", ");
1167         }
1168         g_string_append_printf(s, "core-id: %"PRId64, cpu->props.core_id);
1169     }
1170     if (cpu->props.has_thread_id) {
1171         if (s->len) {
1172             g_string_append_printf(s, ", ");
1173         }
1174         g_string_append_printf(s, "thread-id: %"PRId64, cpu->props.thread_id);
1175     }
1176     return g_string_free(s, false);
1177 }
1178 
1179 static void numa_validate_initiator(NumaState *numa_state)
1180 {
1181     int i;
1182     NodeInfo *numa_info = numa_state->nodes;
1183 
1184     for (i = 0; i < numa_state->num_nodes; i++) {
1185         if (numa_info[i].initiator == MAX_NODES) {
1186             error_report("The initiator of NUMA node %d is missing, use "
1187                          "'-numa node,initiator' option to declare it", i);
1188             exit(1);
1189         }
1190 
1191         if (!numa_info[numa_info[i].initiator].present) {
1192             error_report("NUMA node %" PRIu16 " is missing, use "
1193                          "'-numa node' option to declare it first",
1194                          numa_info[i].initiator);
1195             exit(1);
1196         }
1197 
1198         if (!numa_info[numa_info[i].initiator].has_cpu) {
1199             error_report("The initiator of NUMA node %d is invalid", i);
1200             exit(1);
1201         }
1202     }
1203 }
1204 
1205 static void machine_numa_finish_cpu_init(MachineState *machine)
1206 {
1207     int i;
1208     bool default_mapping;
1209     GString *s = g_string_new(NULL);
1210     MachineClass *mc = MACHINE_GET_CLASS(machine);
1211     const CPUArchIdList *possible_cpus = mc->possible_cpu_arch_ids(machine);
1212 
1213     assert(machine->numa_state->num_nodes);
1214     for (i = 0; i < possible_cpus->len; i++) {
1215         if (possible_cpus->cpus[i].props.has_node_id) {
1216             break;
1217         }
1218     }
1219     default_mapping = (i == possible_cpus->len);
1220 
1221     for (i = 0; i < possible_cpus->len; i++) {
1222         const CPUArchId *cpu_slot = &possible_cpus->cpus[i];
1223 
1224         if (!cpu_slot->props.has_node_id) {
1225             /* fetch default mapping from board and enable it */
1226             CpuInstanceProperties props = cpu_slot->props;
1227 
1228             props.node_id = mc->get_default_cpu_node_id(machine, i);
1229             if (!default_mapping) {
1230                 /* record slots with not set mapping,
1231                  * TODO: make it hard error in future */
1232                 char *cpu_str = cpu_slot_to_string(cpu_slot);
1233                 g_string_append_printf(s, "%sCPU %d [%s]",
1234                                        s->len ? ", " : "", i, cpu_str);
1235                 g_free(cpu_str);
1236 
1237                 /* non mapped cpus used to fallback to node 0 */
1238                 props.node_id = 0;
1239             }
1240 
1241             props.has_node_id = true;
1242             machine_set_cpu_numa_node(machine, &props, &error_fatal);
1243         }
1244     }
1245 
1246     if (machine->numa_state->hmat_enabled) {
1247         numa_validate_initiator(machine->numa_state);
1248     }
1249 
1250     if (s->len && !qtest_enabled()) {
1251         warn_report("CPU(s) not present in any NUMA nodes: %s",
1252                     s->str);
1253         warn_report("All CPU(s) up to maxcpus should be described "
1254                     "in NUMA config, ability to start up with partial NUMA "
1255                     "mappings is obsoleted and will be removed in future");
1256     }
1257     g_string_free(s, true);
1258 }
1259 
1260 MemoryRegion *machine_consume_memdev(MachineState *machine,
1261                                      HostMemoryBackend *backend)
1262 {
1263     MemoryRegion *ret = host_memory_backend_get_memory(backend);
1264 
1265     if (memory_region_is_mapped(ret)) {
1266         error_report("memory backend %s can't be used multiple times.",
1267                      object_get_canonical_path_component(OBJECT(backend)));
1268         exit(EXIT_FAILURE);
1269     }
1270     host_memory_backend_set_mapped(backend, true);
1271     vmstate_register_ram_global(ret);
1272     return ret;
1273 }
1274 
1275 void machine_run_board_init(MachineState *machine)
1276 {
1277     MachineClass *machine_class = MACHINE_GET_CLASS(machine);
1278     ObjectClass *oc = object_class_by_name(machine->cpu_type);
1279     CPUClass *cc;
1280 
1281     /* This checkpoint is required by replay to separate prior clock
1282        reading from the other reads, because timer polling functions query
1283        clock values from the log. */
1284     replay_checkpoint(CHECKPOINT_INIT);
1285 
1286     if (machine->ram_memdev_id) {
1287         Object *o;
1288         o = object_resolve_path_type(machine->ram_memdev_id,
1289                                      TYPE_MEMORY_BACKEND, NULL);
1290         machine->ram = machine_consume_memdev(machine, MEMORY_BACKEND(o));
1291     }
1292 
1293     if (machine->numa_state) {
1294         numa_complete_configuration(machine);
1295         if (machine->numa_state->num_nodes) {
1296             machine_numa_finish_cpu_init(machine);
1297         }
1298     }
1299 
1300     /* If the machine supports the valid_cpu_types check and the user
1301      * specified a CPU with -cpu check here that the user CPU is supported.
1302      */
1303     if (machine_class->valid_cpu_types && machine->cpu_type) {
1304         int i;
1305 
1306         for (i = 0; machine_class->valid_cpu_types[i]; i++) {
1307             if (object_class_dynamic_cast(oc,
1308                                           machine_class->valid_cpu_types[i])) {
1309                 /* The user specificed CPU is in the valid field, we are
1310                  * good to go.
1311                  */
1312                 break;
1313             }
1314         }
1315 
1316         if (!machine_class->valid_cpu_types[i]) {
1317             /* The user specified CPU is not valid */
1318             error_report("Invalid CPU type: %s", machine->cpu_type);
1319             error_printf("The valid types are: %s",
1320                          machine_class->valid_cpu_types[0]);
1321             for (i = 1; machine_class->valid_cpu_types[i]; i++) {
1322                 error_printf(", %s", machine_class->valid_cpu_types[i]);
1323             }
1324             error_printf("\n");
1325 
1326             exit(1);
1327         }
1328     }
1329 
1330     /* Check if CPU type is deprecated and warn if so */
1331     cc = CPU_CLASS(oc);
1332     if (cc && cc->deprecation_note) {
1333         warn_report("CPU model %s is deprecated -- %s", machine->cpu_type,
1334                     cc->deprecation_note);
1335     }
1336 
1337     if (machine->cgs) {
1338         /*
1339          * With confidential guests, the host can't see the real
1340          * contents of RAM, so there's no point in it trying to merge
1341          * areas.
1342          */
1343         machine_set_mem_merge(OBJECT(machine), false, &error_abort);
1344 
1345         /*
1346          * Virtio devices can't count on directly accessing guest
1347          * memory, so they need iommu_platform=on to use normal DMA
1348          * mechanisms.  That requires also disabling legacy virtio
1349          * support for those virtio pci devices which allow it.
1350          */
1351         object_register_sugar_prop(TYPE_VIRTIO_PCI, "disable-legacy",
1352                                    "on", true);
1353         object_register_sugar_prop(TYPE_VIRTIO_DEVICE, "iommu_platform",
1354                                    "on", false);
1355     }
1356 
1357     accel_init_interfaces(ACCEL_GET_CLASS(machine->accelerator));
1358     machine_class->init(machine);
1359     phase_advance(PHASE_MACHINE_INITIALIZED);
1360 }
1361 
1362 static NotifierList machine_init_done_notifiers =
1363     NOTIFIER_LIST_INITIALIZER(machine_init_done_notifiers);
1364 
1365 void qemu_add_machine_init_done_notifier(Notifier *notify)
1366 {
1367     notifier_list_add(&machine_init_done_notifiers, notify);
1368     if (phase_check(PHASE_MACHINE_READY)) {
1369         notify->notify(notify, NULL);
1370     }
1371 }
1372 
1373 void qemu_remove_machine_init_done_notifier(Notifier *notify)
1374 {
1375     notifier_remove(notify);
1376 }
1377 
1378 void qdev_machine_creation_done(void)
1379 {
1380     cpu_synchronize_all_post_init();
1381 
1382     if (current_machine->boot_once) {
1383         qemu_boot_set(current_machine->boot_once, &error_fatal);
1384         qemu_register_reset(restore_boot_order, g_strdup(current_machine->boot_order));
1385     }
1386 
1387     /*
1388      * ok, initial machine setup is done, starting from now we can
1389      * only create hotpluggable devices
1390      */
1391     phase_advance(PHASE_MACHINE_READY);
1392     qdev_assert_realized_properly();
1393 
1394     /* TODO: once all bus devices are qdevified, this should be done
1395      * when bus is created by qdev.c */
1396     /*
1397      * TODO: If we had a main 'reset container' that the whole system
1398      * lived in, we could reset that using the multi-phase reset
1399      * APIs. For the moment, we just reset the sysbus, which will cause
1400      * all devices hanging off it (and all their child buses, recursively)
1401      * to be reset. Note that this will *not* reset any Device objects
1402      * which are not attached to some part of the qbus tree!
1403      */
1404     qemu_register_reset(resettable_cold_reset_fn, sysbus_get_default());
1405 
1406     notifier_list_notify(&machine_init_done_notifiers, NULL);
1407 
1408     if (rom_check_and_register_reset() != 0) {
1409         exit(1);
1410     }
1411 
1412     replay_start();
1413 
1414     /* This checkpoint is required by replay to separate prior clock
1415        reading from the other reads, because timer polling functions query
1416        clock values from the log. */
1417     replay_checkpoint(CHECKPOINT_RESET);
1418     qemu_system_reset(SHUTDOWN_CAUSE_NONE);
1419     register_global_state();
1420 }
1421 
1422 static const TypeInfo machine_info = {
1423     .name = TYPE_MACHINE,
1424     .parent = TYPE_OBJECT,
1425     .abstract = true,
1426     .class_size = sizeof(MachineClass),
1427     .class_init    = machine_class_init,
1428     .class_base_init = machine_class_base_init,
1429     .instance_size = sizeof(MachineState),
1430     .instance_init = machine_initfn,
1431     .instance_finalize = machine_finalize,
1432 };
1433 
1434 static void machine_register_types(void)
1435 {
1436     type_register_static(&machine_info);
1437 }
1438 
1439 type_init(machine_register_types)
1440