Merge remote-tracking branch 'remotes/rth/tags/pull-tcg-20210921' into staging
[qemu.git] / qapi / compat.json
1 # -*- Mode: Python -*-
2
3 ##
4 # = Compatibility policy
5 ##
6
7 ##
8 # @CompatPolicyInput:
9 #
10 # Policy for handling "funny" input.
11 #
12 # @accept: Accept silently
13 # @reject: Reject with an error
14 # @crash: abort() the process
15 #
16 # Since: 6.0
17 ##
18 { 'enum': 'CompatPolicyInput',
19   'data': [ 'accept', 'reject', 'crash' ] }
20
21 ##
22 # @CompatPolicyOutput:
23 #
24 # Policy for handling "funny" output.
25 #
26 # @accept: Pass on unchanged
27 # @hide: Filter out
28 #
29 # Since: 6.0
30 ##
31 { 'enum': 'CompatPolicyOutput',
32   'data': [ 'accept', 'hide' ] }
33
34 ##
35 # @CompatPolicy:
36 #
37 # Policy for handling deprecated management interfaces.
38 #
39 # This is intended for testing users of the management interfaces.
40 #
41 # Limitation: covers only syntactic aspects of QMP, i.e. stuff tagged
42 # with feature 'deprecated'.  We may want to extend it to cover
43 # semantic aspects, CLI, and experimental features.
44 #
45 # @deprecated-input: how to handle deprecated input (default 'accept')
46 # @deprecated-output: how to handle deprecated output (default 'accept')
47 #
48 # Since: 6.0
49 ##
50 { 'struct': 'CompatPolicy',
51   'data': { '*deprecated-input': 'CompatPolicyInput',
52             '*deprecated-output': 'CompatPolicyOutput' } }