[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v4 21/34] modules: add documentation for module sourcesets
From: |
Gerd Hoffmann |
Subject: |
[PATCH v4 21/34] modules: add documentation for module sourcesets |
Date: |
Thu, 24 Jun 2021 12:38:23 +0200 |
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
---
docs/devel/build-system.rst | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/docs/devel/build-system.rst b/docs/devel/build-system.rst
index 7ef36f42d0f5..fd1650442ecc 100644
--- a/docs/devel/build-system.rst
+++ b/docs/devel/build-system.rst
@@ -272,6 +272,23 @@ Target-dependent emulator sourcesets:
target_arch += {'arm': arm_ss}
target_softmmu_arch += {'arm': arm_softmmu_ss}
+Module sourcesets:
+ There are two dictionaries for modules: `modules` is used for
+ target-independent modules and `target_modules` is used for
+ target-dependent modules. When modules are disabled the `module`
+ source sets are added to `softmmu_ss` and the `target_modules`
+ source sets are added to `specific_ss`.
+
+ Both dictionaries are nested. One dictionary is created per
+ subdirectory, and these per-subdirectory dictionaries are added to
+ the toplevel dictionaries. For example::
+
+ hw_display_modules = {}
+ qxl_ss = ss.source_set()
+ ...
+ hw_display_modules += { 'qxl': qxl_ss }
+ modules += { 'hw-display': hw_display_modules }
+
Utility sourcesets:
All binaries link with a static library `libqemuutil.a`. This library
is built from several sourcesets; most of them however host generated
--
2.31.1
- [PATCH v4 12/34] modules: add s390x module annotations, (continued)
- [PATCH v4 12/34] modules: add s390x module annotations, Gerd Hoffmann, 2021/06/24
- [PATCH v4 13/34] modules: add block module annotations, Gerd Hoffmann, 2021/06/24
- [PATCH v4 14/34] modules: use modinfo for dependencies, Gerd Hoffmann, 2021/06/24
- [PATCH v4 15/34] modules: use modinfo for qom load, Gerd Hoffmann, 2021/06/24
- [PATCH v4 17/34] modules: add tracepoints, Gerd Hoffmann, 2021/06/24
- [PATCH v4 16/34] modules: use modinfo for qemu opts load, Gerd Hoffmann, 2021/06/24
- [PATCH v4 18/34] modules: check arch and block load on mismatch, Gerd Hoffmann, 2021/06/24
- [PATCH v4 19/34] modules: check arch on qom lookup, Gerd Hoffmann, 2021/06/24
- [PATCH v4 20/34] modules: target-specific module build infrastructure, Gerd Hoffmann, 2021/06/24
- [PATCH v4 23/34] modules: module.h kerneldoc annotations, Gerd Hoffmann, 2021/06/24
- [PATCH v4 21/34] modules: add documentation for module sourcesets,
Gerd Hoffmann <=
- [PATCH v4 22/34] modules: add module_obj() note to QOM docs, Gerd Hoffmann, 2021/06/24
- [PATCH v4 24/34] modules: hook up modules.h to docs build, Gerd Hoffmann, 2021/06/24
- [PATCH v4 25/34] accel: autoload modules, Gerd Hoffmann, 2021/06/24
- [PATCH v4 26/34] accel: add qtest module annotations, Gerd Hoffmann, 2021/06/24
- [PATCH v4 27/34] accel: build qtest modular, Gerd Hoffmann, 2021/06/24
- [PATCH v4 29/34] accel: build tcg modular, Gerd Hoffmann, 2021/06/24
- [PATCH v4 28/34] accel: add tcg module annotations, Gerd Hoffmann, 2021/06/24
- [PATCH v4 31/34] usb: drop usb_host_dev_is_scsi_storage hook, Gerd Hoffmann, 2021/06/24
- [PATCH v4 30/34] monitor: allow register hmp commands, Gerd Hoffmann, 2021/06/24