blob: df7d1109c3c8d2abb9cd19e4a8719de533fc4c89 [file]
# -*- Mode: Python -*-
# vim: filetype=python
##
# ********************
# Compatibility policy
# ********************
##
##
# @CompatPolicyInput:
# Policy for handling "funny" input.
#
# @accept: Accept silently
#
# @reject: Reject with an error
#
# @crash: abort() the process
#
# @warn: Accept with warnings printed to stderr (Since: 11.2)
#
# .. note:: at this time, warnings will be printed on every policy
# check failure rather than once only.
#
# Since: 6.0
##
{ 'enum': 'CompatPolicyInput',
'data': [ 'accept', 'reject', 'crash', 'warn' ] }
##
# @CompatPolicyOutput:
# Policy for handling "funny" output.
#
# @accept: Pass on unchanged
#
# @hide: Filter out
#
# Since: 6.0
##
{ 'enum': 'CompatPolicyOutput',
'data': [ 'accept', 'hide' ] }
##
# @CompatPolicy:
# Policy for handling problematic management interfaces.
#
# This is intended for testing users of the management interfaces.
#
# @deprecated-input: how to handle deprecated input (default 'accept')
#
# @deprecated-output: how to handle deprecated output (default
# 'accept')
#
# @unstable-input: how to handle unstable input (default 'accept')
# (since 6.2)
#
# @unstable-output: how to handle unstable output (default 'accept')
# (since 6.2)
#
# @insecure-input: how to handle types that are not declared secure
# (default 'accept') (since 11.2)
#
# Limitation: @deprecated-input, @deprecated-output, @unstable-input,
# and @unstable-output cover only syntactic aspects of QMP, i.e. stuff
# tagged with feature 'deprecated' or 'unstable'. We may want to
# extend it to cover semantic aspects and CLI.
#
# Limitation: @deprecated-output policy @hide is not implemented for
# enumeration values. They behave the same as with policy @accept.
#
# Since: 6.0
##
{ 'struct': 'CompatPolicy',
'data': { '*deprecated-input': 'CompatPolicyInput',
'*deprecated-output': 'CompatPolicyOutput',
'*unstable-input': 'CompatPolicyInput',
'*unstable-output': 'CompatPolicyOutput',
'*insecure-input': 'CompatPolicyInput' } }