dump-guest-memory: add "detach" flag for QMP/HMP interfaces.

[qemu.git] / qapi-schema.json

diff --git a/qapi-schema.json b/qapi-schema.json
index 702b7b5dbd4817e06928a8c631956a1d6cbd1090..caff5801e148ed527977c9e6ceca9d52c80dceb6 100644 (file)
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -295,8 +295,6 @@
 # @format: #optional data encoding (default 'utf8').
 #          - base64: data must be base64 encoded text.  Its binary
 #            decoding gets written.
 # @format: #optional data encoding (default 'utf8').
 #          - base64: data must be base64 encoded text.  Its binary
 #            decoding gets written.

-#            Bug: invalid base64 is currently not rejected.
-#            Whitespace *is* invalid.

 #          - utf8: data's UTF-8 encoding is written
 #          - data itself is always Unicode regardless of format, like
 #            any other string.
 #          - utf8: data's UTF-8 encoding is written
 #          - data itself is always Unicode regardless of format, like
 #            any other string.


@@ -430,6 +428,8 @@
 #
 # @active: in the process of doing migration.
 #
 #
 # @active: in the process of doing migration.
 #

+# @postcopy-active: like active, but now in postcopy mode. (since 2.5)
+#

 # @completed: migration is finished.
 #
 # @failed: some error occurred during migration process.
 # @completed: migration is finished.
 #
 # @failed: some error occurred during migration process.


@@ -439,7 +439,7 @@
 ##
 { 'enum': 'MigrationStatus',
   'data': [ 'none', 'setup', 'cancelling', 'cancelled',
 ##
 { 'enum': 'MigrationStatus',
   'data': [ 'none', 'setup', 'cancelling', 'cancelled',

-            'active', 'completed', 'failed' ] }
+            'active', 'postcopy-active', 'completed', 'failed' ] }

 
 ##
 # @MigrationInfo
 
 ##
 # @MigrationInfo


@@ -540,11 +540,15 @@
 # @auto-converge: If enabled, QEMU will automatically throttle down the guest
 #          to speed up convergence of RAM migration. (since 1.6)
 #
 # @auto-converge: If enabled, QEMU will automatically throttle down the guest
 #          to speed up convergence of RAM migration. (since 1.6)
 #

+# @x-postcopy-ram: Start executing on the migration target before all of RAM has
+#          been migrated, pulling the remaining pages along as needed. NOTE: If
+#          the migration fails during postcopy the VM will fail.  (since 2.5)
+#

 # Since: 1.2
 ##
 { 'enum': 'MigrationCapability',
   'data': ['xbzrle', 'rdma-pin-all', 'auto-converge', 'zero-blocks',
 # Since: 1.2
 ##
 { 'enum': 'MigrationCapability',
   'data': ['xbzrle', 'rdma-pin-all', 'auto-converge', 'zero-blocks',

-           'compress', 'events'] }
+           'compress', 'events', 'x-postcopy-ram'] }

 
 ##
 # @MigrationCapabilityStatus
 
 ##
 # @MigrationCapabilityStatus


@@ -697,6 +701,16 @@
   'data': { 'protocol': 'str', 'hostname': 'str', '*port': 'int',
             '*tls-port': 'int', '*cert-subject': 'str' } }
 
   'data': { 'protocol': 'str', 'hostname': 'str', '*port': 'int',
             '*tls-port': 'int', '*cert-subject': 'str' } }
 

+##
+# @migrate-start-postcopy
+#
+# Followup to a migration command to switch the migration to postcopy mode.
+# The x-postcopy-ram capability must be set before the original migration
+# command.
+#
+# Since: 2.5
+{ 'command': 'migrate-start-postcopy' }
+

 ##
 # @MouseInfo:
 #
 ##
 # @MouseInfo:
 #


@@ -728,43 +742,125 @@
 { 'command': 'query-mice', 'returns': ['MouseInfo'] }
 
 ##
 { 'command': 'query-mice', 'returns': ['MouseInfo'] }
 
 ##

-# @CpuInfo:
+# @CpuInfoArch:

 #
 #

-# Information about a virtual CPU
+# An enumeration of cpu types that enable additional information during
+# @query-cpus.
+#
+# Since: 2.6
+##
+{ 'enum': 'CpuInfoArch',
+  'data': ['x86', 'sparc', 'ppc', 'mips', 'tricore', 'other' ] }
+
+##
+# @CpuInfoBase:
+#
+# Common information about a virtual CPU

 #
 # @CPU: the index of the virtual CPU
 #
 #
 # @CPU: the index of the virtual CPU
 #

-# @current: this only exists for backwards compatible and should be ignored
+# @current: this only exists for backwards compatibility and should be ignored

 #
 # @halted: true if the virtual CPU is in the halt state.  Halt usually refers
 #          to a processor specific low power mode.
 #
 # @qom_path: path to the CPU object in the QOM tree (since 2.4)
 #
 #
 # @halted: true if the virtual CPU is in the halt state.  Halt usually refers
 #          to a processor specific low power mode.
 #
 # @qom_path: path to the CPU object in the QOM tree (since 2.4)
 #

-# @pc: #optional If the target is i386 or x86_64, this is the 64-bit instruction
-#                pointer.
-#                If the target is Sparc, this is the PC component of the
-#                instruction pointer.
-#
-# @nip: #optional If the target is PPC, the instruction pointer
-#
-# @npc: #optional If the target is Sparc, the NPC component of the instruction
-#                 pointer
-#
-# @PC: #optional If the target is MIPS, the instruction pointer
-#

 # @thread_id: ID of the underlying host thread
 #
 # @thread_id: ID of the underlying host thread
 #

+# @arch: architecture of the cpu, which determines which additional fields
+#        will be listed (since 2.6)
+#

 # Since: 0.14.0
 #
 # Notes: @halted is a transient state that changes frequently.  By the time the
 #        data is sent to the client, the guest may no longer be halted.
 ##
 # Since: 0.14.0
 #
 # Notes: @halted is a transient state that changes frequently.  By the time the
 #        data is sent to the client, the guest may no longer be halted.
 ##

-{ 'struct': 'CpuInfo',
+{ 'struct': 'CpuInfoBase',

   'data': {'CPU': 'int', 'current': 'bool', 'halted': 'bool',
   'data': {'CPU': 'int', 'current': 'bool', 'halted': 'bool',

-           'qom_path': 'str',
-           '*pc': 'int', '*nip': 'int', '*npc': 'int', '*PC': 'int',
-           'thread_id': 'int'} }
+           'qom_path': 'str', 'thread_id': 'int', 'arch': 'CpuInfoArch' } }
+
+##
+# @CpuInfo:
+#
+# Information about a virtual CPU
+#
+# Since: 0.14.0
+##
+{ 'union': 'CpuInfo', 'base': 'CpuInfoBase', 'discriminator': 'arch',
+  'data': { 'x86': 'CpuInfoX86',
+            'sparc': 'CpuInfoSPARC',
+            'ppc': 'CpuInfoPPC',
+            'mips': 'CpuInfoMIPS',
+            'tricore': 'CpuInfoTricore',
+            'other': 'CpuInfoOther' } }
+
+##
+# @CpuInfoX86:
+#
+# Additional information about a virtual i386 or x86_64 CPU
+#
+# @pc: the 64-bit instruction pointer
+#
+# Since 2.6
+##
+{ 'struct': 'CpuInfoX86', 'data': { 'pc': 'int' } }
+
+##
+# @CpuInfoSPARC:
+#
+# Additional information about a virtual SPARC CPU
+#
+# @pc: the PC component of the instruction pointer
+#
+# @npc: the NPC component of the instruction pointer
+#
+# Since 2.6
+##
+{ 'struct': 'CpuInfoSPARC', 'data': { 'pc': 'int', 'npc': 'int' } }
+
+##
+# @CpuInfoPPC:
+#
+# Additional information about a virtual PPC CPU
+#
+# @nip: the instruction pointer
+#
+# Since 2.6
+##
+{ 'struct': 'CpuInfoPPC', 'data': { 'nip': 'int' } }
+
+##
+# @CpuInfoMIPS:
+#
+# Additional information about a virtual MIPS CPU
+#
+# @PC: the instruction pointer
+#
+# Since 2.6
+##
+{ 'struct': 'CpuInfoMIPS', 'data': { 'PC': 'int' } }
+
+##
+# @CpuInfoTricore:
+#
+# Additional information about a virtual Tricore CPU
+#
+# @PC: the instruction pointer
+#
+# Since 2.6
+##
+{ 'struct': 'CpuInfoTricore', 'data': { 'PC': 'int' } }
+
+##
+# @CpuInfoOther:
+#
+# No additional information is available about the virtual CPU
+#
+# Since 2.6
+#
+##
+{ 'struct': 'CpuInfoOther', 'data': { } }

 
 ##
 # @query-cpus:
 
 ##
 # @query-cpus:


@@ -1519,6 +1615,26 @@
 { 'struct': 'Abort',
   'data': { } }
 
 { 'struct': 'Abort',
   'data': { } }
 

+##
+# @ActionCompletionMode
+#
+# An enumeration of Transactional completion modes.
+#
+# @individual: Do not attempt to cancel any other Actions if any Actions fail
+#              after the Transaction request succeeds. All Actions that
+#              can complete successfully will do so without waiting on others.
+#              This is the default.
+#
+# @grouped: If any Action fails after the Transaction succeeds, cancel all
+#           Actions. Actions do not complete until all Actions are ready to
+#           complete. May be rejected by Actions that do not support this
+#           completion mode.
+#
+# Since: 2.5
+##
+{ 'enum': 'ActionCompletionMode',
+  'data': [ 'individual', 'grouped' ] }
+

 ##
 # @TransactionAction
 #
 ##
 # @TransactionAction
 #


@@ -1531,16 +1647,39 @@
 # abort since 1.6
 # blockdev-snapshot-internal-sync since 1.7
 # blockdev-backup since 2.3
 # abort since 1.6
 # blockdev-snapshot-internal-sync since 1.7
 # blockdev-backup since 2.3

+# blockdev-snapshot since 2.5
+# block-dirty-bitmap-add since 2.5
+# block-dirty-bitmap-clear since 2.5

 ##
 { 'union': 'TransactionAction',
   'data': {
 ##
 { 'union': 'TransactionAction',
   'data': {

-       'blockdev-snapshot-sync': 'BlockdevSnapshot',
+       'blockdev-snapshot': 'BlockdevSnapshot',
+       'blockdev-snapshot-sync': 'BlockdevSnapshotSync',

        'drive-backup': 'DriveBackup',
        'blockdev-backup': 'BlockdevBackup',
        'abort': 'Abort',
        'drive-backup': 'DriveBackup',
        'blockdev-backup': 'BlockdevBackup',
        'abort': 'Abort',

-       'blockdev-snapshot-internal-sync': 'BlockdevSnapshotInternal'
+       'blockdev-snapshot-internal-sync': 'BlockdevSnapshotInternal',
+       'block-dirty-bitmap-add': 'BlockDirtyBitmapAdd',
+       'block-dirty-bitmap-clear': 'BlockDirtyBitmap'

    } }
 
    } }
 

+##
+# @TransactionProperties
+#
+# Optional arguments to modify the behavior of a Transaction.
+#
+# @completion-mode: #optional Controls how jobs launched asynchronously by
+#                   Actions will complete or fail as a group.
+#                   See @ActionCompletionMode for details.
+#
+# Since: 2.5
+##
+{ 'struct': 'TransactionProperties',
+  'data': {
+       '*completion-mode': 'ActionCompletionMode'
+  }
+}
+

 ##
 # @transaction
 #
 ##
 # @transaction
 #


@@ -1548,8 +1687,12 @@
 # operation fails, then the entire set of actions will be abandoned and the
 # appropriate error returned.
 #
 # operation fails, then the entire set of actions will be abandoned and the
 # appropriate error returned.
 #

-#  List of:
-#  @TransactionAction: information needed for the respective operation
+# @actions: List of @TransactionAction;
+#           information needed for the respective operations.
+#
+# @properties: #optional structure of additional options to control the
+#              execution of the transaction. See @TransactionProperties
+#              for additional detail.

 #
 # Returns: nothing on success
 #          Errors depend on the operations of the transaction
 #
 # Returns: nothing on success
 #          Errors depend on the operations of the transaction


@@ -1561,7 +1704,10 @@
 # Since 1.1
 ##
 { 'command': 'transaction',
 # Since 1.1
 ##
 { 'command': 'transaction',

-  'data': { 'actions': [ 'TransactionAction' ] } }
+  'data': { 'actions': [ 'TransactionAction' ],
+            '*properties': 'TransactionProperties'
+          }
+}

 
 ##
 # @human-monitor-command:
 
 ##
 # @human-monitor-command:


@@ -1842,8 +1988,10 @@
 #          device's password.  The behavior of reads and writes to the block
 #          device between when these calls are executed is undefined.
 #
 #          device's password.  The behavior of reads and writes to the block
 #          device between when these calls are executed is undefined.
 #

-# Notes:  It is strongly recommended that this interface is not used especially
-#         for changing block devices.
+# Notes:  This interface is deprecated, and it is strongly recommended that you
+#         avoid using it.  For changing block devices, use
+#         blockdev-change-medium; for changing VNC parameters, use
+#         change-vnc-password.

 #
 # Since: 0.14.0
 ##
 #
 # Since: 0.14.0
 ##


@@ -2021,8 +2169,7 @@
 # @dump-guest-memory
 #
 # Dump guest's memory to vmcore. It is a synchronous operation that can take
 # @dump-guest-memory
 #
 # Dump guest's memory to vmcore. It is a synchronous operation that can take

-# very long depending on the amount of guest memory. This command is only
-# supported on i386 and x86_64.
+# very long depending on the amount of guest memory.

 #
 # @paging: if true, do paging to get guest's memory mapping. This allows
 #          using gdb to process the core file.
 #
 # @paging: if true, do paging to get guest's memory mapping. This allows
 #          using gdb to process the core file.


@@ -2038,6 +2185,7 @@
 #             2. The guest can be in real-mode even if paging is enabled. For
 #                example, the guest uses ACPI to sleep, and ACPI sleep state
 #                goes in real-mode
 #             2. The guest can be in real-mode even if paging is enabled. For
 #                example, the guest uses ACPI to sleep, and ACPI sleep state
 #                goes in real-mode

+#             3. Currently only supported on i386 and x86_64.

 #
 # @protocol: the filename or file descriptor of the vmcore. The supported
 #            protocols are:
 #
 # @protocol: the filename or file descriptor of the vmcore. The supported
 #            protocols are:


@@ -2047,6 +2195,9 @@
 #            2. fd: the protocol starts with "fd:", and the following string
 #               is the fd's name.
 #
 #            2. fd: the protocol starts with "fd:", and the following string
 #               is the fd's name.
 #

+# @detach: #optional if true, QMP will return immediately rather than
+#          waiting for the dump to finish. (since 2.6).
+#

 # @begin: #optional if specified, the starting physical address.
 #
 # @length: #optional if specified, the memory size, in bytes. If you don't
 # @begin: #optional if specified, the starting physical address.
 #
 # @length: #optional if specified, the memory size, in bytes. If you don't


@@ -2063,8 +2214,9 @@
 # Since: 1.2
 ##
 { 'command': 'dump-guest-memory',
 # Since: 1.2
 ##
 { 'command': 'dump-guest-memory',

-  'data': { 'paging': 'bool', 'protocol': 'str', '*begin': 'int',
-            '*length': 'int', '*format': 'DumpGuestMemoryFormat' } }
+  'data': { 'paging': 'bool', 'protocol': 'str', '*detach': 'bool',
+            '*begin': 'int', '*length': 'int',
+            '*format': 'DumpGuestMemoryFormat'} }

 
 ##
 # @DumpGuestMemoryCapability:
 
 ##
 # @DumpGuestMemoryCapability:


@@ -2945,6 +3097,21 @@
 ##
 { 'command': 'screendump', 'data': {'filename': 'str'} }
 
 ##
 { 'command': 'screendump', 'data': {'filename': 'str'} }
 

+
+##
+# @ChardevCommon:
+#
+# Configuration shared across all chardev backends
+#
+# @logfile: #optional The name of a logfile to save output
+# @logappend: #optional true to append instead of truncate
+#             (default to false to truncate)
+#
+# Since: 2.6
+##
+{ 'struct': 'ChardevCommon', 'data': { '*logfile': 'str',
+                                       '*logappend': 'bool' } }
+

 ##
 # @ChardevFile:
 #
 ##
 # @ChardevFile:
 #


@@ -2952,11 +3119,15 @@
 #
 # @in:  #optional The name of the input file
 # @out: The name of the output file
 #
 # @in:  #optional The name of the input file
 # @out: The name of the output file

+# @append: #optional Open the file in append mode (default false to
+#          truncate) (Since 2.6)

 #
 # Since: 1.4
 ##
 { 'struct': 'ChardevFile', 'data': { '*in' : 'str',
 #
 # Since: 1.4
 ##
 { 'struct': 'ChardevFile', 'data': { '*in' : 'str',

-                                   'out' : 'str' } }
+                                   'out' : 'str',
+                                   '*append': 'bool' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevHostdev:
 
 ##
 # @ChardevHostdev:


@@ -2969,7 +3140,8 @@
 #
 # Since: 1.4
 ##
 #
 # Since: 1.4
 ##

-{ 'struct': 'ChardevHostdev', 'data': { 'device' : 'str' } }
+{ 'struct': 'ChardevHostdev', 'data': { 'device' : 'str' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevSocket:
 
 ##
 # @ChardevSocket:


@@ -2978,6 +3150,7 @@
 #
 # @addr: socket address to listen on (server=true)
 #        or connect to (server=false)
 #
 # @addr: socket address to listen on (server=true)
 #        or connect to (server=false)

+# @tls-creds: #optional the ID of the TLS credentials object (since 2.6)

 # @server: #optional create server socket (default: true)
 # @wait: #optional wait for incoming connection on server
 #        sockets (default: false).
 # @server: #optional create server socket (default: true)
 # @wait: #optional wait for incoming connection on server
 #        sockets (default: false).


@@ -2992,11 +3165,13 @@
 # Since: 1.4
 ##
 { 'struct': 'ChardevSocket', 'data': { 'addr'       : 'SocketAddress',
 # Since: 1.4
 ##
 { 'struct': 'ChardevSocket', 'data': { 'addr'       : 'SocketAddress',

+                                     '*tls-creds'  : 'str',

                                      '*server'    : 'bool',
                                      '*wait'      : 'bool',
                                      '*nodelay'   : 'bool',
                                      '*telnet'    : 'bool',
                                      '*server'    : 'bool',
                                      '*wait'      : 'bool',
                                      '*nodelay'   : 'bool',
                                      '*telnet'    : 'bool',

-                                     '*reconnect' : 'int' } }
+                                     '*reconnect' : 'int' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevUdp:
 
 ##
 # @ChardevUdp:


@@ -3009,7 +3184,8 @@
 # Since: 1.5
 ##
 { 'struct': 'ChardevUdp', 'data': { 'remote' : 'SocketAddress',
 # Since: 1.5
 ##
 { 'struct': 'ChardevUdp', 'data': { 'remote' : 'SocketAddress',

-                                  '*local' : 'SocketAddress' } }
+                                  '*local' : 'SocketAddress' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevMux:
 
 ##
 # @ChardevMux:


@@ -3020,7 +3196,8 @@
 #
 # Since: 1.5
 ##
 #
 # Since: 1.5
 ##

-{ 'struct': 'ChardevMux', 'data': { 'chardev' : 'str' } }
+{ 'struct': 'ChardevMux', 'data': { 'chardev' : 'str' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevStdio:
 
 ##
 # @ChardevStdio:


@@ -3033,7 +3210,9 @@
 #
 # Since: 1.5
 ##
 #
 # Since: 1.5
 ##

-{ 'struct': 'ChardevStdio', 'data': { '*signal' : 'bool' } }
+{ 'struct': 'ChardevStdio', 'data': { '*signal' : 'bool' },
+  'base': 'ChardevCommon' }
+

 
 ##
 # @ChardevSpiceChannel:
 
 ##
 # @ChardevSpiceChannel:


@@ -3044,7 +3223,8 @@
 #
 # Since: 1.5
 ##
 #
 # Since: 1.5
 ##

-{ 'struct': 'ChardevSpiceChannel', 'data': { 'type'  : 'str' } }
+{ 'struct': 'ChardevSpiceChannel', 'data': { 'type'  : 'str' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevSpicePort:
 
 ##
 # @ChardevSpicePort:


@@ -3055,7 +3235,8 @@
 #
 # Since: 1.5
 ##
 #
 # Since: 1.5
 ##

-{ 'struct': 'ChardevSpicePort', 'data': { 'fqdn'  : 'str' } }
+{ 'struct': 'ChardevSpicePort', 'data': { 'fqdn'  : 'str' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevVC:
 
 ##
 # @ChardevVC:


@@ -3072,7 +3253,8 @@
 { 'struct': 'ChardevVC', 'data': { '*width'  : 'int',
                                  '*height' : 'int',
                                  '*cols'   : 'int',
 { 'struct': 'ChardevVC', 'data': { '*width'  : 'int',
                                  '*height' : 'int',
                                  '*cols'   : 'int',

-                                 '*rows'   : 'int' } }
+                                 '*rows'   : 'int' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevRingbuf:
 
 ##
 # @ChardevRingbuf:


@@ -3083,7 +3265,8 @@
 #
 # Since: 1.5
 ##
 #
 # Since: 1.5
 ##

-{ 'struct': 'ChardevRingbuf', 'data': { '*size'  : 'int' } }
+{ 'struct': 'ChardevRingbuf', 'data': { '*size'  : 'int' },
+  'base': 'ChardevCommon' }

 
 ##
 # @ChardevBackend:
 
 ##
 # @ChardevBackend:


@@ -3092,7 +3275,8 @@
 #
 # Since: 1.4 (testdev since 2.2)
 ##
 #
 # Since: 1.4 (testdev since 2.2)
 ##

-{ 'struct': 'ChardevDummy', 'data': { } }
+{ 'struct': 'ChardevDummy', 'data': { },
+  'base': 'ChardevCommon' }

 
 { 'union': 'ChardevBackend', 'data': { 'file'   : 'ChardevFile',
                                        'serial' : 'ChardevHostdev',
 
 { 'union': 'ChardevBackend', 'data': { 'file'   : 'ChardevFile',
                                        'serial' : 'ChardevHostdev',


@@ -3511,16 +3695,22 @@
 # Button of a pointer input device (mouse, tablet).
 #
 # Since: 2.0
 # Button of a pointer input device (mouse, tablet).
 #
 # Since: 2.0

+#
+# Note that the spelling of these values may change when the
+# x-input-send-event is promoted out of experimental status.

 ##
 { 'enum'  : 'InputButton',
   'data'  : [ 'Left', 'Middle', 'Right', 'WheelUp', 'WheelDown' ] }
 
 ##
 ##
 { 'enum'  : 'InputButton',
   'data'  : [ 'Left', 'Middle', 'Right', 'WheelUp', 'WheelDown' ] }
 
 ##

-# @InputButton
+# @InputAxis

 #
 # Position axis of a pointer input device (mouse, tablet).
 #
 # Since: 2.0
 #
 # Position axis of a pointer input device (mouse, tablet).
 #
 # Since: 2.0

+#
+# Note that the spelling of these values may change when the
+# x-input-send-event is promoted out of experimental status.

 ##
 { 'enum'  : 'InputAxis',
   'data'  : [ 'X', 'Y' ] }
 ##
 { 'enum'  : 'InputAxis',
   'data'  : [ 'X', 'Y' ] }


@@ -3611,7 +3801,10 @@
 #
 # Since: 2.2
 #
 #
 # Since: 2.2
 #

-# Note: this command is experimental, and not a stable API.
+# Note: this command is experimental, and not a stable API.  Things that
+# might change before it becomes stable include the spelling of enum
+# values for InputButton and InputAxis, and the notion of how to designate
+# which console will receive the event.

 #
 ##
 { 'command': 'x-input-send-event',
 #
 ##
 { 'command': 'x-input-send-event',


@@ -3876,3 +4069,21 @@
 
 # Rocker ethernet network switch
 { 'include': 'qapi/rocker.json' }
 
 # Rocker ethernet network switch
 { 'include': 'qapi/rocker.json' }

+
+##
+# ReplayMode:
+#
+# Mode of the replay subsystem.
+#
+# @none: normal execution mode. Replay or record are not enabled.
+#
+# @record: record mode. All non-deterministic data is written into the
+#          replay log.
+#
+# @play: replay mode. Non-deterministic data required for system execution
+#        is read from the log.
+#
+# Since: 2.5
+##
+{ 'enum': 'ReplayMode',
+  'data': [ 'none', 'record', 'play' ] }