Intel® System Debugger User Guide

ID 648476
Date 06/13/2024
Confidential
Document Table of Contents

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.

../../_images/gsg0.png

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.

../../_images/gsg1.png

Open the Open Perspective dialog via Window > Perspective > Open Perspective > Other… or by clicking the Open Perspective button at the top right corner.

../../_images/gsg2.png

Select Crash Log and click the OK button.

../../_images/gsg3.png

Extract Crash Log File

Trigger Crash Log Manually

../../_images/gsg8_icon_trigger.png

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.

../../_images/gsg8_trigger.png

Click Continue to enable overwriting the content in Crash Log Storage.

../../_images/gsg8_trigger_extract.png

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:

  1. Select Window > Preferences to open the Preferences dialog box.

  2. 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.

../../_images/gsg8_trigger_extract_preference.png

Extract Crash Log

You can extract an existing Crash Log from the Crash Log Storage.

../../_images/gsg9_icon_extract.png

Click Extract Crash Log in the editor toolbar. Alternatively, select Run > Extract Crash Log from the menu bar.

../../_images/gsg9_menubar.png

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….

../../_images/gsg4.png

Select Crash Log > Crash Log File and click the Next > button.

../../_images/gsg5.png

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.

../../_images/gsg6.png

Click the OK button.

../../_images/gsg7.png

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.