xref: /openbmc/qemu/qapi/compat.json (revision 0d70c5aa1bbfb0f5099d53d6e084337a8246cc0c)
1# -*- Mode: Python -*-
2# vim: filetype=python
3
4##
5# ********************
6# Compatibility policy
7# ********************
8##
9
10##
11# @CompatPolicyInput:
12#
13# Policy for handling "funny" input.
14#
15# @accept: Accept silently
16#
17# @reject: Reject with an error
18#
19# @crash: abort() the process
20#
21# Since: 6.0
22##
23{ 'enum': 'CompatPolicyInput',
24  'data': [ 'accept', 'reject', 'crash' ] }
25
26##
27# @CompatPolicyOutput:
28#
29# Policy for handling "funny" output.
30#
31# @accept: Pass on unchanged
32#
33# @hide: Filter out
34#
35# Since: 6.0
36##
37{ 'enum': 'CompatPolicyOutput',
38  'data': [ 'accept', 'hide' ] }
39
40##
41# @CompatPolicy:
42#
43# Policy for handling deprecated management interfaces.
44#
45# This is intended for testing users of the management interfaces.
46#
47# Limitation: covers only syntactic aspects of QMP, i.e. stuff tagged
48# with feature 'deprecated' or 'unstable'.  We may want to extend it
49# to cover semantic aspects and CLI.
50#
51# Limitation: deprecated-output policy @hide is not implemented for
52# enumeration values.  They behave the same as with policy @accept.
53#
54# @deprecated-input: how to handle deprecated input (default 'accept')
55#
56# @deprecated-output: how to handle deprecated output (default
57#     'accept')
58#
59# @unstable-input: how to handle unstable input (default 'accept')
60#     (since 6.2)
61#
62# @unstable-output: how to handle unstable output (default 'accept')
63#     (since 6.2)
64#
65# Since: 6.0
66##
67{ 'struct': 'CompatPolicy',
68  'data': { '*deprecated-input': 'CompatPolicyInput',
69            '*deprecated-output': 'CompatPolicyOutput',
70            '*unstable-input': 'CompatPolicyInput',
71            '*unstable-output': 'CompatPolicyOutput' } }
72