Get Link | Sync TOC
Intel® Debugger User's and Reference Guide
Legal Information
Introducing the Intel® Debugger
Related Information
Notational Conventions
Debugging with the Intel® Debugger GUI
Before You Begin
Preparing the Debugging Environment
Configuring the Debugger
Configuring Default Startup Actions Using Initialization Files
How the Debugger Finds Source Files
Specifying Source Directories
Stopping the Debugger Window From Moving to the Front
Preparing a Program for Debugging
Preparing Your Source Code
Preparing the Compiler and Linker Environment
Debugging Optimized Code
Preparing a Program for Parallel Debugging
Getting Started
Technical Requirements
Building the Sample Code for Debugging
Starting the Debugger
Opening the helloworld Executable
Displaying the Source File
Running the Application
Setting and Deleting a Breakpoint
Setting and Deleting a Breakpoint on the Command-line
Exiting the Debugger
Running an Application with the Debugger
Quick Reference: Running and Stopping an Application
Running a Program under Debugger Control
Opening an Executable
Unloading an Executable
Attaching the Debugger to a Process
Attaching the Debugger to a Process at a Predictable Location
Detaching the Debugger From a Process
Controlling the Process Environment
Debugging Multiple Processes
Running an Application
Executing a Line of C++ Source Code
Running an Application Until the Calling Function
Running an Application Until an Expression or a Line Number
Executing an Assembler Instruction
Setting the Program Counter to a Specific Line
Recording Input and Output
Locating a Problem
Stopping the Application
Stopping an Application at Predefined Locations
Breakpoints Overview
Setting and Deleting Simple Breakpoints
Setting Complex Breakpoints
Setting Complex Data Breakpoints
Synchronizing a Set of Threads
Displaying Breakpoints
Enabling and Disabling Breakpoints
Modifying Breakpoints
Continuing an Application
Detecting Pointer Boundary Violations
Session Handling
About Session Handling
Reloading a Debuggee Without Previous Session Settings
Saving a Session
Restoring a Session
About Session Handling in Command-line Mode
Examining Code, Data, and Other Process Information
Examining Source Files
Displaying Source Files
Finding Strings
Using Bookmarks to Navigate
Examining the Call Stack
About the Call Stack
The Call Stack in the Debugger
Missing Functions in the Call Stack
A Corrupted Call Stack
Viewing Call Stacks for Multiple Threads
Viewing and Navigating the Current Call Stack
Call Frames and Optimized Code
Call Frames and Machine Code Correlation
Special C++ Issues
Examining Data
Evaluating Expressions
Evaluating Expressions from a Pointer
Evaluating Addresses
Adding Expressions to the Evaluations Window
Evaluating Variables
Evaluating Intel® Streaming SIMD Extensions (Intel® SSE) Variables
Displaying Local Variables
Modifying Values
Editing Expressions and Values
Pretty Printing for Standard Template Library Classes
Examining Assembly Code
Displaying Assembler Code
Jumping to Source Code from the Assembler Window
Changing the Start Address in the Assembler Window
Reloading Memory in the Assembler Window
Displaying Source Annotations in the Assembler Window
Editing Assembler Code
Jumping to the Assembler Code
Setting the Assembler Window to the Program Counter
Showing the Contents of Memory Referenced in the Assembler Window
Examining the CPU
Updating the Registers Window or the SSE Registers Window
Showing the Memory Address that a Register References
Examining Memory
Displaying Memory Content
Editing Memory Addresses
Modifying Memory
Changing the Start Address in the Memory Window
Reloading Memory
Returning to Start Address
Following Pointers
Resetting the Start Address
Debugging Core Files
Debugging Parallel Applications
Working With Thread and Process Sets
Working With Thread and Process Sets: Overview
Process and Thread Set Notation
Specifying Process and Thread Sets
Specifying a Range of Processes or Threads
Storing Process and Thread Sets in Debugger Variables
Process and Thread Set Operations
Predefined Thread Sets
Viewing Threads and Thread Sets
Synchronizing a Set of Threads
Changing the Current Process Set
Debugging Multi-Threaded Applications
Finding Algorithmic Bugs in Intel® Cilk™ Plus Code
Finding Bugs in OpenMP* and Serial Code
Viewing OpenMP* Information
Thread Data Sharing Detection
About Thread Data Sharing Detection
Detecting Thread Data Sharing Events
Excluding Thread Data Sharing Events from Detection
Exporting Thread Data Sharing Events History
Breaking at Re-entrant Calls
Debugging Massively Parallel Applications
Debugging Massively Parallel Applications: Overview
Before You Begin Debugging an MPI Application
Starting an MPI Debugging Session
Attaching to an Existing MPI Job
Using Commands in a Parallel Debugging Session
Working with Aggregated Messages
Parallel Debugging Tips
Parallel Debugging Tip 1: Obtaining Better Aggregate Outputs
Parallel Debugging Tip 2: Synchronizing Processes
Parallel Debugging Tip 3: Finding Source Files in a Parallel Debugging Session
Parallel Debugging Example
Using the mpirun_dbg.idb Startup File
Debugging with the Intel® Debugger on Eclipse*
Adding the Intel® Debugger Integrations to Eclipse*
Debugging Intel® MIC Architecture Applications on Eclipse*
Debugging a Heterogeneous Application
Debugging Only on the Coprocessor
Debugging on the Command Line
Starting the Debugger in Command Line Mode
Setting and Deleting a Breakpoint on the Command-line
Giving Commands to the Debugger
Supporting Multiple Processes
Debugging Multiple Processes
Supporting Multiple Call Frames, Threads, and Sources
Command, Filename and Variable Completion
User-defined Commands
Changing the Debugger Prompt
Processing Debugger Commands
Processing Debugger Commands: Overview
Entering and Editing Command Lines
History Replacement of the Line (idb mode only)
Environment Variable Expansion
Syntax of Commands
Syntax of Commands: Overview
Lexical Analysis
Grammar of Commands
Keywords within Commands
Using Braces to Make a Composite Command
Conditionalizing Command Execution
About Debugger Variables
Scripting or Repeating Previous Commands
Repeating Previous Commands
Scripting Commands
Viewing the Command History
Executing Shell or Command Prompt Commands
Debugging Intel® MIC Architecture Applications on the Command Line
Debugging Heterogeneous Applications Only on the Coprocessor Side
Debugging Native Applications Only on the Coprocessor Side
Debugger Command Reference (GDB Mode)
!
^
#
advance
attach
awatch
backtrace
break
call
clear
commands
complete
condition
continue
core-file
define
delete breakpoints
detach
directory
disable
disassemble
disconnect
down
down-silently
echo
enable
file
finish
forward-search
frame
handle (gdb mode only)
help
idb directory (gdb mode only)
idb freeze (gdb mode only)
idb info barrier (gdb mode only)
idb info lock (gdb mode only)
idb info openmp thread tree (gdb mode only)
idb info task (gdb mode only)
idb info taskwait (gdb mode only)
idb info team (gdb mode only)
idb info thread (gdb mode only)
idb process (gdb mode only)
idb reentrancy (gdb mode only)
idb session restore (gdb mode only)
idb session save (gdb mode only)
idb set cilk-serialization (gdb mode only)
idb set openmp-serialization (gdb mode only)
idb sharing (gdb mode only)
idb sharing event expand (gdb mode only)
idb sharing event list (gdb mode only)
idb sharing filter add file (gdb mode only)
idb sharing filter add function (gdb mode only)
idb sharing filter add range (gdb mode only)
idb sharing filter add variable (gdb mode only)
idb sharing filter delete (gdb mode only)
idb sharing filter disable (gdb mode only)
idb sharing filter enable (gdb mode only)
idb sharing filter list (gdb mode only)
idb sharing filter toggle (gdb mode only)
idb sharing reset (gdb mode only)
idb sharing status (gdb mode only)
idb sharing stop (gdb mode only)
idb show bounds
idb show cilk-serialization (gdb mode only)
idb show openmp-serialization (gdb mode only)
idb show process-list
idb stopping threads (gdb mode only)
idb synchronize (gdb mode only)
idb target threads (gdb mode only)
idb thaw (gdb mode only)
idb uninterrupt (gdb mode only)
if
ignore (gdb mode only)
info args (gdb mode only)
info breakpoints (gdb mode only)
info files (gdb mode only)
info functions (gdb mode only)
info handle (gdb mode only)
info line (gdb mode only)
info locals (gdb mode only)
info program (gdb mode only)
info registers (gdb mode only)
info share (gdb mode only)
info sharedlibrary (gdb mode only)
info signals (gdb mode only)
info source (gdb mode only)
info sources (gdb mode only)
info stack (gdb mode only)
info target (gdb mode only)
info threads (gdb mode only)
info types (gdb mode only)
info variables (gdb mode only)
info watchpoints (gdb mode only)
jump (gdb mode only)
kill
list
monitor (gdb mode only)
next
nexti
output (gdb mode only)
path (gdb mode only)
print
printf
ptype (gdb mode only)
pwd (gdb mode only)
quit
return (gdb mode only)
reverse-search (gdb mode only)
run
rwatch (gdb mode only)
search (gdb mode only)
set args (gdb mode only)
set confirm (gdb mode only)
set disassembly-flavor (gdb mode only)
set editing (gdb mode only)
set environment (gdb mode only)
set height (gdb mode only)
set history save
set history size
set language (gdb mode only)
set listsize (gdb mode only)
set max-user-call-depth (gdb mode only)
set output-radix (gdb mode only)
set print address (gdb mode only)
set print elements (gdb mode only)
set print repeats (gdb mode only)
set print static-members (gdb mode only)
set prompt (gdb mode only)
set solib-search-path
set substitute-path (gdb mode only)
set variable (gdb mode only)
set width (gdb mode only)
shell (gdb mode only)
show aggregated message
show architecture (gdb mode only)
show args (gdb mode only)
show commands (gdb mode only)
show convenience (gdb mode only)
show directories (gdb mode only)
show disassembly-flavor (gdb mode only)
show editing (gdb mode only)
show environment (gdb mode only)
show height (gdb mode only)
show language (gdb mode only)
show listsize (gdb mode only)
show max-user-call-depth (gdb mode only)
show output-radix (gdb mode only)
show print address (gdb mode only)
show print elements (gdb mode only)
show print repeats (gdb mode only)
show print static-members (gdb mode only)
show process set
show prompt (gdb mode only)
show user (gdb mode only)
show values (gdb mode only)
show width (gdb mode only)
source
step
stepi
target core (gdb mode only)
tbreak (gdb mode only)
thread
unset environment (gdb mode only)
unset substitute-path (gdb mode only)
until (gdb mode only)
up
up-silently (gdb mode only)
watch (gdb mode only)
whatis
while
x (gdb mode only)
Debugger Command Reference (IDB Mode)
address / size format
/ | ?[string] (idb mode only)
!
^
#
alias
assign
attach
call
catch
catch unaligned
class
cont
delete
delete breakpoints
delsharedobj
detach
disable
down
dump
edit
enable
exit
expand aggregated message
export
file
fileexpr
focus
func
goto
help
history (idb mode only)
if
ignore (idb mode only)
kill
list
listobj (idb mode only)
load (idb mode only)
map source directory (idb mode only)
next
nexti
patch (idb mode only)
playback input (idb mode only)
pop (idb mode only)
print
printenv (idb mode only)
printf
printi
printregs (idb mode only)
printt (idb mode only)
process (idb mode only)
quit
readsharedobj (idb mode only)
record (idb mode only)
rerun (idb mode only)
return (idb mode only)
run
set (idb mode only)
set history save
set history size
setenv (idb mode only)
sh (idb mode only)
show aggregated message
show condition (idb mode only)
show lock (idb mode only)
show mutex (idb mode only)
show openmp thread tree (idb mode only)
show process (idb mode only)
show process set
show source directory (idb mode only)
show team (idb mode only)
show thread (idb mode only)
source
status (idb mode only)
step
stepi
stop at (idb mode only)
stop every (idb mode only)
stop in (idb mode only)
stop memory (idb mode only)
stop pc (idb mode only)
stop signal (idb mode only)
stop unaligned (idb mode only)
stop variable (idb mode only)
stopi (idb mode only)
thread
unalias (idb mode only)
unload (idb mode only)
unmap source directory (idb mode only)
unrecord (idb mode only)
unset (idb mode only)
unsetenv (idb mode only)
unuse (idb mode only)
up
use (idb mode only)
watch (idb mode only)
whatis
when (idb mode only)
wheni (idb mode only)
where (idb mode only)
whereis (idb mode only)
which (idb mode only)
while
List of Predefined Debugger Variables
User Interface Reference
Drag and Drop
Customizing Column Display in Windows
Dialog Boxes
Memory Dialog Box
Evaluate Dialog Box
Create Breakpoint Dialog Box: Code Tab
Create Breakpoint Dialog Box: Data Tab
Modify Breakpoint Dialog Box
Symbol Selector Dialog Box: Simple Search Tab
Symbol Selector Dialog Box: Advanced Search Tab
Open Source File Dialog Box
Start Command Recording Dialog Box
Start IO Recording Dialog Box
GUI Preferences Dialog Box
Run Until… Dialog Box
Open Executable Dialog Box: Arguments Tab
Open Executable Dialog Box: Environment Tab
Open Executable Dialog Box: Source Directories Tab
Attach to Process Dialog Box
Open Core Dump Dialog Box
Run or Rerun With Arguments Dialog Box: Arguments Tab
Run or Rerun With Arguments Dialog Box: Environment Tab
Run or Rerun With Arguments Dialog Box: Source Directories Tab
Signal Handling Dialog Box
Modify Dialog Box
New Data Range Filter Dialog Box
New Code Range Filter Dialog Box
Re-entrant Call Detection Dialog Box
Windows
Memory Window
Evaluations Window
Console Window
Source Window
Locals Window
Breakpoints Window
Callstack Window
Source Files Window
Assembler Window
Registers Window
Threads Window
Tasks Window
Barriers Window
Taskwaits Window
Locks Window
Teams Window
Spawn Tree Window
Vector Evaluations Window
Vector Registers Window
Thread Data Sharing Filters Window
Thread Data Sharing Events Window
Troubleshooting