Visible to Intel only — GUID: GUID-50E4AA83-06A4-4E55-A3DA-39F867243B5E
Get Started
Before You Begin
Set Up a Project
Collecting Results
Investigating Results
Testing for Regressions
Use Cases
Suppressions Support
API Support
Troubleshooting
User Interface Reference
Problem Type Reference
Command Line Interface Support
MPI Applications Support
Appendix
Notices and Disclaimers
Context Menus: Project Navigator
Context Menus: Sources Window Panes
Context Menus: Summary Window Panes
Dialog Box: Corresponding inspxe-cl Command Options
Dialog Box: Create a Project
Dialog Box: Create Suppression
Dialog Box: Custom Analysis
Dialog Box: Delete Suppressions
Dialog Box: Export Result
Dialog Box: Merge States
Dialog Box: Options-Debugger
Dialog Box: Options-General
Dialog Box: Options-Result Location
Dialog Box: Options-State Management
Dialog Box: Problem Report
Dialog Box: Project Properties-Binary/Symbol Search
Dialog Box: Project Properties-Source Search
Dialog Box: Project Properties-Suppressions
Dialog Box: Project Properties-Target
Dialog Box: Refine Source File Set
Dialog Box: Select Stack Frame(s)
Dialog Box: View Stack
Hot Keys
Pane: Analysis Type-Custom
Pane: Analysis Type-Memory Errors
Pane: Analysis Type-Threading Errors
Pane: Application Output
Pane: Code and Stack
Pane: Code Locations
Pane: Collection Log
Pane: Collector Messages
Pane: Compare Results
Pane: Filters
Pane: Import Result
Pane: Launch Application
Pane: Problems
Pane: Project Navigator
Pane: Timeline
Toolbar: Command
Toolbar: Intel Inspector
Toolbar: Navigation
Window: Collection Log
Window: Compare Results
Window: Import Result
Window: Sources
Window: Summary After Analysis Is Complete
Window: Summary During Analysis
Asynchronous Buffer
Cross-thread Stack Access
Data Race
Deadlock
Host Pointer Used on Device
Incorrect memcpy Call
Invalid Deallocation
Invalid Kernel Argument
Invalid Kernel Argument Size
Invalid Memory Access
Invalid Partial Memory Access
Lock Hierarchy Violation
Memory Growth
Memory Leak
Memory Not Deallocated
Mismatched Allocation/Deallocation
Mismatched Queue
Missing Allocation
Non-Host Pointer
Pointer from Different Device
Thread Exit Information
Thread Start Information
Unhandled Application Exception
Uninitialized Memory Access
Uninitialized Partial Memory Access
appdebug
app-working-dir
archive-name
baseline-result
collect
collect-with
command
convert-suppression-file
create-breakpoints
create-suppression-file
<span class='option'>csv-delimiter</span>
debug-this
executable-of-interest
export
filter
finalize
format
help
include-snippets
include-sources
import
knob
knob-list
merge-states
module-filter
module-filter-mode
no-auto-finalize
no-summary
option-file
quiet
report
report-all
report-output
result-dir
return-app-exitcode
search-dir
sort-asc
sort-desc
suppression-file
user-data-dir
verbose
version
Visible to Intel only — GUID: GUID-50E4AA83-06A4-4E55-A3DA-39F867243B5E
Investigating Problems Using Interactive Debugging
Sometimes simply knowing the location of a problem is not enough. So the Intel Inspector provides the opportunity to investigate more deeply with an interactive debugging session during analysis.
When you run an interactive debugging session during analysis, the Intel Inspector halts execution at a selected or detected problem. This is more efficient than simply setting a code breakpoint at a reported problem location because the code could execute thousands of times before the conditions that produced the problem occur.
You can choose the supported debugger to use (default is the GNU gdb* debugger). During the debugging session, use the normal commands for the chosen debugger to examine memory, set code breakpoints, and continue execution. Use the command monitor help to view the extended debugger commands provided by the Intel Inspector.
Use one of the following ways to initiate an interactive debugging session during analysis so that you see the state of your application code instead of the state of Intel Inspector analysis code:
Objective |
Process Summary |
Usage |
|---|---|---|
Allow quick investigation of problem(s) of interest. |
In a result, choose a problem(s) in the Summary window, right-click to display a context menu, then choose Debug This Problem. Outcome: The Intel Inspector:
|
Typical scenario: After reviewing a problem using result data provided by the Intel Inspector, you discover you need more application state information at the time the problem occurred, such as the contents of variables. The Debug This Problem function returns you to the point of the problem, halting execution in a debugging session so you can examine memory and other state information at any point in the call stack. |
Delay problem detection until a selected point in the application. |
In the Intel Inspector, select the Select analysis start location with debugger radio button when configuring an analysis. Start the analysis and wait for the debugging session to open. When execution halts at the entry to main(), set a code breakpoint at the point in the application where you want analysis to begin. Continue execution until that point, then enter monitor begin-analysis to turn on analysis and resume execution. Outcome: Execution halts for each problem detected after you turn on analysis and resume execution. You cannot turn off analysis again. |
Typical scenario: You configured the project to limit the application modules for inspection, but you need to narrow analysis focus even further. This option lets you choose an arbitrary location to turn on error detection, allowing faster execution until that point.
TIP:
Because debugging in conjunction with a threading analysis significantly slows execution:
|
Allow investigation of every detected problem. |
In the Intel Inspector, select the Enable debugger when problem detected radio button when configuring an analysis. Outcome: When you run the analysis, the Intel Inspector halts application execution when it detects the first problem and launches a debugging session. Execution halts for each detected problem when you resume execution using normal debugger commands. |
Typical scenario: You want to investigate the state of the application for every problem detected.
TIP:
Because of analysis speed issues, this option is not recommended when detecting data races. It is faster to use the Debug This Problem function to selectively investigate threading problems identified during a non-debug run. |
Tips
Intel Inspector supports interactive debugging only for pure native applications.
Intel Inspector does not offer interactive debugging for the Detect Leaks (mi1) analysis type because memory and resource leaks are determined after an application terminates and therefore cannot be used to halt execution during analysis. However, you can perform a standard debugger attach to a process launched under this analysis type.
Do not recompile your application after generating a result if you plan to use the result Debug This Problem function. Intel Inspector cannot guarantee finding the same problem(s) when the binary changes; consequently, it checks for a binary change and reports a warning to prevent rerunning an analysis that may not stop at the selected problem(s).
When you use the Debug This Problem function, the problem list in the new result may differ from the problem list in the source result. Intel Inspector automatically adjusts the debugging session analysis to return to the selected problem(s) more quickly; however the analysis adjustments do not correspond to individual problem types. Consequently, the Intel Inspector may detect and report additional problems, but it will break only for a selected problem(s).
Parent topic:Investigating Results