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


Reply via email to