aboutsummaryrefslogtreecommitdiff
path: root/qapi
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2024-03-25 11:45:04 +0100
committerMarkus Armbruster <armbru@redhat.com>2024-03-26 06:36:08 +0100
commit1de759534de1a9a76bd72678d0290ce5ee00de25 (patch)
tree465dd077f266ddfcdea12140946a498f83f32f68 /qapi
parentb2913cc2a1825d70b9985613447b26d672df5418 (diff)
downloadqemu-1de759534de1a9a76bd72678d0290ce5ee00de25.zip
qemu-1de759534de1a9a76bd72678d0290ce5ee00de25.tar.gz
qemu-1de759534de1a9a76bd72678d0290ce5ee00de25.tar.bz2
qapi: document leftover members in qapi/stats.json
Suggested-by: Markus Armbruster <armbru@redhat.com> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com> Message-ID: <20240325104504.1358734-1-pbonzini@redhat.com> Reviewed-by: Markus Armbruster <armbru@redhat.com> [Update qapi/pragma.json] Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'qapi')
-rw-r--r--qapi/pragma.json5
-rw-r--r--qapi/stats.json14
2 files changed, 10 insertions, 9 deletions
diff --git a/qapi/pragma.json b/qapi/pragma.json
index 1a30298..99e4052 100644
--- a/qapi/pragma.json
+++ b/qapi/pragma.json
@@ -75,8 +75,6 @@
'Qcow2OverlapCheckFlags',
'RbdAuthMode',
'RbdImageEncryptionFormat',
- 'StatsFilter',
- 'StatsValue',
'String',
'StringWrapper',
'SysEmuTarget',
@@ -91,8 +89,7 @@
'query-cpu-model-comparison',
'query-cpu-model-expansion',
'query-rocker',
- 'query-rocker-ports',
- 'query-stats-schemas' ],
+ 'query-rocker-ports' ],
# Externally visible types whose member names may use uppercase
'member-name-exceptions': [ # visible in:
'ACPISlotType', # query-acpi-ospm-status
diff --git a/qapi/stats.json b/qapi/stats.json
index ce9d816..578b52c 100644
--- a/qapi/stats.json
+++ b/qapi/stats.json
@@ -114,13 +114,13 @@
#
# The arguments to the query-stats command; specifies a target for
# which to request statistics and optionally the required subset of
-# information for that target:
+# information for that target.
#
-# - which vCPUs to request statistics for
-# - which providers to request statistics from
-# - which named values to return within each provider
+# @target: the kind of objects to query. Note that each possible
+# target may enable additional filtering options
#
-# @target: the kind of objects to query
+# @providers: which providers to request statistics from, and optionally
+# which named values to return within each provider
#
# Since: 7.1
##
@@ -136,6 +136,8 @@
#
# @scalar: single unsigned 64-bit integers.
#
+# @boolean: single boolean value.
+#
# @list: list of unsigned 64-bit integers (used for histograms).
#
# Since: 7.1
@@ -254,6 +256,8 @@
#
# Return the schema for all available runtime-collected statistics.
#
+# @provider: a provider to restrict the query to.
+#
# Note: runtime-collected statistics and their names fall outside
# QEMU's usual deprecation policies. QEMU will try to keep the
# set of available data stable, together with their names, but