The debugger contains a record and playback feature to recreate program states for bugs requiring long setups. The files created are ASCII files, and can be edited by hand later. Only debugger commands are recorded. However, if a GUI action creates a debugger command, that command is recorded. This includes pressing any button in the debugger window or clicking in the source pane. The target window commands and output cannot be recorded.
The record and playback commands are:
Record and playback commands | |
---|---|
Expression | Meaning |
> file |
Sets command recordfile to the given file and turns on command recording. |
> (t | f | c) |
Turns command recording on (t), off (f), or closes command recording file (c). If no argument is given, give current status. |
>> file |
Sets screen output recordfile to the given file and turns on screen output recording (recording commands and their output). |
>> (t | f | c) |
Turns screen output recording on (t), off (f), or closes screen output recording file (c). If no argument exists, give current status. |
< file |
Starts command playback from the given file. The filename will be searched for using the default search path. See
"default search path". |
<< file |
Starts command playback from the given file, using the single stepping feature of playback. This command is not supported in GUI mode. The filename will be searched for using the default search path. See
"default search path". |
Scripts may include other scripts, to a maximum script depth of 25.
Do not place any line beginning with > or < in the current record file. You can override this by simply beginning the line with a space. Comments are supported in command playback files, as in all debugger input, through the standard C style comments (/* ... */). In addition, a comment is always terminated at the end of a line. Hence a /* (forward slash+asterisk) with no closing match comments out the remainder of the line, but does not carry over to the next line as in standard C. You may not play back from a file currently open for recording or vice versa, as the result is undefined.
See also the -p and -R command line options to MULTI, in the Building and Editing with MULTI 2000 manual.
Note: if you use the command "> file" when the command recordfile is already set, the old recordfile will be closed and all subsequent commands will be recorded to file. The command ">> file" works similarly when the screen output recordfile is already set.
The source file search path (as specified by the source command) will be used when searching for scripts for playback (the < command). See source.