[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 1/6] include/hw/boards.h: Document machine_class_allow_dynamic_sys
From: |
Peter Maydell |
Subject: |
[PULL 1/6] include/hw/boards.h: Document machine_class_allow_dynamic_sysbus_dev() |
Date: |
Tue, 6 Apr 2021 13:26:30 +0100 |
The function machine_class_allow_dynamic_sysbus_dev() is currently
undocumented; add a doc comment.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk>
Reviewed-by: Eric Auger <eric.auger@redhat.com>
Message-id: 20210325153310.9131-2-peter.maydell@linaro.org
---
include/hw/boards.h | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/include/hw/boards.h b/include/hw/boards.h
index 4a90549ad85..6fc5cefcec5 100644
--- a/include/hw/boards.h
+++ b/include/hw/boards.h
@@ -36,7 +36,22 @@ void machine_set_cpu_numa_node(MachineState *machine,
const CpuInstanceProperties *props,
Error **errp);
+/**
+ * machine_class_allow_dynamic_sysbus_dev: Add type to list of valid devices
+ * @mc: Machine class
+ * @type: type to allow (should be a subtype of TYPE_SYS_BUS_DEVICE)
+ *
+ * Add the QOM type @type to the list of devices of which are subtypes
+ * of TYPE_SYS_BUS_DEVICE but which are still permitted to be dynamically
+ * created (eg by the user on the command line with -device).
+ * By default if the user tries to create any devices on the command line
+ * that are subtypes of TYPE_SYS_BUS_DEVICE they will get an error message;
+ * for the special cases which are permitted for this machine model, the
+ * machine model class init code must call this function to add them
+ * to the list of specifically permitted devices.
+ */
void machine_class_allow_dynamic_sysbus_dev(MachineClass *mc, const char
*type);
+
/*
* Checks that backend isn't used, preps it for exclusive usage and
* returns migratable MemoryRegion provided by backend.
--
2.20.1
- [PULL 0/6] target-arm queue, Peter Maydell, 2021/04/06
- [PULL 1/6] include/hw/boards.h: Document machine_class_allow_dynamic_sysbus_dev(),
Peter Maydell <=
- [PULL 4/6] hw/ppc/e500plat: Only try to add valid dynamic sysbus devices to platform bus, Peter Maydell, 2021/04/06
- [PULL 5/6] Revert "target/arm: Make number of counters in PMCR follow the CPU", Peter Maydell, 2021/04/06
- [PULL 2/6] machine: Provide a function to check the dynamic sysbus allowlist, Peter Maydell, 2021/04/06
- [PULL 3/6] hw/arm/virt: Only try to add valid dynamic sysbus devices to platform bus, Peter Maydell, 2021/04/06
- [PULL 6/6] Remove myself as i.mx31 maintainer, Peter Maydell, 2021/04/06
- Re: [PULL 0/6] target-arm queue, Peter Maydell, 2021/04/06