Intel® System Debugger User Guide
Intel(R) Crash Log Framework Graphical User Interface
Overview
Intel(R) System Debugger - Crash Log GUI provides a user interface and additional visualization capabilities on top of Crash Log Framework to manually trigger Crash Log, extract, decode, and present Crash Log data.
Getting Started
Open Crash Log Perspective
Launch Intel(R) System Debugger - Crash Log.
If the User Guide page is opened, close it by clicking the close button. You can reopen the User Guide via Help > User Guide from the menu bar.
Open the Open Perspective dialog via Window > Perspective > Open Perspective > Other… or by clicking the Open Perspective button at the top right corner.
Select Crash Log and click the OK button.
Extract Crash Log File
Trigger Crash Log Manually
When an out-of-band trigger is available in the platform under test, you can call it by clicking the Trigger Crash Log button in the editor toolbar.
Click Continue to enable overwriting the content in Crash Log Storage.
When the Crash Log is triggered, click Yes to extract the Crash Log Raw File. The extracted file is decoded, analyzed, and displayed in the Crash Log Viewer automatically.
You can change this setting by the following steps below:
Select Window > Preferences to open the Preferences dialog box.
Navigate to Crash Log and set your preferred option.
#. Click Apply to save your changes or Apply and Close to save changes and close the dialog.
Extract Crash Log
You can extract an existing Crash Log from the Crash Log Storage.
Click Extract Crash Log in the editor toolbar. Alternatively, select Run > Extract Crash Log from the menu bar.
The extracted file is decoded, analyzed, and displayed in the Crash Log Viewer automatically.
Once a Crash Log Raw File is extracted, it can be decoded and analyzed. The next section provides an example of how to view the Crash Log Raw File in the tool for the first time.
Import Crash Log File
In Crash Log perspective, open Import dialog via File > Import… or right click on Project Explorer view and select Import….
Select Crash Log > Crash Log File and click the Next > button.
Click the top Browse… button and select the directory that contains the Crash Log Raw File. Select files that should be imported. Enter a name into the bottom text field as the name of a new Crash Log project. Click the Finish button.
Click the OK button.
If only a single file is imported, it will be opened automatically. If multiple files are imported, double click on the imported file or right click on the file and select Open With > Crash Log Viewer.
The Crash Log data is presented in two separated windows:
Crash Log Viewer
On the left is the Crash Log Viewer that is displaying registers and their values. Each Crash Log file is opened in a separate tab.
Crash Log Analysis View
On the right is the Crash Log Analysis View that presents all available analyses. This view is showing analyses corresponding to file opened in the active Crash Log Viewer.
The analyzer tree has the Summary as the root node, which lists all detected errors. All analyzers are attached as dependency of the Summary node, where each of them also have the analyzers they depend on listed as child nodes. Each analyzer that has detected an issue is indicated with an icon with an exclamation mark.
Glossary
- Crash Log Extraction
Refers to the reading or transformation of a Crash Log from a Crash Log Storage to a computer file (Crash Log Raw File).
- Crash Log Raw File
The Crash Log Raw File is a computer file representation of the crash data.
- Crash Log Storage
Persistent memory storage containing the Crash Log.
- Crash Log Trigger
Refers to manually overwriting the content in the Crash Log Storage.