blob: 42034d9368c066d42b5e205851ccd9354cdea192 [file] [log] [blame]
Markus Armbruster6dd75472021-03-18 16:55:10 +01001# -*- Mode: Python -*-
Victor Toso7e7237c2021-12-20 15:56:24 +01002# vim: filetype=python
Markus Armbruster6dd75472021-03-18 16:55:10 +01003
4##
5# = Compatibility policy
6##
7
8##
9# @CompatPolicyInput:
10#
11# Policy for handling "funny" input.
12#
13# @accept: Accept silently
Markus Armbrustera937b6a2023-04-28 12:54:29 +020014#
Markus Armbruster6dd75472021-03-18 16:55:10 +010015# @reject: Reject with an error
Markus Armbrustera937b6a2023-04-28 12:54:29 +020016#
Markus Armbrusterdbb675c2021-03-18 16:55:19 +010017# @crash: abort() the process
Markus Armbruster6dd75472021-03-18 16:55:10 +010018#
19# Since: 6.0
20##
21{ 'enum': 'CompatPolicyInput',
Markus Armbrusterdbb675c2021-03-18 16:55:19 +010022 'data': [ 'accept', 'reject', 'crash' ] }
Markus Armbruster6dd75472021-03-18 16:55:10 +010023
24##
25# @CompatPolicyOutput:
26#
27# Policy for handling "funny" output.
28#
29# @accept: Pass on unchanged
Markus Armbrustera937b6a2023-04-28 12:54:29 +020030#
Markus Armbruster6dd75472021-03-18 16:55:10 +010031# @hide: Filter out
32#
33# Since: 6.0
34##
35{ 'enum': 'CompatPolicyOutput',
36 'data': [ 'accept', 'hide' ] }
37
38##
39# @CompatPolicy:
40#
41# Policy for handling deprecated management interfaces.
42#
43# This is intended for testing users of the management interfaces.
44#
45# Limitation: covers only syntactic aspects of QMP, i.e. stuff tagged
Markus Armbruster0a59c022023-10-09 13:04:49 +020046# with feature 'deprecated' or 'unstable'. We may want to extend it
47# to cover semantic aspects and CLI.
Markus Armbruster6dd75472021-03-18 16:55:10 +010048#
Markus Armbrusteraa237042021-10-25 06:24:04 +020049# Limitation: deprecated-output policy @hide is not implemented for
50# enumeration values. They behave the same as with policy @accept.
Markus Armbrusterb6c18752021-10-25 06:24:02 +020051#
Markus Armbruster6dd75472021-03-18 16:55:10 +010052# @deprecated-input: how to handle deprecated input (default 'accept')
Markus Armbrustera937b6a2023-04-28 12:54:29 +020053#
54# @deprecated-output: how to handle deprecated output (default
55# 'accept')
56#
Markus Armbruster57df0df2021-10-28 12:25:20 +020057# @unstable-input: how to handle unstable input (default 'accept')
Markus Armbrustera937b6a2023-04-28 12:54:29 +020058# (since 6.2)
59#
Markus Armbruster57df0df2021-10-28 12:25:20 +020060# @unstable-output: how to handle unstable output (default 'accept')
Markus Armbrustera937b6a2023-04-28 12:54:29 +020061# (since 6.2)
Markus Armbruster6dd75472021-03-18 16:55:10 +010062#
63# Since: 6.0
64##
65{ 'struct': 'CompatPolicy',
66 'data': { '*deprecated-input': 'CompatPolicyInput',
Markus Armbruster57df0df2021-10-28 12:25:20 +020067 '*deprecated-output': 'CompatPolicyOutput',
68 '*unstable-input': 'CompatPolicyInput',
69 '*unstable-output': 'CompatPolicyOutput' } }