Intel® System Debugger User Guide
Rules View
With Rules view, you can set multiple rules for highlighting messages in the Message View.
To open the Rules view, click the search icon in the Message View toolbar:
Create Rule
Click
in the Rules view to create a new rule:
In the opened dialog box, you can use two tabs to define the rule criteria:
Text tab allows you to create a simple string expression. When the rule is applied, messages matching the given string are highlighted.
Expression tab allows you to set more complex criteria. See how to Set Advanced Criteria.
When criteria are defined, press OK to create the rule.
The rule appears in the Rules view.
In the Rules view, you can view and edit the following columns:
Navigation - Shortcut key to navigate the matches of each applied rule.
Checkbox - Select the rule to apply it by clicking Apply.
Matches - Show matches per rule when rules are applied.
Color - Change the color settings of the rule.
Name - Give a custom name to the rule.
Criteria - The text expression of the criteria defined for this rule. To edit the rule criteria, double-click this entry.
Work with Rules View
Toolbar
Default Rules
You can start with five default rules that can help you highlight messages with Corrupted Traces, Errors, Warnings, and other common issues. These rules are shown in the Rules view when you open it. The image below illustrates the default rules with their assigned colors.
Apart from the existing default rules, you can create multiple rules with different settings. When ready, select the required rules (check boxes on the left) and click Apply to apply the rules to the Message view.
If rules in the Rules View are changed so that they are different from what has already been applied on the Message View, an asterik sign will appear on title to indicate the rules are out of sync and need to be re-applied.
Color Priority
You can change the color priority of the rule using the up and down arrows in the toolbar. If several rules match the same result, the trace message is highlighted with the color of the rule which is higher in the table.
Show Matches Only
If this checkbox is selected when applying the rules, the Message View displays only those trace messages that match any of the selected rules and hides the rest of the messages.
Range
You can select the range of trace messages that the rules will be applied to. It is useful when you want to analyze a small segment of a large trace. Additionally, short ranges are filtered and displayed faster.
To limit the search to a certain window, click Edit icon and choose the upper bound and lower-bound using the “From” or “To” options.
If you have defined markers, they are displayed in the Marker drop-down lists and you can use them as boundaries.
Auto Apply
You can check the Auto Apply checkbox to apply the default rules automatically (without explicitly clicking on the Apply button) when a trace file is decoded.
Save and Load Rules
You can use the toolbar buttons to save rules to a file or load them into the Rules view.
Set Advanced Criteria
In the Criteria dialog, you can use the Expression tab to create more complex rules with specific message fields.
- Constraints
Packet Type Constraints
To select a packet type constraint:
Click the data field drop-down and select PacketType.
Click the operator drop-down and select an operator.
Commonly, the == operator is used for packet types but any other operator is also valid.
Click in the text field to select the desired packet string.
To select multiple packet types, use logical OR to combine them. Logical AND is not supported for this purpose.
To denote all packets, do not specify any packet type constraints.
Field Constraints
Click the field constraints drop-down menu and select the desired field.
Fields that belong to at least one of the selected packets are shown.
Set constraints to the selected fields.
To add a field constraint, click
To remove a field constraint, click
.
If multiple field constrains are set, you can combine them by using logical AND or OR.
To add multiple conditions to your search, click Add Condition. An OR logics is applied on multiple conditions. See the last example below.
Examples
Search for messages of the type “BLOB,” with Severity of Fatal or Error or Warning:
Search for messages of all packet types, coming from the BIOS ANDPOSTCODE appears in the Summary:
Multiple search criteria – search for one of the following options:
BLOB.SVEN messages where Summary contains “Destination”AND coming from BIOS
BLOB.AET messages where Summary contains “dst” OR coming from the AET_S0C00T0