1# -*- Mode: Python -*- 2# 3 4## 5# = Record/replay 6## 7 8{ 'include': 'common.json' } 9 10## 11# @ReplayMode: 12# 13# Mode of the replay subsystem. 14# 15# @none: normal execution mode. Replay or record are not enabled. 16# 17# @record: record mode. All non-deterministic data is written into the 18# replay log. 19# 20# @play: replay mode. Non-deterministic data required for system execution 21# is read from the log. 22# 23# Since: 2.5 24## 25{ 'enum': 'ReplayMode', 26 'data': [ 'none', 'record', 'play' ] } 27 28## 29# @ReplayInfo: 30# 31# Record/replay information. 32# 33# @mode: current mode. 34# 35# @filename: name of the record/replay log file. 36# It is present only in record or replay modes, when the log 37# is recorded or replayed. 38# 39# @icount: current number of executed instructions. 40# 41# Since: 5.2 42# 43## 44{ 'struct': 'ReplayInfo', 45 'data': { 'mode': 'ReplayMode', '*filename': 'str', 'icount': 'int' } } 46 47## 48# @query-replay: 49# 50# Retrieve the record/replay information. 51# It includes current instruction count which may be used for 52# @replay-break and @replay-seek commands. 53# 54# Returns: record/replay information. 55# 56# Since: 5.2 57# 58# Example: 59# 60# -> { "execute": "query-replay" } 61# <- { "return": { "mode": "play", "filename": "log.rr", "icount": 220414 } } 62# 63## 64{ 'command': 'query-replay', 65 'returns': 'ReplayInfo' } 66 67## 68# @replay-break: 69# 70# Set replay breakpoint at instruction count @icount. 71# Execution stops when the specified instruction is reached. 72# There can be at most one breakpoint. When breakpoint is set, any prior 73# one is removed. The breakpoint may be set only in replay mode and only 74# "in the future", i.e. at instruction counts greater than the current one. 75# The current instruction count can be observed with @query-replay. 76# 77# @icount: instruction count to stop at 78# 79# Since: 5.2 80# 81# Example: 82# 83# -> { "execute": "replay-break", "data": { "icount": 220414 } } 84# 85## 86{ 'command': 'replay-break', 'data': { 'icount': 'int' } } 87 88## 89# @replay-delete-break: 90# 91# Remove replay breakpoint which was set with @replay-break. 92# The command is ignored when there are no replay breakpoints. 93# 94# Since: 5.2 95# 96# Example: 97# 98# -> { "execute": "replay-delete-break" } 99# 100## 101{ 'command': 'replay-delete-break' } 102 103## 104# @replay-seek: 105# 106# Automatically proceed to the instruction count @icount, when 107# replaying the execution. The command automatically loads nearest 108# snapshot and replays the execution to find the desired instruction. 109# When there is no preceding snapshot or the execution is not replayed, 110# then the command fails. 111# icount for the reference may be obtained with @query-replay command. 112# 113# @icount: target instruction count 114# 115# Since: 5.2 116# 117# Example: 118# 119# -> { "execute": "replay-seek", "data": { "icount": 220414 } } 120## 121{ 'command': 'replay-seek', 'data': { 'icount': 'int' } } 122