Skip to contentSkip to conversation

target/s390x: move @deprecated-props to CpuModelExpansion Info

PATCH In review Collin Walling 3 participants 12 messages Jul 26, 2024 – Jul 29, 2024

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 target/s390x: move @deprecated-props to CpuModelExpansion Info

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise. Move this field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

---
 qapi/machine-target.json         | 18 ++++++++++--------
 target/s390x/cpu_models_sysemu.c | 31 ++++++++++++++++++++-----------
 2 files changed, 30 insertions(+), 19 deletions(-)
qapi/machine-target.json +10 -8
index a552e2b0ce..09dec2b9bb 100644
@@ -20,17 +20,11 @@
 #
 # @props: a dictionary of QOM properties to be applied
 #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelInfo',
   'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
 ##
 # @CpuModelExpansionType:
@@ -248,10 +242,18 @@
 #
 # @model: the expanded CpuModelInfo.
 #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).
+#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            '*deprecated-props': ['str'] },
   'if': { 'any': [ 'TARGET_S390X',
                    'TARGET_I386',
                    'TARGET_ARM',
target/s390x/cpu_models_sysemu.c +20 -11
index 94dd798b4c..44e7587acb 100644
@@ -174,15 +174,11 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
                                 bool delta_changes)
 {
     QDict *qdict = qdict_new();
-    S390FeatBitmap bitmap, deprecated;
+    S390FeatBitmap bitmap;
 
     /* always fallback to the static base model */
     info->name = g_strdup_printf("%s-base", model->def->name);
 
-    /* features flagged as deprecated */
-    bitmap_zero(deprecated, S390_FEAT_MAX);
-    s390_get_deprecated_features(deprecated);
-
     if (delta_changes) {
         /* features deleted from the base feature set */
         bitmap_andnot(bitmap, model->def->base_feat, model->features,
@@ -197,9 +193,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
         if (!bitmap_empty(bitmap, S390_FEAT_MAX)) {
             s390_feat_bitmap_to_ascii(bitmap, qdict, qdict_add_enabled_feat);
         }
-
-        /* deprecated features that are a subset of the model's enabled features */
-        bitmap_and(deprecated, deprecated, model->features, S390_FEAT_MAX);
     } else {
         /* expand all features */
         s390_feat_bitmap_to_ascii(model->features, qdict,
@@ -213,9 +206,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
     } else {
         info->props = QOBJECT(qdict);
     }
-
-    s390_feat_bitmap_to_ascii(deprecated, &info->deprecated_props, list_add_feat);
-    info->has_deprecated_props = !!info->deprecated_props;
 }
 
 CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
@@ -226,6 +216,7 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     CpuModelExpansionInfo *expansion_info = NULL;
     S390CPUModel s390_model;
     bool delta_changes = false;
+    S390FeatBitmap deprecated_feats;
 
     /* convert it to our internal representation */
     cpu_model_from_info(&s390_model, model, "model", &err);
@@ -245,6 +236,24 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     expansion_info = g_new0(CpuModelExpansionInfo, 1);
     expansion_info->model = g_malloc0(sizeof(*expansion_info->model));
     cpu_info_from_model(expansion_info->model, &s390_model, delta_changes);
+
+    /* populated list of deprecated features */
+    bitmap_zero(deprecated_feats, S390_FEAT_MAX);
+    s390_get_deprecated_features(deprecated_feats);
+
+    if (delta_changes) {
+        /*
+         * Only populate deprecated features that are a
+         * subset of the features enabled on the CPU model.
+         */
+        bitmap_and(deprecated_feats, deprecated_feats,
+                   s390_model.features, S390_FEAT_MAX);
+    }
+
+    s390_feat_bitmap_to_ascii(deprecated_feats,
+                              &expansion_info->deprecated_props, list_add_feat);
+    expansion_info->has_deprecated_props = !!expansion_info->deprecated_props;
+
     return expansion_info;
 }
 
Signature · 1 line
2.45.1
#1 lore raw
Quoted 9 lines · Collin Walling

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise. Move this field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

Quoted 6 lines

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

Thanks, I modified the "References" section and converted it to a "Fixes:". It's now:

target/s390x: move @deprecated-props to CpuModelExpansion Info

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise. Move this field to the CpuModelExpansionInfo struct where is makes more sense.

This was identified late during review [1] and we have to fix it up while it's not part of an official QEMU release yet.

[1] https://lore.kernel.org/qemu-devel/[email protected]/

Message-ID: <[email protected]>

Fixes eed0e8ffa38f ("target/s390x: filter deprecated properties based on model expansion type")
[ david: add "Fixes", explain why fix is required now and reference to v3 ]

Can you take a quick peek at

	https://github.com/davidhildenbrand/qemu/tree/s390x-next

if everything is alright?

Signature · 3 lines
Cheers,

David / dhildenb
#2 lore raw
Quoted 20 lines · David Hildenbrand
Quoted 9 lines · Collin Walling

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise. Move this field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

Quoted 6 lines

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

Thanks, I modified the "References" section and converted it to a "Fixes:". It's now:

Quoted 6 lines

target/s390x: move @deprecated-props to CpuModelExpansion Info

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise. Move this field to the CpuModelExpansionInfo struct where is makes more sense.

s/is/it

Quoted 14 lines

This was identified late during review [1] and we have to fix it up while it's not part of an official QEMU release yet.

[1] https://lore.kernel.org/qemu-devel/[email protected]/

Message-ID: <[email protected]>

Fixes eed0e8ffa38f ("target/s390x: filter deprecated properties based on model expansion type")
[ david: add "Fixes", explain why fix is required now and reference to v3 ]
Quoted 4 lines

Can you take a quick peek at

	https://github.com/davidhildenbrand/qemu/tree/s390x-next

if everything is alright?

Aside from a typo (on my end), everything looks golden. Thanks, David!

Signature · 2 lines
Regards,
  Collin
#3 lore raw
In reply to Collin Walling
Quoted 3 lines · Collin Walling

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise.

Doesn't query-cpu-model-baseline also return it in its response? It seems to assume the "static" expansion type.

Quoted 52 lines

Move this
field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

---
 qapi/machine-target.json         | 18 ++++++++++--------
 target/s390x/cpu_models_sysemu.c | 31 ++++++++++++++++++++-----------
 2 files changed, 30 insertions(+), 19 deletions(-)
qapi/machine-target.json +7 -7
index a552e2b0ce..09dec2b9bb 100644
@@ -20,17 +20,11 @@
 #
 # @props: a dictionary of QOM properties to be applied
 #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelInfo',
   'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
 ##
 # @CpuModelExpansionType:
@@ -248,10 +242,18 @@
 #
 # @model: the expanded CpuModelInfo.
 #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).

qapi/machine-target.json line 259

Quoted 10 lines
qapi/machine-target.json +3 -1
+#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            '*deprecated-props': ['str'] },
   'if': { 'any': [ 'TARGET_S390X',
                    'TARGET_I386',
                    'TARGET_ARM',

This solves several interface problems:

1. Removes inappropriate @deprecated-props argument of query-cpu-model-comparison, query-cpu-model-expansion, query-cpu-model-baseline.

2. Removes @deprecated-props return of query-cpu-model-baseline.

3. Properly documents how @deprecated-props depends on the expansion type.

Remaining problem:

4. Only S390 implements this.

Suggest to capture 1-3 more clearly in the commit message, perhaps like this:

CpuModelInfo is used both as command argument and in command returns.

Its @deprecated-props array does not make any sense in arguments, and is silently ignored. We actually want it only as return value of query-cpu-model-expansion.

Move it from CpuModelInfo to CpuModelExpansionType, and document its dependence on expansion type propetly.

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

I recommend to make @deprecated-props mandatory rather than optional then.

Quoted 63 lines
target/s390x/cpu_models_sysemu.c +12 -11
index 94dd798b4c..44e7587acb 100644
@@ -174,15 +174,11 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
                                 bool delta_changes)
 {
     QDict *qdict = qdict_new();
-    S390FeatBitmap bitmap, deprecated;
+    S390FeatBitmap bitmap;
 
     /* always fallback to the static base model */
     info->name = g_strdup_printf("%s-base", model->def->name);
 
-    /* features flagged as deprecated */
-    bitmap_zero(deprecated, S390_FEAT_MAX);
-    s390_get_deprecated_features(deprecated);
-
     if (delta_changes) {
         /* features deleted from the base feature set */
         bitmap_andnot(bitmap, model->def->base_feat, model->features,
@@ -197,9 +193,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
         if (!bitmap_empty(bitmap, S390_FEAT_MAX)) {
             s390_feat_bitmap_to_ascii(bitmap, qdict, qdict_add_enabled_feat);
         }
-
-        /* deprecated features that are a subset of the model's enabled features */
-        bitmap_and(deprecated, deprecated, model->features, S390_FEAT_MAX);
     } else {
         /* expand all features */
         s390_feat_bitmap_to_ascii(model->features, qdict,
@@ -213,9 +206,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
     } else {
         info->props = QOBJECT(qdict);
     }
-
-    s390_feat_bitmap_to_ascii(deprecated, &info->deprecated_props, list_add_feat);
-    info->has_deprecated_props = !!info->deprecated_props;
 }
 
 CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
@@ -226,6 +216,7 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     CpuModelExpansionInfo *expansion_info = NULL;
     S390CPUModel s390_model;
     bool delta_changes = false;
+    S390FeatBitmap deprecated_feats;
 
     /* convert it to our internal representation */
     cpu_model_from_info(&s390_model, model, "model", &err);
@@ -245,6 +236,24 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     expansion_info = g_new0(CpuModelExpansionInfo, 1);
     expansion_info->model = g_malloc0(sizeof(*expansion_info->model));
     cpu_info_from_model(expansion_info->model, &s390_model, delta_changes);
+
+    /* populated list of deprecated features */
+    bitmap_zero(deprecated_feats, S390_FEAT_MAX);
+    s390_get_deprecated_features(deprecated_feats);
+
+    if (delta_changes) {
+        /*
+         * Only populate deprecated features that are a
+         * subset of the features enabled on the CPU model.
+         */

target/s390x/cpu_models_sysemu.c CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type, · line 258

Quoted 10 lines
target/s390x/cpu_models_sysemu.c +8 -0
+        bitmap_and(deprecated_feats, deprecated_feats,
+                   s390_model.features, S390_FEAT_MAX);
+    }
+
+    s390_feat_bitmap_to_ascii(deprecated_feats,
+                              &expansion_info->deprecated_props, list_add_feat);
+    expansion_info->has_deprecated_props = !!expansion_info->deprecated_props;
+
     return expansion_info;
 }

Implementation looks good to me.

#4 lore raw
Quoted 93 lines · Markus Armbruster
Quoted 3 lines · Collin Walling

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise.

Doesn't query-cpu-model-baseline also return it in its response? It seems to assume the "static" expansion type.

Quoted 52 lines

Move this
field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

---
  qapi/machine-target.json         | 18 ++++++++++--------
  target/s390x/cpu_models_sysemu.c | 31 ++++++++++++++++++++-----------
  2 files changed, 30 insertions(+), 19 deletions(-)
qapi/machine-target.json +7 -7
index a552e2b0ce..09dec2b9bb 100644
@@ -20,17 +20,11 @@
  #
  # @props: a dictionary of QOM properties to be applied
  #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelInfo',
    'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
  ##
  # @CpuModelExpansionType:
@@ -248,10 +242,18 @@
  #
  # @model: the expanded CpuModelInfo.
  #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).

qapi/machine-target.json line 259

Quoted 10 lines
qapi/machine-target.json +3 -1
+#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            '*deprecated-props': ['str'] },
    'if': { 'any': [ 'TARGET_S390X',
                     'TARGET_I386',
                     'TARGET_ARM',

This solves several interface problems:

1. Removes inappropriate @deprecated-props argument of query-cpu-model-comparison, query-cpu-model-expansion, query-cpu-model-baseline.

2. Removes @deprecated-props return of query-cpu-model-baseline.

3. Properly documents how @deprecated-props depends on the expansion type.

Remaining problem:

4. Only S390 implements this.

Suggest to capture 1-3 more clearly in the commit message, perhaps like this:

CpuModelInfo is used both as command argument and in command returns.

Quoted 6 lines

Its @deprecated-props array does not make any sense in arguments, and is silently ignored. We actually want it only as return value of query-cpu-model-expansion.

Move it from CpuModelInfo to CpuModelExpansionType, and document its dependence on expansion type propetly.

s/propetly/property/

Sounds good!

Quoted 4 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
 ##
 { 'struct': 'CpuModelExpansionInfo',
   'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
   'if': { 'any': [ 'TARGET_S390X',
                    'TARGET_I386',
                    'TARGET_ARM',

Should do the trick, right?

Quoted 2 lines

I recommend to make @deprecated-props mandatory rather than optional then.

Hm, does that make sense judging that previous implementations didn't expose it?

Signature · 3 lines
Cheers,

David / dhildenb
#5 lore raw
Quoted 94 lines · David Hildenbrand
Quoted 93 lines · Markus Armbruster
Quoted 3 lines · Collin Walling

The @deprecated-props array did not make any sense to be a member of the CpuModelInfo struct, since this field would only be populated by a query-cpu-model-expansion response and ignored otherwise.

Doesn't query-cpu-model-baseline also return it in its response? It seems to assume the "static" expansion type.

Quoted 52 lines

Move this
field to the CpuModelExpansionInfo struct where is makes more sense.

References:
- https://lists.gnu.org/archive/html/qemu-devel/2024-07/msg05996.html
- commit eed0e8ffa38f0695c0519508f6e4f5a3297cbd67

---

@David, the previous commit header did not align with the changes made here, so I tagged this as a "v1" but added the previous conversation as a reference. I hope this is appropriate?

---
  qapi/machine-target.json         | 18 ++++++++++--------
  target/s390x/cpu_models_sysemu.c | 31 ++++++++++++++++++++-----------
  2 files changed, 30 insertions(+), 19 deletions(-)
qapi/machine-target.json +7 -7
index a552e2b0ce..09dec2b9bb 100644
@@ -20,17 +20,11 @@
  #
  # @props: a dictionary of QOM properties to be applied
  #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelInfo',
    'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
  ##
  # @CpuModelExpansionType:
@@ -248,10 +242,18 @@
  #
  # @model: the expanded CpuModelInfo.
  #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).

qapi/machine-target.json line 259

Quoted 10 lines
qapi/machine-target.json +3 -1
+#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            '*deprecated-props': ['str'] },
    'if': { 'any': [ 'TARGET_S390X',
                     'TARGET_I386',
                     'TARGET_ARM',

This solves several interface problems:

1. Removes inappropriate @deprecated-props argument of query-cpu-model-comparison, query-cpu-model-expansion, query-cpu-model-baseline.

2. Removes @deprecated-props return of query-cpu-model-baseline.

3. Properly documents how @deprecated-props depends on the expansion type.

Remaining problem:

4. Only S390 implements this.

Suggest to capture 1-3 more clearly in the commit message, perhaps like this:

CpuModelInfo is used both as command argument and in command returns.

Quoted 8 lines
Quoted 6 lines

Its @deprecated-props array does not make any sense in arguments, and is silently ignored. We actually want it only as return value of query-cpu-model-expansion.

Move it from CpuModelInfo to CpuModelExpansionType, and document its dependence on expansion type propetly.

s/propetly/property/

Can't type.

Quoted 22 lines

Sounds good!

Quoted 4 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
  ##
  { 'struct': 'CpuModelExpansionInfo',
    'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
    'if': { 'any': [ 'TARGET_S390X',
                     'TARGET_I386',
                     'TARGET_ARM',
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Quoted 4 lines
Quoted 2 lines

I recommend to make @deprecated-props mandatory rather than optional then.

Hm, does that make sense judging that previous implementations didn't expose it?

Adding members to the return value is fine.

docs/devel/qapi-code-gen.rst section "Compatibility considerations"

Clients send commands with argument data, and receive command responses with return data and events with event data.

Adding opt-in functionality to the send direction is backwards
compatible: adding commands, optional arguments, enumeration values, union and alternate branches; turning an argument type into an alternate of that type; making mandatory arguments optional. Clients oblivious of the new functionality continue to work.

Incompatible changes include removing commands, command arguments, enumeration values, union and alternate branches, adding mandatory command arguments, and making optional arguments mandatory.

The specified behavior of an absent optional argument should remain the same. With proper documentation, this policy still allows some flexibility; for example, when an optional 'buffer-size' argument is specified to default to a sensible buffer size, the actual default value can still be changed. The specified default behavior is not the exact size of the buffer, only that the default size is sensible.

--> Adding functionality to the receive direction is generally backwards --> compatible: adding events, adding return and event data members. --> Clients are expected to ignore the ones they don't know.

Removing "unreachable" stuff like events that can't be triggered anymore, optional return or event data members that can't be sent anymore, and return or event data member (enumeration) values that can't be sent anymore makes no difference to clients, except for introspection. The latter can conceivably confuse clients, so tread carefully.

Incompatible changes include removing return and event data members.

Questions?

#6 lore raw
Quoted 19 lines
Quoted 19 lines
Quoted 3 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
   ##
   { 'struct': 'CpuModelExpansionInfo',
     'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
     'if': { 'any': [ 'TARGET_S390X',
                      'TARGET_I386',
                      'TARGET_ARM',
Quoted 3 lines
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Ack

[...]

Quoted 2 lines

Questions?

As clear as it can get, thanks! :)

That would leave us with:

From 8be206168e31b9c3ff89e2b99c57a85d30150194 Mon Sep 17 00:00:00 2001
From: Collin Walling <[email protected]>
Date: Fri, 26 Jul 2024 16:36:46 -0400
Subject: [PATCH] target/s390x: move @deprecated-props to CpuModelExpansion
Info

CpuModelInfo is used both as command argument and in command returns.

Its @deprecated-props array does not make any sense in arguments, and is silently ignored. We actually want it only as return value of query-cpu-model-expansion.

Move it from CpuModelInfo to CpuModelExpansionType, and document its dependence on expansion type property.

This was identified late during review [1] and we have to fix it up while it's not part of an official QEMU release yet.

[1] https://lore.kernel.org/qemu-devel/[email protected]/

Message-ID: <[email protected]>

Fixes eed0e8ffa38f ("target/s390x: filter deprecated properties based on model expansion type")

[ david: - add "Fixes", adjust description, reference v3 instead
- make property s390x-only and non-optional ]

---
 qapi/machine-target.json         | 19 +++++++++++--------
 target/s390x/cpu_models_sysemu.c | 29 ++++++++++++++++++-----------
 2 files changed, 29 insertions(+), 19 deletions(-)
qapi/machine-target.json +11 -8
index a552e2b0ce..00bbecc905 100644
@@ -20,17 +20,11 @@
 #
 # @props: a dictionary of QOM properties to be applied
 #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelInfo',
   'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
 ##
 # @CpuModelExpansionType:
@@ -248,10 +242,19 @@
 #
 # @model: the expanded CpuModelInfo.
 #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).
+#
 # Since: 2.8
 ##
 { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            'deprecated-props' : { 'type': ['str'],
+                                   'if': 'TARGET_S390X' } },
   'if': { 'any': [ 'TARGET_S390X',
                    'TARGET_I386',
                    'TARGET_ARM',
target/s390x/cpu_models_sysemu.c +18 -11
index 94dd798b4c..6c8e5c7260 100644
@@ -174,15 +174,11 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
                                 bool delta_changes)
 {
     QDict *qdict = qdict_new();
-    S390FeatBitmap bitmap, deprecated;
+    S390FeatBitmap bitmap;
 
     /* always fallback to the static base model */
     info->name = g_strdup_printf("%s-base", model->def->name);
 
-    /* features flagged as deprecated */
-    bitmap_zero(deprecated, S390_FEAT_MAX);
-    s390_get_deprecated_features(deprecated);
-
     if (delta_changes) {
         /* features deleted from the base feature set */
         bitmap_andnot(bitmap, model->def->base_feat, model->features,
@@ -197,9 +193,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
         if (!bitmap_empty(bitmap, S390_FEAT_MAX)) {
             s390_feat_bitmap_to_ascii(bitmap, qdict, qdict_add_enabled_feat);
         }
-
-        /* deprecated features that are a subset of the model's enabled features */
-        bitmap_and(deprecated, deprecated, model->features, S390_FEAT_MAX);
     } else {
         /* expand all features */
         s390_feat_bitmap_to_ascii(model->features, qdict,
@@ -213,9 +206,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
     } else {
         info->props = QOBJECT(qdict);
     }
-
-    s390_feat_bitmap_to_ascii(deprecated, &info->deprecated_props, list_add_feat);
-    info->has_deprecated_props = !!info->deprecated_props;
 }
 
 CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
@@ -226,6 +216,7 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     CpuModelExpansionInfo *expansion_info = NULL;
     S390CPUModel s390_model;
     bool delta_changes = false;
+    S390FeatBitmap deprecated_feats;
 
     /* convert it to our internal representation */
     cpu_model_from_info(&s390_model, model, "model", &err);
@@ -245,6 +236,22 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
     expansion_info = g_new0(CpuModelExpansionInfo, 1);
     expansion_info->model = g_malloc0(sizeof(*expansion_info->model));
     cpu_info_from_model(expansion_info->model, &s390_model, delta_changes);
+
+    /* populated list of deprecated features */
+    bitmap_zero(deprecated_feats, S390_FEAT_MAX);
+    s390_get_deprecated_features(deprecated_feats);
+
+    if (delta_changes) {
+        /*
+         * Only populate deprecated features that are a
+         * subset of the features enabled on the CPU model.
+         */
+        bitmap_and(deprecated_feats, deprecated_feats,
+                   s390_model.features, S390_FEAT_MAX);
+    }
+
+    s390_feat_bitmap_to_ascii(deprecated_feats,
+                              &expansion_info->deprecated_props, list_add_feat);
     return expansion_info;
 }
 
Signature · 7 lines
2.45.2


-- 
Cheers,

David / dhildenb
#7 lore raw
Quoted 25 lines · David Hildenbrand
Quoted 19 lines
Quoted 19 lines
Quoted 3 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
   ##
   { 'struct': 'CpuModelExpansionInfo',
     'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
     'if': { 'any': [ 'TARGET_S390X',
                      'TARGET_I386',
                      'TARGET_ARM',
Quoted 3 lines
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Ack

Quoted 8 lines

[...]

Quoted 2 lines

Questions?

As clear as it can get, thanks! :)

That would leave us with:

Looks good to me!

#8 lore raw
Quoted 30 lines · Markus Armbruster
Quoted 28 lines · David Hildenbrand
Quoted 19 lines
Quoted 19 lines
Quoted 3 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
   ##
   { 'struct': 'CpuModelExpansionInfo',
     'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
     'if': { 'any': [ 'TARGET_S390X',
                      'TARGET_I386',
                      'TARGET_ARM',
Quoted 3 lines
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Ack

[...]

Quoted 1 line
Quoted 9 lines
Quoted 5 lines
Quoted 1 line

Questions?

As clear as it can get, thanks! :)

That would leave us with:

Looks good to me!

Fine by me as well. Thanks you both for taking care of this.

Signature · 2 lines
Regards,
  Collin
#9 lore raw
Quoted 35 lines · Collin Walling
Quoted 34 lines · Markus Armbruster
Quoted 32 lines · David Hildenbrand
Quoted 19 lines
Quoted 19 lines
Quoted 3 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
    ##
    { 'struct': 'CpuModelExpansionInfo',
      'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
      'if': { 'any': [ 'TARGET_S390X',
                       'TARGET_I386',
                       'TARGET_ARM',
Quoted 3 lines
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Ack

[...]

Quoted 2 lines

Questions?

As clear as it can get, thanks! :)

Quoted 7 lines
Quoted 5 lines
Quoted 1 line

That would leave us with:

Looks good to me!

Fine by me as well. Thanks you both for taking care of this.

Okay, I'll let it sit like that in s390x-next for 1 day and then send a PR.

Thanks!

Signature · 3 lines
Cheers,

David / dhildenb
#10 lore raw
In reply to David Hildenbrand
Quoted 161 lines · David Hildenbrand
Quoted 19 lines
Quoted 19 lines
Quoted 3 lines

The simplest way to address 4 is to tack 'if': 'TARGET_S390X' to @deprecated-props.

qapi/machine-target.json +1 -1
index 09dec2b9bb..0be95d559c 100644
@@ -253,7 +253,7 @@
   ##
   { 'struct': 'CpuModelExpansionInfo',
     'data': { 'model': 'CpuModelInfo',
-            '*deprecated-props': ['str'] },
+            '*deprecated-props' : { 'type': ['str'], 'if': 'TARGET_S390X' } },
     'if': { 'any': [ 'TARGET_S390X',
                      'TARGET_I386',
                      'TARGET_ARM',
Quoted 3 lines
Quoted 1 line

Should do the trick, right?

Yes. Break the line before 'if', please.

Ack

[...]

Quoted 2 lines

Questions?

As clear as it can get, thanks! :)

That would leave us with:

From 8be206168e31b9c3ff89e2b99c57a85d30150194 Mon Sep 17 00:00:00 2001
From: Collin Walling <[email protected]>
Date: Fri, 26 Jul 2024 16:36:46 -0400
Subject: [PATCH] target/s390x: move @deprecated-props to CpuModelExpansion
Info

CpuModelInfo is used both as command argument and in command returns.

Its @deprecated-props array does not make any sense in arguments, and is silently ignored. We actually want it only as return value of query-cpu-model-expansion.

Move it from CpuModelInfo to CpuModelExpansionType, and document its dependence on expansion type property.

This was identified late during review [1] and we have to fix it up while it's not part of an official QEMU release yet.

[1] https://lore.kernel.org/qemu-devel/[email protected]/

Message-ID: <[email protected]>

Fixes eed0e8ffa38f ("target/s390x: filter deprecated properties based on model expansion type")

[ david: - add "Fixes", adjust description, reference v3 instead
- make property s390x-only and non-optional ]

---
  qapi/machine-target.json         | 19 +++++++++++--------
  target/s390x/cpu_models_sysemu.c | 29 ++++++++++++++++++-----------
  2 files changed, 29 insertions(+), 19 deletions(-)
qapi/machine-target.json +11 -8
index a552e2b0ce..00bbecc905 100644
@@ -20,17 +20,11 @@
  #
  # @props: a dictionary of QOM properties to be applied
  #
-# @deprecated-props: a list of properties that are flagged as deprecated
-#     by the CPU vendor.  These properties are either a subset of the
-#     properties enabled on the CPU model, or a set of properties
-#     deprecated across all models for the architecture.
-#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelInfo',
    'data': { 'name': 'str',
-            '*props': 'any',
-            '*deprecated-props': ['str'] } }
+            '*props': 'any' } }
 
  ##
  # @CpuModelExpansionType:
@@ -248,10 +242,19 @@
  #
  # @model: the expanded CpuModelInfo.
  #
+# @deprecated-props: a list of properties that are flagged as deprecated
+#     by the CPU vendor.  The list depends on the CpuModelExpansionType:
+#     "static" properties are a subset of the enabled-properties for
+#     the expanded model; "full" properties are a set of properties
+#     that are deprecated across all models for the architecture.
+#     (since: 9.1).
+#
  # Since: 2.8
  ##
  { 'struct': 'CpuModelExpansionInfo',
-  'data': { 'model': 'CpuModelInfo' },
+  'data': { 'model': 'CpuModelInfo',
+            'deprecated-props' : { 'type': ['str'],
+                                   'if': 'TARGET_S390X' } },
    'if': { 'any': [ 'TARGET_S390X',
                     'TARGET_I386',
                     'TARGET_ARM',
target/s390x/cpu_models_sysemu.c +2 -11
index 94dd798b4c..6c8e5c7260 100644
@@ -174,15 +174,11 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
                                  bool delta_changes)
  {
      QDict *qdict = qdict_new();
-    S390FeatBitmap bitmap, deprecated;
+    S390FeatBitmap bitmap;
 
      /* always fallback to the static base model */
      info->name = g_strdup_printf("%s-base", model->def->name);
 
-    /* features flagged as deprecated */
-    bitmap_zero(deprecated, S390_FEAT_MAX);
-    s390_get_deprecated_features(deprecated);
-
      if (delta_changes) {
          /* features deleted from the base feature set */
          bitmap_andnot(bitmap, model->def->base_feat, model->features,
@@ -197,9 +193,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
          if (!bitmap_empty(bitmap, S390_FEAT_MAX)) {
              s390_feat_bitmap_to_ascii(bitmap, qdict, qdict_add_enabled_feat);
          }
-
-        /* deprecated features that are a subset of the model's enabled features */
-        bitmap_and(deprecated, deprecated, model->features, S390_FEAT_MAX);
      } else {
          /* expand all features */
          s390_feat_bitmap_to_ascii(model->features, qdict,
@@ -213,9 +206,6 @@ static void cpu_info_from_model(CpuModelInfo *info, const S390CPUModel *model,
      } else {
          info->props = QOBJECT(qdict);
      }
-
-    s390_feat_bitmap_to_ascii(deprecated, &info->deprecated_props, list_add_feat);
-    info->has_deprecated_props = !!info->deprecated_props;
  }
 
  CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
@@ -226,6 +216,7 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
      CpuModelExpansionInfo *expansion_info = NULL;
      S390CPUModel s390_model;
      bool delta_changes = false;
+    S390FeatBitmap deprecated_feats;
 
      /* convert it to our internal representation */
      cpu_model_from_info(&s390_model, model, "model", &err);

target/s390x/cpu_models_sysemu.c CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type, · line 240

Quoted 5 lines
target/s390x/cpu_models_sysemu.c +2 -0
@@ -245,6 +236,22 @@ CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type,
      expansion_info = g_new0(CpuModelExpansionInfo, 1);
      expansion_info->model = g_malloc0(sizeof(*expansion_info->model));
      cpu_info_from_model(expansion_info->model, &s390_model, delta_changes);
+
+    /* populated list of deprecated features */

s/populated/populate

Quoted 7 lines
target/s390x/cpu_models_sysemu.c +7 -0
+    bitmap_zero(deprecated_feats, S390_FEAT_MAX);
+    s390_get_deprecated_features(deprecated_feats);
+
+    if (delta_changes) {
+        /*
+         * Only populate deprecated features that are a
+         * subset of the features enabled on the CPU model.

target/s390x/cpu_models_sysemu.c CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type, · line 257

Quoted 10 lines
target/s390x/cpu_models_sysemu.c +7 -0
+         */
+        bitmap_and(deprecated_feats, deprecated_feats,
+                   s390_model.features, S390_FEAT_MAX);
+    }
+
+    s390_feat_bitmap_to_ascii(deprecated_feats,
+                              &expansion_info->deprecated_props, list_add_feat);
      return expansion_info;
  }
 

Eh, just a small nit above due to a typo I made. Other than that, gave it all another run-through just in case and everything is still good.

Signature · 2 lines
Regards,
  Collin
#11 lore raw
Quoted 14 lines
Quoted 14 lines
target/s390x/cpu_models_sysemu.c +12 -0
+    bitmap_zero(deprecated_feats, S390_FEAT_MAX);
+    s390_get_deprecated_features(deprecated_feats);
+
+    if (delta_changes) {
+        /*
+         * Only populate deprecated features that are a
+         * subset of the features enabled on the CPU model.
+         */
+        bitmap_and(deprecated_feats, deprecated_feats,
+                   s390_model.features, S390_FEAT_MAX);
+    }
+
Quoted 9 lines

target/s390x/cpu_models_sysemu.c CpuModelExpansionInfo *qmp_query_cpu_model_expansion(CpuModelExpansionType type, · line 256

Quoted 5 lines
target/s390x/cpu_models_sysemu.c +2 -0
+    s390_feat_bitmap_to_ascii(deprecated_feats,
+                              &expansion_info->deprecated_props, list_add_feat);
       return expansion_info;
   }

Eh, just a small nit above due to a typo I made. Other than that, gave it all another run-through just in case and everything is still good.

Fixed up, thanks!

Signature · 3 lines
Cheers,

David / dhildenb