qemu/qapi/qom.json
<<
>>
Prefs
   1# -*- Mode: Python -*-
   2# vim: filetype=python
   3#
   4# This work is licensed under the terms of the GNU GPL, version 2 or later.
   5# See the COPYING file in the top-level directory.
   6
   7{ 'include': 'authz.json' }
   8{ 'include': 'block-core.json' }
   9{ 'include': 'common.json' }
  10{ 'include': 'crypto.json' }
  11
  12##
  13# = QEMU Object Model (QOM)
  14##
  15
  16##
  17# @ObjectPropertyInfo:
  18#
  19# @name: the name of the property
  20#
  21# @type: the type of the property.  This will typically come in one of four
  22#        forms:
  23#
  24#        1) A primitive type such as 'u8', 'u16', 'bool', 'str', or 'double'.
  25#           These types are mapped to the appropriate JSON type.
  26#
  27#        2) A child type in the form 'child<subtype>' where subtype is a qdev
  28#           device type name.  Child properties create the composition tree.
  29#
  30#        3) A link type in the form 'link<subtype>' where subtype is a qdev
  31#           device type name.  Link properties form the device model graph.
  32#
  33# @description: if specified, the description of the property.
  34#
  35# @default-value: the default value, if any (since 5.0)
  36#
  37# Since: 1.2
  38##
  39{ 'struct': 'ObjectPropertyInfo',
  40  'data': { 'name': 'str',
  41            'type': 'str',
  42            '*description': 'str',
  43            '*default-value': 'any' } }
  44
  45##
  46# @qom-list:
  47#
  48# This command will list any properties of a object given a path in the object
  49# model.
  50#
  51# @path: the path within the object model.  See @qom-get for a description of
  52#        this parameter.
  53#
  54# Returns: a list of @ObjectPropertyInfo that describe the properties of the
  55#          object.
  56#
  57# Since: 1.2
  58#
  59# Example:
  60#
  61# -> { "execute": "qom-list",
  62#      "arguments": { "path": "/chardevs" } }
  63# <- { "return": [ { "name": "type", "type": "string" },
  64#                  { "name": "parallel0", "type": "child<chardev-vc>" },
  65#                  { "name": "serial0", "type": "child<chardev-vc>" },
  66#                  { "name": "mon0", "type": "child<chardev-stdio>" } ] }
  67#
  68##
  69{ 'command': 'qom-list',
  70  'data': { 'path': 'str' },
  71  'returns': [ 'ObjectPropertyInfo' ],
  72  'allow-preconfig': true }
  73
  74##
  75# @qom-get:
  76#
  77# This command will get a property from a object model path and return the
  78# value.
  79#
  80# @path: The path within the object model.  There are two forms of supported
  81#        paths--absolute and partial paths.
  82#
  83#        Absolute paths are derived from the root object and can follow child<>
  84#        or link<> properties.  Since they can follow link<> properties, they
  85#        can be arbitrarily long.  Absolute paths look like absolute filenames
  86#        and are prefixed  with a leading slash.
  87#
  88#        Partial paths look like relative filenames.  They do not begin
  89#        with a prefix.  The matching rules for partial paths are subtle but
  90#        designed to make specifying objects easy.  At each level of the
  91#        composition tree, the partial path is matched as an absolute path.
  92#        The first match is not returned.  At least two matches are searched
  93#        for.  A successful result is only returned if only one match is
  94#        found.  If more than one match is found, a flag is return to
  95#        indicate that the match was ambiguous.
  96#
  97# @property: The property name to read
  98#
  99# Returns: The property value.  The type depends on the property
 100#          type. child<> and link<> properties are returned as #str
 101#          pathnames.  All integer property types (u8, u16, etc) are
 102#          returned as #int.
 103#
 104# Since: 1.2
 105#
 106# Example:
 107#
 108# 1. Use absolute path
 109#
 110# -> { "execute": "qom-get",
 111#      "arguments": { "path": "/machine/unattached/device[0]",
 112#                     "property": "hotplugged" } }
 113# <- { "return": false }
 114#
 115# 2. Use partial path
 116#
 117# -> { "execute": "qom-get",
 118#      "arguments": { "path": "unattached/sysbus",
 119#                     "property": "type" } }
 120# <- { "return": "System" }
 121#
 122##
 123{ 'command': 'qom-get',
 124  'data': { 'path': 'str', 'property': 'str' },
 125  'returns': 'any',
 126  'allow-preconfig': true }
 127
 128##
 129# @qom-set:
 130#
 131# This command will set a property from a object model path.
 132#
 133# @path: see @qom-get for a description of this parameter
 134#
 135# @property: the property name to set
 136#
 137# @value: a value who's type is appropriate for the property type.  See @qom-get
 138#         for a description of type mapping.
 139#
 140# Since: 1.2
 141#
 142# Example:
 143#
 144# -> { "execute": "qom-set",
 145#      "arguments": { "path": "/machine",
 146#                     "property": "graphics",
 147#                     "value": false } }
 148# <- { "return": {} }
 149#
 150##
 151{ 'command': 'qom-set',
 152  'data': { 'path': 'str', 'property': 'str', 'value': 'any' },
 153  'allow-preconfig': true }
 154
 155##
 156# @ObjectTypeInfo:
 157#
 158# This structure describes a search result from @qom-list-types
 159#
 160# @name: the type name found in the search
 161#
 162# @abstract: the type is abstract and can't be directly instantiated.
 163#            Omitted if false. (since 2.10)
 164#
 165# @parent: Name of parent type, if any (since 2.10)
 166#
 167# Since: 1.1
 168##
 169{ 'struct': 'ObjectTypeInfo',
 170  'data': { 'name': 'str', '*abstract': 'bool', '*parent': 'str' } }
 171
 172##
 173# @qom-list-types:
 174#
 175# This command will return a list of types given search parameters
 176#
 177# @implements: if specified, only return types that implement this type name
 178#
 179# @abstract: if true, include abstract types in the results
 180#
 181# Returns: a list of @ObjectTypeInfo or an empty list if no results are found
 182#
 183# Since: 1.1
 184##
 185{ 'command': 'qom-list-types',
 186  'data': { '*implements': 'str', '*abstract': 'bool' },
 187  'returns': [ 'ObjectTypeInfo' ],
 188  'allow-preconfig': true }
 189
 190##
 191# @qom-list-properties:
 192#
 193# List properties associated with a QOM object.
 194#
 195# @typename: the type name of an object
 196#
 197# Note: objects can create properties at runtime, for example to describe
 198#       links between different devices and/or objects. These properties
 199#       are not included in the output of this command.
 200#
 201# Returns: a list of ObjectPropertyInfo describing object properties
 202#
 203# Since: 2.12
 204##
 205{ 'command': 'qom-list-properties',
 206  'data': { 'typename': 'str'},
 207  'returns': [ 'ObjectPropertyInfo' ],
 208  'allow-preconfig': true }
 209
 210##
 211# @CanHostSocketcanProperties:
 212#
 213# Properties for can-host-socketcan objects.
 214#
 215# @if: interface name of the host system CAN bus to connect to
 216#
 217# @canbus: object ID of the can-bus object to connect to the host interface
 218#
 219# Since: 2.12
 220##
 221{ 'struct': 'CanHostSocketcanProperties',
 222  'data': { 'if': 'str',
 223            'canbus': 'str' } }
 224
 225##
 226# @ColoCompareProperties:
 227#
 228# Properties for colo-compare objects.
 229#
 230# @primary_in: name of the character device backend to use for the primary
 231#              input (incoming packets are redirected to @outdev)
 232#
 233# @secondary_in: name of the character device backend to use for secondary
 234#                input (incoming packets are only compared to the input on
 235#                @primary_in and then dropped)
 236#
 237# @outdev: name of the character device backend to use for output
 238#
 239# @iothread: name of the iothread to run in
 240#
 241# @notify_dev: name of the character device backend to be used to communicate
 242#              with the remote colo-frame (only for Xen COLO)
 243#
 244# @compare_timeout: the maximum time to hold a packet from @primary_in for
 245#                   comparison with an incoming packet on @secondary_in in
 246#                   milliseconds (default: 3000)
 247#
 248# @expired_scan_cycle: the interval at which colo-compare checks whether
 249#                      packets from @primary have timed out, in milliseconds
 250#                      (default: 3000)
 251#
 252# @max_queue_size: the maximum number of packets to keep in the queue for
 253#                  comparing with incoming packets from @secondary_in.  If the
 254#                  queue is full and additional packets are received, the
 255#                  additional packets are dropped. (default: 1024)
 256#
 257# @vnet_hdr_support: if true, vnet header support is enabled (default: false)
 258#
 259# Since: 2.8
 260##
 261{ 'struct': 'ColoCompareProperties',
 262  'data': { 'primary_in': 'str',
 263            'secondary_in': 'str',
 264            'outdev': 'str',
 265            'iothread': 'str',
 266            '*notify_dev': 'str',
 267            '*compare_timeout': 'uint64',
 268            '*expired_scan_cycle': 'uint32',
 269            '*max_queue_size': 'uint32',
 270            '*vnet_hdr_support': 'bool' } }
 271
 272##
 273# @CryptodevBackendProperties:
 274#
 275# Properties for cryptodev-backend and cryptodev-backend-builtin objects.
 276#
 277# @queues: the number of queues for the cryptodev backend. Ignored for
 278#          cryptodev-backend and must be 1 for cryptodev-backend-builtin.
 279#          (default: 1)
 280#
 281# Since: 2.8
 282##
 283{ 'struct': 'CryptodevBackendProperties',
 284  'data': { '*queues': 'uint32' } }
 285
 286##
 287# @CryptodevVhostUserProperties:
 288#
 289# Properties for cryptodev-vhost-user objects.
 290#
 291# @chardev: the name of a Unix domain socket character device that connects to
 292#           the vhost-user server
 293#
 294# Since: 2.12
 295##
 296{ 'struct': 'CryptodevVhostUserProperties',
 297  'base': 'CryptodevBackendProperties',
 298  'data': { 'chardev': 'str' } }
 299
 300##
 301# @DBusVMStateProperties:
 302#
 303# Properties for dbus-vmstate objects.
 304#
 305# @addr: the name of the DBus bus to connect to
 306#
 307# @id-list: a comma separated list of DBus IDs of helpers whose data should be
 308#           included in the VM state on migration
 309#
 310# Since: 5.0
 311##
 312{ 'struct': 'DBusVMStateProperties',
 313  'data': { 'addr': 'str' ,
 314            '*id-list': 'str' } }
 315
 316##
 317# @NetfilterInsert:
 318#
 319# Indicates where to insert a netfilter relative to a given other filter.
 320#
 321# @before: insert before the specified filter
 322#
 323# @behind: insert behind the specified filter
 324#
 325# Since: 5.0
 326##
 327{ 'enum': 'NetfilterInsert',
 328  'data': [ 'before', 'behind' ] }
 329
 330##
 331# @NetfilterProperties:
 332#
 333# Properties for objects of classes derived from netfilter.
 334#
 335# @netdev: id of the network device backend to filter
 336#
 337# @queue: indicates which queue(s) to filter (default: all)
 338#
 339# @status: indicates whether the filter is enabled ("on") or disabled ("off")
 340#          (default: "on")
 341#
 342# @position: specifies where the filter should be inserted in the filter list.
 343#            "head" means the filter is inserted at the head of the filter list,
 344#            before any existing filters.
 345#            "tail" means the filter is inserted at the tail of the filter list,
 346#            behind any existing filters (default).
 347#            "id=<id>" means the filter is inserted before or behind the filter
 348#            specified by <id>, depending on the @insert property.
 349#            (default: "tail")
 350#
 351# @insert: where to insert the filter relative to the filter given in @position.
 352#          Ignored if @position is "head" or "tail". (default: behind)
 353#
 354# Since: 2.5
 355##
 356{ 'struct': 'NetfilterProperties',
 357  'data': { 'netdev': 'str',
 358            '*queue': 'NetFilterDirection',
 359            '*status': 'str',
 360            '*position': 'str',
 361            '*insert': 'NetfilterInsert' } }
 362
 363##
 364# @FilterBufferProperties:
 365#
 366# Properties for filter-buffer objects.
 367#
 368# @interval: a non-zero interval in microseconds.  All packets arriving in the
 369#            given interval are delayed until the end of the interval.
 370#
 371# Since: 2.5
 372##
 373{ 'struct': 'FilterBufferProperties',
 374  'base': 'NetfilterProperties',
 375  'data': { 'interval': 'uint32' } }
 376
 377##
 378# @FilterDumpProperties:
 379#
 380# Properties for filter-dump objects.
 381#
 382# @file: the filename where the dumped packets should be stored
 383#
 384# @maxlen: maximum number of bytes in a packet that are stored (default: 65536)
 385#
 386# Since: 2.5
 387##
 388{ 'struct': 'FilterDumpProperties',
 389  'base': 'NetfilterProperties',
 390  'data': { 'file': 'str',
 391            '*maxlen': 'uint32' } }
 392
 393##
 394# @FilterMirrorProperties:
 395#
 396# Properties for filter-mirror objects.
 397#
 398# @outdev: the name of a character device backend to which all incoming packets
 399#          are mirrored
 400#
 401# @vnet_hdr_support: if true, vnet header support is enabled (default: false)
 402#
 403# Since: 2.6
 404##
 405{ 'struct': 'FilterMirrorProperties',
 406  'base': 'NetfilterProperties',
 407  'data': { 'outdev': 'str',
 408            '*vnet_hdr_support': 'bool' } }
 409
 410##
 411# @FilterRedirectorProperties:
 412#
 413# Properties for filter-redirector objects.
 414#
 415# At least one of @indev or @outdev must be present.  If both are present, they
 416# must not refer to the same character device backend.
 417#
 418# @indev: the name of a character device backend from which packets are
 419#         received and redirected to the filtered network device
 420#
 421# @outdev: the name of a character device backend to which all incoming packets
 422#          are redirected
 423#
 424# @vnet_hdr_support: if true, vnet header support is enabled (default: false)
 425#
 426# Since: 2.6
 427##
 428{ 'struct': 'FilterRedirectorProperties',
 429  'base': 'NetfilterProperties',
 430  'data': { '*indev': 'str',
 431            '*outdev': 'str',
 432            '*vnet_hdr_support': 'bool' } }
 433
 434##
 435# @FilterRewriterProperties:
 436#
 437# Properties for filter-rewriter objects.
 438#
 439# @vnet_hdr_support: if true, vnet header support is enabled (default: false)
 440#
 441# Since: 2.8
 442##
 443{ 'struct': 'FilterRewriterProperties',
 444  'base': 'NetfilterProperties',
 445  'data': { '*vnet_hdr_support': 'bool' } }
 446
 447##
 448# @InputBarrierProperties:
 449#
 450# Properties for input-barrier objects.
 451#
 452# @name: the screen name as declared in the screens section of barrier.conf
 453#
 454# @server: hostname of the Barrier server (default: "localhost")
 455#
 456# @port: TCP port of the Barrier server (default: "24800")
 457#
 458# @x-origin: x coordinate of the leftmost pixel on the guest screen
 459#            (default: "0")
 460#
 461# @y-origin: y coordinate of the topmost pixel on the guest screen
 462#            (default: "0")
 463#
 464# @width: the width of secondary screen in pixels (default: "1920")
 465#
 466# @height: the height of secondary screen in pixels (default: "1080")
 467#
 468# Since: 4.2
 469##
 470{ 'struct': 'InputBarrierProperties',
 471  'data': { 'name': 'str',
 472            '*server': 'str',
 473            '*port': 'str',
 474            '*x-origin': 'str',
 475            '*y-origin': 'str',
 476            '*width': 'str',
 477            '*height': 'str' } }
 478
 479##
 480# @InputLinuxProperties:
 481#
 482# Properties for input-linux objects.
 483#
 484# @evdev: the path of the host evdev device to use
 485#
 486# @grab_all: if true, grab is toggled for all devices (e.g. both keyboard and
 487#            mouse) instead of just one device (default: false)
 488#
 489# @repeat: enables auto-repeat events (default: false)
 490#
 491# @grab-toggle: the key or key combination that toggles device grab
 492#               (default: ctrl-ctrl)
 493#
 494# Since: 2.6
 495##
 496{ 'struct': 'InputLinuxProperties',
 497  'data': { 'evdev': 'str',
 498            '*grab_all': 'bool',
 499            '*repeat': 'bool',
 500            '*grab-toggle': 'GrabToggleKeys' } }
 501
 502##
 503# @IothreadProperties:
 504#
 505# Properties for iothread objects.
 506#
 507# @poll-max-ns: the maximum number of nanoseconds to busy wait for events.
 508#               0 means polling is disabled (default: 32768 on POSIX hosts,
 509#               0 otherwise)
 510#
 511# @poll-grow: the multiplier used to increase the polling time when the
 512#             algorithm detects it is missing events due to not polling long
 513#             enough. 0 selects a default behaviour (default: 0)
 514#
 515# @poll-shrink: the divisor used to decrease the polling time when the
 516#               algorithm detects it is spending too long polling without
 517#               encountering events. 0 selects a default behaviour (default: 0)
 518#
 519# @aio-max-batch: maximum number of requests in a batch for the AIO engine,
 520#                 0 means that the engine will use its default
 521#                 (default:0, since 6.1)
 522#
 523# Since: 2.0
 524##
 525{ 'struct': 'IothreadProperties',
 526  'data': { '*poll-max-ns': 'int',
 527            '*poll-grow': 'int',
 528            '*poll-shrink': 'int',
 529            '*aio-max-batch': 'int' } }
 530
 531##
 532# @MemoryBackendProperties:
 533#
 534# Properties for objects of classes derived from memory-backend.
 535#
 536# @merge: if true, mark the memory as mergeable (default depends on the machine
 537#         type)
 538#
 539# @dump: if true, include the memory in core dumps (default depends on the
 540#        machine type)
 541#
 542# @host-nodes: the list of NUMA host nodes to bind the memory to
 543#
 544# @policy: the NUMA policy (default: 'default')
 545#
 546# @prealloc: if true, preallocate memory (default: false)
 547#
 548# @prealloc-threads: number of CPU threads to use for prealloc (default: 1)
 549#
 550# @share: if false, the memory is private to QEMU; if true, it is shared
 551#         (default: false)
 552#
 553# @reserve: if true, reserve swap space (or huge pages) if applicable
 554#           (default: true) (since 6.1)
 555#
 556# @size: size of the memory region in bytes
 557#
 558# @x-use-canonical-path-for-ramblock-id: if true, the canoncial path is used
 559#                                        for ramblock-id. Disable this for 4.0
 560#                                        machine types or older to allow
 561#                                        migration with newer QEMU versions.
 562#                                        (default: false generally,
 563#                                        but true for machine types <= 4.0)
 564#
 565# Note: prealloc=true and reserve=false cannot be set at the same time. With
 566#       reserve=true, the behavior depends on the operating system: for example,
 567#       Linux will not reserve swap space for shared file mappings --
 568#       "not applicable". In contrast, reserve=false will bail out if it cannot
 569#       be configured accordingly.
 570#
 571# Since: 2.1
 572##
 573{ 'struct': 'MemoryBackendProperties',
 574  'data': { '*dump': 'bool',
 575            '*host-nodes': ['uint16'],
 576            '*merge': 'bool',
 577            '*policy': 'HostMemPolicy',
 578            '*prealloc': 'bool',
 579            '*prealloc-threads': 'uint32',
 580            '*share': 'bool',
 581            '*reserve': 'bool',
 582            'size': 'size',
 583            '*x-use-canonical-path-for-ramblock-id': 'bool' } }
 584
 585##
 586# @MemoryBackendFileProperties:
 587#
 588# Properties for memory-backend-file objects.
 589#
 590# @align: the base address alignment when QEMU mmap(2)s @mem-path. Some
 591#         backend stores specified by @mem-path require an alignment different
 592#         than the default one used by QEMU, e.g. the device DAX /dev/dax0.0
 593#         requires 2M alignment rather than 4K. In such cases, users can
 594#         specify the required alignment via this option.
 595#         0 selects a default alignment (currently the page size). (default: 0)
 596#
 597# @discard-data: if true, the file contents can be destroyed when QEMU exits,
 598#                to avoid unnecessarily flushing data to the backing file. Note
 599#                that ``discard-data`` is only an optimization, and QEMU might
 600#                not discard file contents if it aborts unexpectedly or is
 601#                terminated using SIGKILL. (default: false)
 602#
 603# @mem-path: the path to either a shared memory or huge page filesystem mount
 604#
 605# @pmem: specifies whether the backing file specified by @mem-path is in
 606#        host persistent memory that can be accessed using the SNIA NVM
 607#        programming model (e.g. Intel NVDIMM).
 608#
 609# @readonly: if true, the backing file is opened read-only; if false, it is
 610#            opened read-write. (default: false)
 611#
 612# Since: 2.1
 613##
 614{ 'struct': 'MemoryBackendFileProperties',
 615  'base': 'MemoryBackendProperties',
 616  'data': { '*align': 'size',
 617            '*discard-data': 'bool',
 618            'mem-path': 'str',
 619            '*pmem': { 'type': 'bool', 'if': 'CONFIG_LIBPMEM' },
 620            '*readonly': 'bool' } }
 621
 622##
 623# @MemoryBackendMemfdProperties:
 624#
 625# Properties for memory-backend-memfd objects.
 626#
 627# The @share boolean option is true by default with memfd.
 628#
 629# @hugetlb: if true, the file to be created resides in the hugetlbfs filesystem
 630#           (default: false)
 631#
 632# @hugetlbsize: the hugetlb page size on systems that support multiple hugetlb
 633#               page sizes (it must be a power of 2 value supported by the
 634#               system). 0 selects a default page size. This option is ignored
 635#               if @hugetlb is false. (default: 0)
 636#
 637# @seal: if true, create a sealed-file, which will block further resizing of
 638#        the memory (default: true)
 639#
 640# Since: 2.12
 641##
 642{ 'struct': 'MemoryBackendMemfdProperties',
 643  'base': 'MemoryBackendProperties',
 644  'data': { '*hugetlb': 'bool',
 645            '*hugetlbsize': 'size',
 646            '*seal': 'bool' } }
 647
 648##
 649# @MemoryBackendEpcProperties:
 650#
 651# Properties for memory-backend-epc objects.
 652#
 653# The @share boolean option is true by default with epc
 654#
 655# The @merge boolean option is false by default with epc
 656#
 657# The @dump boolean option is false by default with epc
 658#
 659# Since: 6.2
 660##
 661{ 'struct': 'MemoryBackendEpcProperties',
 662  'base': 'MemoryBackendProperties',
 663  'data': {} }
 664
 665##
 666# @PrManagerHelperProperties:
 667#
 668# Properties for pr-manager-helper objects.
 669#
 670# @path: the path to a Unix domain socket for connecting to the external helper
 671#
 672# Since: 2.11
 673##
 674{ 'struct': 'PrManagerHelperProperties',
 675  'data': { 'path': 'str' } }
 676
 677##
 678# @QtestProperties:
 679#
 680# Properties for qtest objects.
 681#
 682# @chardev: the chardev to be used to receive qtest commands on.
 683#
 684# @log: the path to a log file
 685#
 686# Since: 6.0
 687##
 688{ 'struct': 'QtestProperties',
 689        'data': { 'chardev': 'str',
 690                  '*log': 'str' } }
 691
 692##
 693# @RemoteObjectProperties:
 694#
 695# Properties for x-remote-object objects.
 696#
 697# @fd: file descriptor name previously passed via 'getfd' command
 698#
 699# @devid: the id of the device to be associated with the file descriptor
 700#
 701# Since: 6.0
 702##
 703{ 'struct': 'RemoteObjectProperties',
 704  'data': { 'fd': 'str', 'devid': 'str' } }
 705
 706##
 707# @RngProperties:
 708#
 709# Properties for objects of classes derived from rng.
 710#
 711# @opened: if true, the device is opened immediately when applying this option
 712#          and will probably fail when processing the next option. Don't use;
 713#          only provided for compatibility. (default: false)
 714#
 715# Features:
 716# @deprecated: Member @opened is deprecated.  Setting true doesn't make sense,
 717#              and false is already the default.
 718#
 719# Since: 1.3
 720##
 721{ 'struct': 'RngProperties',
 722  'data': { '*opened': { 'type': 'bool', 'features': ['deprecated'] } } }
 723
 724##
 725# @RngEgdProperties:
 726#
 727# Properties for rng-egd objects.
 728#
 729# @chardev: the name of a character device backend that provides the connection
 730#           to the RNG daemon
 731#
 732# Since: 1.3
 733##
 734{ 'struct': 'RngEgdProperties',
 735  'base': 'RngProperties',
 736  'data': { 'chardev': 'str' } }
 737
 738##
 739# @RngRandomProperties:
 740#
 741# Properties for rng-random objects.
 742#
 743# @filename: the filename of the device on the host to obtain entropy from
 744#            (default: "/dev/urandom")
 745#
 746# Since: 1.3
 747##
 748{ 'struct': 'RngRandomProperties',
 749  'base': 'RngProperties',
 750  'data': { '*filename': 'str' } }
 751
 752##
 753# @SevGuestProperties:
 754#
 755# Properties for sev-guest objects.
 756#
 757# @sev-device: SEV device to use (default: "/dev/sev")
 758#
 759# @dh-cert-file: guest owners DH certificate (encoded with base64)
 760#
 761# @session-file: guest owners session parameters (encoded with base64)
 762#
 763# @policy: SEV policy value (default: 0x1)
 764#
 765# @handle: SEV firmware handle (default: 0)
 766#
 767# @cbitpos: C-bit location in page table entry (default: 0)
 768#
 769# @reduced-phys-bits: number of bits in physical addresses that become
 770#                     unavailable when SEV is enabled
 771#
 772# @kernel-hashes: if true, add hashes of kernel/initrd/cmdline to a
 773#                 designated guest firmware page for measured boot
 774#                 with -kernel (default: false) (since 6.2)
 775#
 776# Since: 2.12
 777##
 778{ 'struct': 'SevGuestProperties',
 779  'data': { '*sev-device': 'str',
 780            '*dh-cert-file': 'str',
 781            '*session-file': 'str',
 782            '*policy': 'uint32',
 783            '*handle': 'uint32',
 784            '*cbitpos': 'uint32',
 785            'reduced-phys-bits': 'uint32',
 786            '*kernel-hashes': 'bool' } }
 787
 788##
 789# @ObjectType:
 790#
 791# Features:
 792# @unstable: Member @x-remote-object is experimental.
 793#
 794# Since: 6.0
 795##
 796{ 'enum': 'ObjectType',
 797  'data': [
 798    'authz-list',
 799    'authz-listfile',
 800    'authz-pam',
 801    'authz-simple',
 802    'can-bus',
 803    { 'name': 'can-host-socketcan',
 804      'if': 'CONFIG_LINUX' },
 805    'colo-compare',
 806    'cryptodev-backend',
 807    'cryptodev-backend-builtin',
 808    { 'name': 'cryptodev-vhost-user',
 809      'if': 'CONFIG_VHOST_CRYPTO' },
 810    'dbus-vmstate',
 811    'filter-buffer',
 812    'filter-dump',
 813    'filter-mirror',
 814    'filter-redirector',
 815    'filter-replay',
 816    'filter-rewriter',
 817    'input-barrier',
 818    { 'name': 'input-linux',
 819      'if': 'CONFIG_LINUX' },
 820    'iothread',
 821    { 'name': 'memory-backend-epc',
 822      'if': 'CONFIG_LINUX' },
 823    'memory-backend-file',
 824    { 'name': 'memory-backend-memfd',
 825      'if': 'CONFIG_LINUX' },
 826    'memory-backend-ram',
 827    'pef-guest',
 828    { 'name': 'pr-manager-helper',
 829      'if': 'CONFIG_LINUX' },
 830    'qtest',
 831    'rng-builtin',
 832    'rng-egd',
 833    { 'name': 'rng-random',
 834      'if': 'CONFIG_POSIX' },
 835    'secret',
 836    { 'name': 'secret_keyring',
 837      'if': 'CONFIG_SECRET_KEYRING' },
 838    'sev-guest',
 839    's390-pv-guest',
 840    'throttle-group',
 841    'tls-creds-anon',
 842    'tls-creds-psk',
 843    'tls-creds-x509',
 844    'tls-cipher-suites',
 845    { 'name': 'x-remote-object', 'features': [ 'unstable' ] }
 846  ] }
 847
 848##
 849# @ObjectOptions:
 850#
 851# Describes the options of a user creatable QOM object.
 852#
 853# @qom-type: the class name for the object to be created
 854#
 855# @id: the name of the new object
 856#
 857# Since: 6.0
 858##
 859{ 'union': 'ObjectOptions',
 860  'base': { 'qom-type': 'ObjectType',
 861            'id': 'str' },
 862  'discriminator': 'qom-type',
 863  'data': {
 864      'authz-list':                 'AuthZListProperties',
 865      'authz-listfile':             'AuthZListFileProperties',
 866      'authz-pam':                  'AuthZPAMProperties',
 867      'authz-simple':               'AuthZSimpleProperties',
 868      'can-host-socketcan':         { 'type': 'CanHostSocketcanProperties',
 869                                      'if': 'CONFIG_LINUX' },
 870      'colo-compare':               'ColoCompareProperties',
 871      'cryptodev-backend':          'CryptodevBackendProperties',
 872      'cryptodev-backend-builtin':  'CryptodevBackendProperties',
 873      'cryptodev-vhost-user':       { 'type': 'CryptodevVhostUserProperties',
 874                                      'if': 'CONFIG_VHOST_CRYPTO' },
 875      'dbus-vmstate':               'DBusVMStateProperties',
 876      'filter-buffer':              'FilterBufferProperties',
 877      'filter-dump':                'FilterDumpProperties',
 878      'filter-mirror':              'FilterMirrorProperties',
 879      'filter-redirector':          'FilterRedirectorProperties',
 880      'filter-replay':              'NetfilterProperties',
 881      'filter-rewriter':            'FilterRewriterProperties',
 882      'input-barrier':              'InputBarrierProperties',
 883      'input-linux':                { 'type': 'InputLinuxProperties',
 884                                      'if': 'CONFIG_LINUX' },
 885      'iothread':                   'IothreadProperties',
 886      'memory-backend-epc':         { 'type': 'MemoryBackendEpcProperties',
 887                                      'if': 'CONFIG_LINUX' },
 888      'memory-backend-file':        'MemoryBackendFileProperties',
 889      'memory-backend-memfd':       { 'type': 'MemoryBackendMemfdProperties',
 890                                      'if': 'CONFIG_LINUX' },
 891      'memory-backend-ram':         'MemoryBackendProperties',
 892      'pr-manager-helper':          { 'type': 'PrManagerHelperProperties',
 893                                      'if': 'CONFIG_LINUX' },
 894      'qtest':                      'QtestProperties',
 895      'rng-builtin':                'RngProperties',
 896      'rng-egd':                    'RngEgdProperties',
 897      'rng-random':                 { 'type': 'RngRandomProperties',
 898                                      'if': 'CONFIG_POSIX' },
 899      'secret':                     'SecretProperties',
 900      'secret_keyring':             { 'type': 'SecretKeyringProperties',
 901                                      'if': 'CONFIG_SECRET_KEYRING' },
 902      'sev-guest':                  'SevGuestProperties',
 903      'throttle-group':             'ThrottleGroupProperties',
 904      'tls-creds-anon':             'TlsCredsAnonProperties',
 905      'tls-creds-psk':              'TlsCredsPskProperties',
 906      'tls-creds-x509':             'TlsCredsX509Properties',
 907      'tls-cipher-suites':          'TlsCredsProperties',
 908      'x-remote-object':            'RemoteObjectProperties'
 909  } }
 910
 911##
 912# @object-add:
 913#
 914# Create a QOM object.
 915#
 916# Returns: Nothing on success
 917#          Error if @qom-type is not a valid class name
 918#
 919# Since: 2.0
 920#
 921# Example:
 922#
 923# -> { "execute": "object-add",
 924#      "arguments": { "qom-type": "rng-random", "id": "rng1",
 925#                     "filename": "/dev/hwrng" } }
 926# <- { "return": {} }
 927#
 928##
 929{ 'command': 'object-add', 'data': 'ObjectOptions', 'boxed': true,
 930  'allow-preconfig': true }
 931
 932##
 933# @object-del:
 934#
 935# Remove a QOM object.
 936#
 937# @id: the name of the QOM object to remove
 938#
 939# Returns: Nothing on success
 940#          Error if @id is not a valid id for a QOM object
 941#
 942# Since: 2.0
 943#
 944# Example:
 945#
 946# -> { "execute": "object-del", "arguments": { "id": "rng1" } }
 947# <- { "return": {} }
 948#
 949##
 950{ 'command': 'object-del', 'data': {'id': 'str'},
 951  'allow-preconfig': true }
 952