Branch: refs/heads/staging Home: https://github.com/qemu/qemu Commit: 66c83cdd91c07575ebf30bb45da8cc5df8041c29 https://github.com/qemu/qemu/commit/66c83cdd91c07575ebf30bb45da8cc5df8041c29 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025)
Changed paths: M docs/sphinx/qapidoc.py Log Message: ----------- docs/sphinx: adjust qapidoc to cope with same-line error sections Without this, the line the new QAPI doc generator chokes on # Errors: some in doc-good.json. We still use the old doc generator for the tests, but we're about to correct that. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250618165353.1980365-2-js...@redhat.com> Acked-by: Markus Armbruster <arm...@redhat.com> Fixes: e9fbf1a0c6c2 (docs/qapidoc: add visit_errors() method) [Amend commit message to point to reproducer, and add Fixes:] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: e56c683bae9d1dc1b637029a0595225499ef7248 https://github.com/qemu/qemu/commit/e56c683bae9d1dc1b637029a0595225499ef7248 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M docs/sphinx/qapidoc.py Log Message: ----------- docs/sphinx: parse @references in freeform text Oversight in the new qapidoc transmogrifier: @references in freeform documentation blocks were not being transformed to literals. This fixes that, and the next patch ensures that we're testing for this O:-) Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250618165353.1980365-3-js...@redhat.com> Acked-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 8d789c8cdb8de2cae39f217b6c9607ac9c036c8c https://github.com/qemu/qemu/commit/8d789c8cdb8de2cae39f217b6c9607ac9c036c8c Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M docs/interop/qemu-ga-ref.rst M docs/interop/qemu-qmp-ref.rst M docs/interop/qemu-storage-daemon-qmp-ref.rst M docs/sphinx/qapidoc.py R docs/sphinx/qapidoc_legacy.py M python/tests/qapi-isort.sh M tests/qapi-schema/doc-good.txt Log Message: ----------- docs/sphinx: remove legacy QAPI manual generator Thanks for your service! Remove the old qapidoc and the option to enable the transmogrifier, leaving the "transmogrifier" as the ONLY qapi doc generator. This in effect also converts the QAPI test to use the new documentation generator, too. Update doc-good.txt output to match the new doc generator, which I should've done exactly when we switched over to the transmogrifier, but, uhh, oops! Notes on the new format: 1. per-member IFCOND documentation is missing. Known issue. 2. Freeform documentation without a header is now copied through into the output. This is a bug fix. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250618165353.1980365-4-js...@redhat.com> Acked-by: Markus Armbruster <arm...@redhat.com> Fixes: b61a4eb3f32 (docs/qapidoc: support header-less freeform sections) [Tweak commit message to say it's a bug fix, add Fixes:] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 6c10778826a873b9012d95e63298a6f879debcaa https://github.com/qemu/qemu/commit/6c10778826a873b9012d95e63298a6f879debcaa Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M docs/devel/qapi-code-gen.rst M docs/interop/firmware.json M docs/interop/vhost-user.json M docs/sphinx/qapidoc.py M qapi/acpi.json M qapi/audio.json M qapi/authz.json M qapi/block-core.json M qapi/block-export.json M qapi/block.json M qapi/char.json M qapi/common.json M qapi/compat.json M qapi/control.json M qapi/crypto.json M qapi/cryptodev.json M qapi/cxl.json M qapi/dump.json M qapi/ebpf.json M qapi/error.json M qapi/introspect.json M qapi/job.json M qapi/machine-common.json M qapi/machine.json M qapi/migration.json M qapi/misc.json M qapi/net.json M qapi/pci.json M qapi/qapi-schema.json M qapi/qdev.json M qapi/qom.json M qapi/replay.json M qapi/rocker.json M qapi/run-state.json M qapi/sockets.json M qapi/stats.json M qapi/tpm.json M qapi/trace.json M qapi/transaction.json M qapi/uefi.json M qapi/ui.json M qapi/vfio.json M qapi/virtio.json M qapi/yank.json M scripts/qapi/parser.py M storage-daemon/qapi/qapi-schema.json M tests/qapi-schema/doc-good.json M tests/qapi-schema/doc-good.out Log Message: ----------- docs/sphinx: remove special parsing for freeform sections Remove the QAPI doc section heading syntax, use plain rST section headings instead. Tests and documentation are updated to match. Interestingly, Plain rST headings work fine before this patch, except for over- and underlining with '=', which the doc parser rejected as invalid QAPI doc section heading in free-form comments. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250618165353.1980365-5-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Add more detail to commit message] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 62c4dc4b69ef7dcfcc476913a9c5fc15329e0290 https://github.com/qemu/qemu/commit/62c4dc4b69ef7dcfcc476913a9c5fc15329e0290 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M scripts/qapi/parser.py R tests/qapi-schema/doc-bad-section.err R tests/qapi-schema/doc-bad-section.json R tests/qapi-schema/doc-bad-section.out M tests/qapi-schema/meson.build Log Message: ----------- qapi: lift restriction on using '=' in doc blocks We reject lines starting with '=' in definition documentation. This made sense when such lines were headings in free-form documentation, but not in definition documentation. Before the previous commit, lines starting with '=' were headings in free-form documentation, and rejected in definition documentation, where such headings could not work. The previous commit dropped the headings feature from free-form documentation, because we can simply use plain rST headings. Rejecting them in definition documentation no longer makes sense, so drop that, too. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250618165353.1980365-6-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Amend commit message to explain why] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: c13ceeb42df5452690fc530269696f59da921b31 https://github.com/qemu/qemu/commit/c13ceeb42df5452690fc530269696f59da921b31 Author: Markus Armbruster <arm...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/control.json M qapi/misc-i386.json M qapi/qom.json Log Message: ----------- qapi: Clean up "This command will do ..." command descriptions Use imperative mood "Do ..." instead. Signed-off-by: Markus Armbruster <arm...@redhat.com> Message-ID: <20250708072828.105185-2-arm...@redhat.com> Reviewed-by: Daniel P. Berrangé <berra...@redhat.com> Commit: 92227370eb3d844528e6d7bc2fb42525d8245eaf https://github.com/qemu/qemu/commit/92227370eb3d844528e6d7bc2fb42525d8245eaf Author: Markus Armbruster <arm...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/misc-i386.json M qapi/qom.json Log Message: ----------- qapi: Clean up a few Errors: sections Use the conventional "- If <error-condition>" phrasing, optionally with ", <error-class>". Signed-off-by: Markus Armbruster <arm...@redhat.com> Message-ID: <20250708072828.105185-3-arm...@redhat.com> Reviewed-by: Daniel P. Berrangé <berra...@redhat.com> Commit: 2e51072ae5c0275733be748fbee3ce59df6d6261 https://github.com/qemu/qemu/commit/2e51072ae5c0275733be748fbee3ce59df6d6261 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M docs/devel/qapi-domain.rst M docs/sphinx/qapi_domain.py Log Message: ----------- docs/qapi-domain: add return-nodesc This form is used to annotate a return type without an accompanying description, for when there is no "Returns:" information in the source doc, but we have a return type we want to generate a cross-reference to. The syntax is: :return-nodesc: TypeName It's primarily necessary because Sphinx always expects both a type and a description for the prior form and will format it accordingly. To have a reasonable rendering when the body is missing, we need to use a different info field list entirely. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711051045.51110-2-js...@redhat.com> Acked-by: Markus Armbruster <arm...@redhat.com> [Long line wrapped] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 636c96cd77d39aaec3e1c09b9990b76b015566e1 https://github.com/qemu/qemu/commit/636c96cd77d39aaec3e1c09b9990b76b015566e1 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M docs/sphinx/qapidoc.py M qapi/machine.json M scripts/qapi/parser.py M scripts/qapi/schema.py Log Message: ----------- qapi: Fix undocumented return values by generating something Generated command documentation lacks information on return value in several cases, e.g. query-tpm. The obvious fix would be to require a Returns: section when a command returns something. However, note that many existing Returns: sections are pretty useless: the description is basically the return type, which then gets rendered like "Return: <Type> – <basically the return type>". This suggests that a description is often not really necessary, and requiring one isn't useful. Instead, generate the obvious minimal thing when Returns: is absent: "Return: <Type>". This auto-generated Return documentation is placed is as follows: 1. If we have arguments, return goes right after them. 2. Else if we have errors, return goes right before them. 3. Else if we have features, return goes right before them. 4. Else return goes right after the intro To facilitate this algorithm, a "TODO:" hack line is used to separate the intro from the remainder of the documentation block in cases where there are no other sections to separate the intro from e.g. examples and additional detail meant to appear below the key sections of interest. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711051045.51110-3-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [_insert_near_kind() code replaced by something simpler, commit message amended to explain why we're doing this] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 0462da9d6b1918c741c632f57d743d5851ec5983 https://github.com/qemu/qemu/commit/0462da9d6b1918c741c632f57d743d5851ec5983 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/audio.json M qapi/block-core.json M qapi/char.json M qapi/cryptodev.json M qapi/machine.json M qapi/migration.json M qapi/misc-arm.json M qapi/misc-i386.json M qapi/misc.json M qapi/rocker.json M qapi/run-state.json M qapi/tpm.json M qapi/ui.json M qapi/virtio.json M qapi/yank.json Log Message: ----------- qapi: remove trivial "Returns:" sections The new qapidoc.py can generate "Returns" statements with type information just fine, so we can remove it from the source where it doesn't add anything particularly novel or helpful and just repeats the type info. This patch is fairly "gentle" and doesn't aggressively touch other "Returns" lines that could be rephrased to omit repeating type information; it only removes lines that appear appropriate to wholly remove. To help facilitate auto-generated placement, a few doc blocks have a "TODO:" line inserted to help the placement algorithm differentiate the introductory paragraph(s) from the rest of the documentation. The auto-generated returns are in the exact same spot, except for query-migrationthreads, query-machines, and x-query-virtio-queue-element. These auto-generation moves to a better spot. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711051045.51110-4-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Two more Returns: removed, commit message amended to explain auto-generated returns generated into a different spot] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: f7296f8de5c96c09452a0774435c1e5b512fab19 https://github.com/qemu/qemu/commit/f7296f8de5c96c09452a0774435c1e5b512fab19 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/block-core.json M qapi/block-export.json M qapi/block.json M qapi/control.json M qapi/dump.json M qapi/introspect.json M qapi/job.json M qapi/misc-i386.json M qapi/misc.json M qapi/net.json M qapi/pci.json M qapi/qdev.json M qapi/qom.json M qapi/stats.json M qapi/trace.json M qapi/ui.json M qapi/virtio.json Log Message: ----------- qapi: rephrase return docs to avoid type name "Returns: <description>" is rendered like "Return: <Type> – <description>". Mentioning the type in the description again is commonly redundant. Rephrase such descriptions not to. Well, I tried. Maybe not very hard. Sorry! Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711051045.51110-5-js...@redhat.com> Acked-by: Markus Armbruster <arm...@redhat.com> [Commit message amended to explain why] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 95b3be1965779e77a12a95d531914fa0fecc24ec https://github.com/qemu/qemu/commit/95b3be1965779e77a12a95d531914fa0fecc24ec Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/acpi.json Log Message: ----------- qapi: add cross-references to acpi.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-2-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: a724defe3213999db735496daee94abb52e93f43 https://github.com/qemu/qemu/commit/a724defe3213999db735496daee94abb52e93f43 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/authz.json Log Message: ----------- qapi: add cross-references to authz.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-3-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: a3763337ad0f4e6252abc894a8bbced11ddf3998 https://github.com/qemu/qemu/commit/a3763337ad0f4e6252abc894a8bbced11ddf3998 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/block-core.json M qapi/block-export.json M qapi/block.json M qapi/transaction.json Log Message: ----------- qapi: add cross-references to block layer Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-4-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Two unwanted cross-references dropped] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: ed17e68732d2efa4dc813a02de0bbf68ed40775c https://github.com/qemu/qemu/commit/ed17e68732d2efa4dc813a02de0bbf68ed40775c Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/crypto.json Log Message: ----------- qapi: add cross-references to crypto.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-5-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: dc79c02898dd5b2fdc9851f6c226421c701f6478 https://github.com/qemu/qemu/commit/dc79c02898dd5b2fdc9851f6c226421c701f6478 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/dump.json Log Message: ----------- qapi: add cross-references to dump.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-6-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: d1813fb4c4b052ec24814b7781431ee60bd57fdd https://github.com/qemu/qemu/commit/d1813fb4c4b052ec24814b7781431ee60bd57fdd Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/job.json Log Message: ----------- qapi: add cross-references to job.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-7-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Accidental line rewrap and an unwanted cross-refence dropped] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 6082825e95cd1d3e638c1df68c05c8847cac5c08 https://github.com/qemu/qemu/commit/6082825e95cd1d3e638c1df68c05c8847cac5c08 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/machine-common.json M qapi/machine.json Log Message: ----------- qapi: add cross-references to Machine core Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-8-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: b51ea1c42111464961a4b2bb3f1d3f4f0ddfc006 https://github.com/qemu/qemu/commit/b51ea1c42111464961a4b2bb3f1d3f4f0ddfc006 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/migration.json Log Message: ----------- qapi: add cross-references to migration.json Note that a reference to MIGRATION needs to be disambiguated with a :qapi:event: prefix. Without this, Sphinx complains more than one target found for 'any' cross-reference 'MIGRATION': could be :std:ref:`Migration framework` or :qapi:event:`QMP:migration.MIGRATION` Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-9-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> [Commit message amended to explain need for :qapi:event:] Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 4411a50e31157a1ee81147c2a6d6f1372a7bf6e8 https://github.com/qemu/qemu/commit/4411a50e31157a1ee81147c2a6d6f1372a7bf6e8 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/net.json Log Message: ----------- qapi: add cross-references to net.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-10-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: b9abf7dd3f926e50029bd450e2d9c7cd2f1dde51 https://github.com/qemu/qemu/commit/b9abf7dd3f926e50029bd450e2d9c7cd2f1dde51 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/pci.json Log Message: ----------- qapi: add cross-references to pci.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-11-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 91581b49e1d1910c1e5af641e7b8afa95c1b0a53 https://github.com/qemu/qemu/commit/91581b49e1d1910c1e5af641e7b8afa95c1b0a53 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/qdev.json M qapi/qom.json Log Message: ----------- qapi: add cross-references to QOM Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-12-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 551c00b8fac1f0532ba10bac05a5da7b7b508f71 https://github.com/qemu/qemu/commit/551c00b8fac1f0532ba10bac05a5da7b7b508f71 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/replay.json Log Message: ----------- qapi: add cross-references to replay.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-13-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 57d2ad7d2f534d510c7afb44d574d6313a0ab91e https://github.com/qemu/qemu/commit/57d2ad7d2f534d510c7afb44d574d6313a0ab91e Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/run-state.json Log Message: ----------- qapi: add cross-references to run-state.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-14-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: bfdfd96388fed2c23b2a42c32c5dd1a96d437c20 https://github.com/qemu/qemu/commit/bfdfd96388fed2c23b2a42c32c5dd1a96d437c20 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/sockets.json Log Message: ----------- qapi: add cross-references to sockets.json Signed-off-by: John Snow <js...@redhat.com> Reviewed-by: Eric Blake <ebl...@redhat.com> Message-ID: <20250711054005.60969-15-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 64ebc732e1a1bc3a76b7412eca9f0fc6b0c235d1 https://github.com/qemu/qemu/commit/64ebc732e1a1bc3a76b7412eca9f0fc6b0c235d1 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/ui.json Log Message: ----------- qapi: add cross-references to ui.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-16-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 6e202378d1533d87f77c73ffb22fbb784d08f545 https://github.com/qemu/qemu/commit/6e202378d1533d87f77c73ffb22fbb784d08f545 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/virtio.json Log Message: ----------- qapi: add cross-references to virtio.json Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-17-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 13f53cc902b7fa6d1864f7c13c3b3c755d1001a5 https://github.com/qemu/qemu/commit/13f53cc902b7fa6d1864f7c13c3b3c755d1001a5 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/yank.json Log Message: ----------- qapi: add cross-references to yank.json Signed-off-by: John Snow <js...@redhat.com> Acked-by: Lukas Straub <lukasstra...@web.de> Message-ID: <20250711054005.60969-18-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 68c0156de2581b69e62b2f04b58a89bdc762e603 https://github.com/qemu/qemu/commit/68c0156de2581b69e62b2f04b58a89bdc762e603 Author: John Snow <js...@redhat.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/control.json M qapi/ebpf.json M qapi/introspect.json M qapi/misc-arm.json M qapi/misc-i386.json M qapi/misc.json M qapi/stats.json Log Message: ----------- qapi: add cross-references to misc modules These modules don't have specific maintainers, so they're lumped in together here as miscellaneous. Signed-off-by: John Snow <js...@redhat.com> Message-ID: <20250711054005.60969-19-js...@redhat.com> Reviewed-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: a819027b2c9df4d029b6bdff7ca77320c41d2e12 https://github.com/qemu/qemu/commit/a819027b2c9df4d029b6bdff7ca77320c41d2e12 Author: Steve Sistare <steven.sist...@oracle.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M qapi/qom.json M qom/qom-qmp-cmds.c Log Message: ----------- qom: qom-list-get Using qom-list and qom-get to get all the nodes and property values in a QOM tree can take multiple seconds because it requires 1000's of individual QOM requests. Some managers fetch the entire tree or a large subset of it when starting a new VM, and this cost is a substantial fraction of start up time. Define the qom-list-get command, which fetches all the properties and values for a list of paths. This can be much faster than qom-list plus qom-get. When getting an entire QOM tree, I measured a 10x speedup in elapsed time. Signed-off-by: Steve Sistare <steven.sist...@oracle.com> Tested-by: Philippe Mathieu-Daudé <phi...@linaro.org> Reviewed-by: Philippe Mathieu-Daudé <phi...@linaro.org> Reviewed-by: Markus Armbruster <arm...@redhat.com> Message-ID: <1752248703-217318-2-git-send-email-steven.sist...@oracle.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: c4df652ba92beea8ecd52129937c02825b2210fa https://github.com/qemu/qemu/commit/c4df652ba92beea8ecd52129937c02825b2210fa Author: Steve Sistare <steven.sist...@oracle.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M python/qemu/utils/qom.py M python/qemu/utils/qom_common.py Log Message: ----------- python: use qom-list-get Use qom-list-get to speed up the qom-tree command. Signed-off-by: Steve Sistare <steven.sist...@oracle.com> Acked-by: Markus Armbruster <arm...@redhat.com> Message-ID: <1752248703-217318-3-git-send-email-steven.sist...@oracle.com> Tested-by: Markus Armbruster <arm...@redhat.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: 07273ca0ce3af397071f7a6c11abdab649ff25e1 https://github.com/qemu/qemu/commit/07273ca0ce3af397071f7a6c11abdab649ff25e1 Author: Steve Sistare <steven.sist...@oracle.com> Date: 2025-07-14 (Mon, 14 Jul 2025) Changed paths: M tests/qtest/qom-test.c Log Message: ----------- tests/qtest/qom-test: unit test for qom-list-get Add a unit test for qom-list-get. Signed-off-by: Steve Sistare <steven.sist...@oracle.com> Reviewed-by: Philippe Mathieu-Daudé <phi...@linaro.org> Reviewed-by: Markus Armbruster <arm...@redhat.com> Message-ID: <1752248703-217318-4-git-send-email-steven.sist...@oracle.com> Signed-off-by: Markus Armbruster <arm...@redhat.com> Commit: c079d3a31e45093286c65f8ca5350beb3a4404a9 https://github.com/qemu/qemu/commit/c079d3a31e45093286c65f8ca5350beb3a4404a9 Author: Stefan Hajnoczi <stefa...@redhat.com> Date: 2025-07-15 (Tue, 15 Jul 2025) Changed paths: M .gitlab-ci.d/check-units.py M common-user/plugin-api.c.inc M configs/targets/alpha-linux-user.mak M configs/targets/alpha-softmmu.mak M configs/targets/sparc64-linux-user.mak M configs/targets/sparc64-softmmu.mak M contrib/plugins/execlog.c M docs/devel/testing/main.rst M docs/system/images.rst M docs/system/keys.rst.inc M docs/system/linuxboot.rst M docs/system/mux-chardev.rst.inc M docs/system/virtio-net-failover.rst A gdb-xml/alpha-core.xml A gdb-xml/sparc64-core.xml M linux-user/meson.build M linux-user/plugin-api.c M target/alpha/cpu.c M target/sparc/cpu.c Log Message: ----------- Merge tag 'pull-10.1-rc0-maintainer-140725-1' of https://gitlab.com/stsquad/qemu into staging maintainer updates (gitlab, plugins, gdbstub, docs) - update check-units script to take -n <top> argument - fix execlog plugin to handle tab separators - add gdb XML file for alpha - add gdb XML file for sparc64 - use :kbd: in docs to highlight key sequences - clean up rst formatting in virtio-net-failover docs # -----BEGIN PGP SIGNATURE----- # # iQEzBAABCgAdFiEEZoWumedRZ7yvyN81+9DbCVqeKkQFAmh0374ACgkQ+9DbCVqe # KkR0gQf/a9Au455+OWEhG3uLGkMZZaFM6QJv8W3wBBZoRg59LMXkUIhEtyVfdmt5 # SDyA79nw1G0iP2qlKQV02R++CrBHMJILtYOMoLTbkWV9Lft4h+uPC27SE17DkNPS # 4b4TchlJ3DpOFi0XmYZuIwH/8CPpTdVCLcA5zEXT0Q8nKjk0JsGiOQxoHH+p3ad5 # +mgvlmITDpU88OCilDYgmrD5iSe/WLzwszV9D6JTfQakfM7J9G87sj4iMK+En+iu # 0rsRBk2gwahy4cfqaiaELTtarqadM1TaNwaRvt6vun+Hp12pypDhogG1Mh5e2eCB # /nFwjcswRRk+kd26993AiK8Soomwiw== # =Md3/ # -----END PGP SIGNATURE----- # gpg: Signature made Mon 14 Jul 2025 06:45:18 EDT # gpg: using RSA key 6685AE99E75167BCAFC8DF35FBD0DB095A9E2A44 # gpg: Good signature from "Alex Bennée (Master Work Key) <alex.ben...@linaro.org>" [unknown] # gpg: WARNING: This key is not certified with a trusted signature! # gpg: There is no indication that the signature belongs to the owner. # Primary key fingerprint: 6685 AE99 E751 67BC AFC8 DF35 FBD0 DB09 5A9E 2A44 * tag 'pull-10.1-rc0-maintainer-140725-1' of https://gitlab.com/stsquad/qemu: gdbstub: add the GDB register XML files for sparc64. docs/system: clean-up formatting of virtio-net-failover docs: use :kbd: role in sphinx docs plugins: fix inclusion of user-mode APIs target/alpha: Add GDB XML feature file contrib/plugins/execlog: Add tab to the separator search of insn_disas gitlab: add -n option to check-units script gitlab: use argparse in check-units script Signed-off-by: Stefan Hajnoczi <stefa...@redhat.com> Commit: c630f7b84b5f07a61cf331fa344e2e7bbb9160fd https://github.com/qemu/qemu/commit/c630f7b84b5f07a61cf331fa344e2e7bbb9160fd Author: Stefan Hajnoczi <stefa...@redhat.com> Date: 2025-07-15 (Tue, 15 Jul 2025) Changed paths: M docs/devel/qapi-code-gen.rst M docs/devel/qapi-domain.rst M docs/interop/firmware.json M docs/interop/qemu-ga-ref.rst M docs/interop/qemu-qmp-ref.rst M docs/interop/qemu-storage-daemon-qmp-ref.rst M docs/interop/vhost-user.json M docs/sphinx/qapi_domain.py M docs/sphinx/qapidoc.py R docs/sphinx/qapidoc_legacy.py M python/qemu/utils/qom.py M python/qemu/utils/qom_common.py M python/tests/qapi-isort.sh M qapi/acpi.json M qapi/audio.json M qapi/authz.json M qapi/block-core.json M qapi/block-export.json M qapi/block.json M qapi/char.json M qapi/common.json M qapi/compat.json M qapi/control.json M qapi/crypto.json M qapi/cryptodev.json M qapi/cxl.json M qapi/dump.json M qapi/ebpf.json M qapi/error.json M qapi/introspect.json M qapi/job.json M qapi/machine-common.json M qapi/machine.json M qapi/migration.json M qapi/misc-arm.json M qapi/misc-i386.json M qapi/misc.json M qapi/net.json M qapi/pci.json M qapi/qapi-schema.json M qapi/qdev.json M qapi/qom.json M qapi/replay.json M qapi/rocker.json M qapi/run-state.json M qapi/sockets.json M qapi/stats.json M qapi/tpm.json M qapi/trace.json M qapi/transaction.json M qapi/uefi.json M qapi/ui.json M qapi/vfio.json M qapi/virtio.json M qapi/yank.json M qom/qom-qmp-cmds.c M scripts/qapi/parser.py M scripts/qapi/schema.py M storage-daemon/qapi/qapi-schema.json R tests/qapi-schema/doc-bad-section.err R tests/qapi-schema/doc-bad-section.json R tests/qapi-schema/doc-bad-section.out M tests/qapi-schema/doc-good.json M tests/qapi-schema/doc-good.out M tests/qapi-schema/doc-good.txt M tests/qapi-schema/meson.build M tests/qtest/qom-test.c Log Message: ----------- Merge tag 'pull-qapi-2025-07-14' of https://repo.or.cz/qemu/armbru into staging QAPI patches patches for 2025-07-14 # -----BEGIN PGP SIGNATURE----- # # iQJGBAABCAAwFiEENUvIs9frKmtoZ05fOHC0AOuRhlMFAmh1BvYSHGFybWJydUBy # ZWRoYXQuY29tAAoJEDhwtADrkYZTq7YQALI2aK4rFLZXm+v5a3in2Y4WhqOz+tR2 # NlYq9mrE+6PzOCRGfBO4tCh5xrrd/jMXTq1YwzzSwm/CBpu94hfs6spXi68JTG+g # LKPocNEb696dTERAgWUpGCQeiaZwToMwTDeuobc+1Ox1kVSSDh/TSy9cuLz/0SEu # TxpvhGr17sC6q05NVGob+Z8BFvyqceN93Dw4aWkLlggjqjhWtcOyjF6W+92Jjs5P # xby0XKIvSjaVbL0TFz/zWWgSL4EZgo/nlKrEu9GGYLAFgfCAWzxC0Dwvn8zuaEog # Y8RBDC80U8kPn2jWeo1elve7b2EnuapAEp9KAoHIuyaDZnGI/nIVUb/t6ibIhAqZ # NT0aEMxkBOsB9SmK6cgC6cojBb+wZTkrjAJ1OZgxNeufV3LZ/DOkbXWam3Odt5LE # 66B8JFSN8fwTYjfcboZ2iCsLB0hOfm9EKgNQgBo23bEOQNKvyqY3mfFtSSsc5cl8 # MUqpky/XbLeXp2ZPs0PKvZanERGp615IOKV/l6s838Ec7t2/wb0thfg/dOWsgAMS # 38YUzTtfufSW58JmXUZIdNTHRgwNfeDJ+yMEue6jm7MFkMy9wr7KxtrudB9EMQNh # yJazPRw4lx/4YbHK0XAnsY1yhjoVNXutRUOeTQIUqfTT8SBjVuB3IovC1yc9otAu # tV3G8IocsmFy # =74ar # -----END PGP SIGNATURE----- # gpg: Signature made Mon 14 Jul 2025 09:32:38 EDT # gpg: using RSA key 354BC8B3D7EB2A6B68674E5F3870B400EB918653 # gpg: issuer "arm...@redhat.com" # gpg: Good signature from "Markus Armbruster <arm...@redhat.com>" [full] # gpg: aka "Markus Armbruster <arm...@pond.sub.org>" [full] # Primary key fingerprint: 354B C8B3 D7EB 2A6B 6867 4E5F 3870 B400 EB91 8653 * tag 'pull-qapi-2025-07-14' of https://repo.or.cz/qemu/armbru: (32 commits) tests/qtest/qom-test: unit test for qom-list-get python: use qom-list-get qom: qom-list-get qapi: add cross-references to misc modules qapi: add cross-references to yank.json qapi: add cross-references to virtio.json qapi: add cross-references to ui.json qapi: add cross-references to sockets.json qapi: add cross-references to run-state.json qapi: add cross-references to replay.json qapi: add cross-references to QOM qapi: add cross-references to pci.json qapi: add cross-references to net.json qapi: add cross-references to migration.json qapi: add cross-references to Machine core qapi: add cross-references to job.json qapi: add cross-references to dump.json qapi: add cross-references to crypto.json qapi: add cross-references to block layer qapi: add cross-references to authz.json ... Signed-off-by: Stefan Hajnoczi <stefa...@redhat.com> Compare: https://github.com/qemu/qemu/compare/9bbb23eb04a7...c630f7b84b5f To unsubscribe from these emails, change your notification settings at https://github.com/qemu/qemu/settings/notifications