Skip to content
Snippets Groups Projects
  • Markus Armbruster's avatar
    6dd75472
    qemu-options: New -compat to set policy for deprecated interfaces · 6dd75472
    Markus Armbruster authored
    
    New option -compat lets you configure what to do when deprecated
    interfaces get used.  This is intended for testing users of the
    management interfaces.  It is experimental.
    
    -compat deprecated-input=<input-policy> configures what to do when
    deprecated input is received.  Input policy can be "accept" (accept
    silently), or "reject" (reject the request with an error).
    
    -compat deprecated-output=<out-policy> configures what to do when
    deprecated output is sent.  Output policy can be "accept" (pass on
    unchanged), or "hide" (filter out the deprecated parts).
    
    Default is "accept".  Policies other than "accept" are implemented
    later in this series.
    
    For now, -compat covers only syntactic aspects of QMP, i.e. stuff
    tagged with feature 'deprecated'.  We may want to extend it to cover
    semantic aspects, CLI, and experimental features.
    
    Note that there is no good way for management application to detect
    presence of -compat: it's not visible output of query-qmp-schema or
    query-command-line-options.  Tolerable, because it's meant for
    testing.  If running with -compat fails, skip the test.
    
    Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
    Reviewed-by: default avatarEric Blake <eblake@redhat.com>
    Message-Id: <20210318155519.1224118-3-armbru@redhat.com>
    6dd75472
    History
    qemu-options: New -compat to set policy for deprecated interfaces
    Markus Armbruster authored
    
    New option -compat lets you configure what to do when deprecated
    interfaces get used.  This is intended for testing users of the
    management interfaces.  It is experimental.
    
    -compat deprecated-input=<input-policy> configures what to do when
    deprecated input is received.  Input policy can be "accept" (accept
    silently), or "reject" (reject the request with an error).
    
    -compat deprecated-output=<out-policy> configures what to do when
    deprecated output is sent.  Output policy can be "accept" (pass on
    unchanged), or "hide" (filter out the deprecated parts).
    
    Default is "accept".  Policies other than "accept" are implemented
    later in this series.
    
    For now, -compat covers only syntactic aspects of QMP, i.e. stuff
    tagged with feature 'deprecated'.  We may want to extend it to cover
    semantic aspects, CLI, and experimental features.
    
    Note that there is no good way for management application to detect
    presence of -compat: it's not visible output of query-qmp-schema or
    query-command-line-options.  Tolerable, because it's meant for
    testing.  If running with -compat fails, skip the test.
    
    Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
    Reviewed-by: default avatarEric Blake <eblake@redhat.com>
    Message-Id: <20210318155519.1224118-3-armbru@redhat.com>