[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 05/10] qapi: make the vcpu parameters deprecated for 8.1
From: |
Alex Bennée |
Subject: |
[PATCH 05/10] qapi: make the vcpu parameters deprecated for 8.1 |
Date: |
Thu, 20 Apr 2023 16:00:04 +0100 |
I don't think I can remove the parameters directly but certainly mark
them as deprecated.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
qapi/trace.json | 22 +++++++---------------
1 file changed, 7 insertions(+), 15 deletions(-)
diff --git a/qapi/trace.json b/qapi/trace.json
index 6c6982a587..74dd66ef4a 100644
--- a/qapi/trace.json
+++ b/qapi/trace.json
@@ -33,9 +33,9 @@
#
# @name: Event name.
# @state: Tracing state.
-# @vcpu: Whether this is a per-vCPU event (since 2.7).
+# @vcpu: Whether this is a per-vCPU event (deprecated since 8.1).
#
-# An event is per-vCPU if it has the "vcpu" property in the "trace-events"
+# There are no longer any events with the "vcpu" property in the "trace-events"
# files.
#
# Since: 2.2
@@ -49,19 +49,15 @@
# Query the state of events.
#
# @name: Event name pattern (case-sensitive glob).
-# @vcpu: The vCPU to query (any by default; since 2.7).
+# @vcpu: The vCPU to query (deprecated since 8.1).
#
# Returns: a list of @TraceEventInfo for the matching events
#
# An event is returned if:
#
# - its name matches the @name pattern, and
-# - if @vcpu is given, the event has the "vcpu" property.
#
-# Therefore, if @vcpu is given, the operation will only match
per-vCPU events,
-# returning their state on the specified vCPU. Special case: if @name
is an
-# exact match, @vcpu is given and the event does not have the "vcpu"
property,
-# an error is returned.
+# There are no longer any per-vCPU events
#
# Since: 2.2
#
@@ -84,16 +80,12 @@
# @name: Event name pattern (case-sensitive glob).
# @enable: Whether to enable tracing.
# @ignore-unavailable: Do not match unavailable events with @name.
-# @vcpu: The vCPU to act upon (all by default; since 2.7).
+# @vcpu: The vCPU to act upon (deprecated since 8.1).
#
# An event's state is modified if:
-# - its name matches the @name pattern, and
-# - if @vcpu is given, the event has the "vcpu" property.
+# - its name matches the @name pattern
#
-# Therefore, if @vcpu is given, the operation will only match per-vCPU events,
-# setting their state on the specified vCPU. Special case: if @name is an exact
-# match, @vcpu is given and the event does not have the "vcpu" property, an
-# error is returned.
+# There are no longer and per-vCPU events so specifying it will never match.
#
# Since: 2.2
#
--
2.39.2
- Re: [PATCH 09/10] hw/9pfs: use qemu_xxhash4, (continued)
- [PATCH 01/10] *-user: remove the guest_user_syscall tracepoints, Alex Bennée, 2023/04/20
- [PATCH 07/10] trace: remove control-vcpu.h, Alex Bennée, 2023/04/20
- [PATCH 02/10] trace-events: remove the remaining vcpu trace events, Alex Bennée, 2023/04/20
- [PATCH 10/10] xxhash: remove qemu_xxhash7, Alex Bennée, 2023/04/20
- [PATCH 08/10] tcg: remove the final vestiges of dstate, Alex Bennée, 2023/04/20
- [PATCH 05/10] qapi: make the vcpu parameters deprecated for 8.1,
Alex Bennée <=
- [PATCH 06/10] trace: remove code that depends on setting vcpu, Alex Bennée, 2023/04/20