/[eiffelstudio]/trunk/Documentation/xmldoc/tools/eiffelstudio/reference/40_debugger/35_execution_replay.xml
ViewVC logotype

Contents of /trunk/Documentation/xmldoc/tools/eiffelstudio/reference/40_debugger/35_execution_replay.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 71102 - (show annotations)
Fri Nov 9 12:03:43 2007 UTC (12 years, 2 months ago) by jfiat
File MIME type: text/xml
File size: 3255 byte(s)
Updated documentation related to debugger including the new features "Exec replay" and "Debuggee object storage".
Updated documentation related to preferences dialog.
Refresh a few screen shots
1 <document title="Execution replay" output="studio">
2 <meta_data/>
3 <paragraph>
4 <paragraph>This new feature allows the user to record the debuggee execution, and when it is stopped to replay the recording. One could see this feature as a rewind/forward, or undo/redo of the execution calls.
5 In practise, the debugger is recording the effective routine calls, and keep the object's values; when you replay the debugger will restore the recorded object's values. This way you can use the debugger's tools to inspect the values.
6 </paragraph>
7 <warning>For performance reason, the debugger keeps only the last <code>{RT_DBG_EXECUTION_RECORDER}.max_record_count</code> object's records. For now, you can change that initial value by editing <code>{RT_EXTENSION}.new_execution_recorder</code>.
8 </warning>
9 <paragraph>This functionality is graphically available on the Call stack tool, or though the "Execution" menu (former "Debug" menu).
10 </paragraph>
11 <paragraph>When you start debugging, at some point you decide to start recording, click on the "record" button:</paragraph>
12 <paragraph><alignment>center</alignment>
13 <image><url>../../../../images/eiffelstudio/debugger/exec_replay_00.png</url></image>
14 </paragraph>
15
16 <paragraph>During the debugging, we decide to stop and replay the recent execution recording, as you can notice the "Recording" button is enabled, thus we can start replaying by clicking the "Replay" button</paragraph>
17 <paragraph><alignment>center</alignment>
18 <image><url>../../../../images/eiffelstudio/debugger/exec_replay_01.png</url></image>
19 </paragraph>
20
21 <paragraph>Now we are in "execution replay" mode, as you can notice the "Replay" button is enabled, and there is a new commands bar with "Replay Back", "Replay Forth", and the number of available "moves". <line_break></line_break>
22 The red arrow show the replayed call stack level, and the call stack levels which can be replayed have a light blue background.
23 <paragraph><alignment>center</alignment>
24 <image><url>../../../../images/eiffelstudio/debugger/exec_replay_02.png</url></image>
25 </paragraph>
26
27 <paragraph>Here we clicked on "Replay Back" twice, you can now also "Replay Forth" twice. When you execute a "Replay" operation, the debugger restores the related recorded values, and the various debugger tools are updated with tools values (including the watch tools)</paragraph>
28 <paragraph><alignment>center</alignment>
29 <image><url>../../../../images/eiffelstudio/debugger/exec_replay_03.png</url></image>
30 </paragraph>
31
32 <paragraph>You can still select other call stack level as you do in normal debugging mode to inspect them, in this case the red arrow stick to the replayed call, and the green arrow show you the selected call stack level.</paragraph>
33 </paragraph>
34 <paragraph><alignment>center</alignment>
35 <image><url>../../../../images/eiffelstudio/debugger/exec_replay_04.png</url></image>
36 </paragraph>
37 <warning>For now, EiffelStudio supports only "Replay back" and "Replay forth" (finner replay might be added for 6.2).</warning>
38 <warning>EiffelStudio 6.1 provides this feature only on classic system, this is not yet supported on dotnet (planned for 6.2).</warning>
39 </paragraph>
40 </document>

  ViewVC Help
Powered by ViewVC 1.1.23