Skip to content

Commit

Permalink
Update Trace.md
Browse files Browse the repository at this point in the history
  • Loading branch information
torusrxxx committed Jul 5, 2020
1 parent cf49d1e commit e698e3c
Showing 1 changed file with 25 additions and 1 deletion.
26 changes: 25 additions & 1 deletion gui/views/Trace.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@

Trace view is a view in which you can see history of stepped instructions. This lets you examine the details of each instruction stepped when you are stepping manually or [tracing](../../introduction/ConditionalTracing.md) automatically, or view a trace history previously saved. This functionality must be enabled explicitly from trace view or [CPU view](CPU.rst). It features saving all the instructions, registers and memory accesses during a trace.

You can double-click on columns to perform quick operation:
* Index: follow in disassembly.
* Address: toggle RVA display mode.
* Opcode: toggle breakpoint.
* Disassembly: follow in disassembly.
* Comments: set comments.

## Start Run Trace

To enable trace logging into trace view, you first enable it via "**Start Run Trace**" menu. It will pop up a dialog allowing you to save the recorded instructions into a file. The default location of this file is in the database directory.
Expand All @@ -16,10 +23,27 @@ This menu can stop recording instructions.

Close current trace file and clear the trace view.

## Close and delete

Close current trace file and clear the trace view, and also delete current trace file from disk.

## Open

Open a trace file to view the content of it. It can be used when not debugging, but it is recommended that you debug the corresponding debuggee when viewing a trace, as it will be able to render the instructions with labels from the database of the debuggee.
Open a trace file to view the content of it. It can be used when not debugging, but it is recommended that you debug the corresponding debuggee when viewing a trace, as it will be able to render the instructions with labels from the database of the debuggee. The debugger will show a warning if you want to load a trace file which is not recorded from currently debugged executable.

## Recent files

Open a recent file to view the content of it.

## Search
### Constant

Search for the user-specified constant in the entire recorded trace, and record the occurances in references view.

### Memory Reference

Search for memory accesses to the user-specified address.

## Toggle Auto Disassembly Scroll

When turned on, the disassembly view in the [CPU view](CPU.rst) will automatically follow the EIP or RIP of selected instruction in trace view.

0 comments on commit e698e3c

Please sign in to comment.