The
Debug
view shows the target debugging information in a tree hierarchy.
The number beside the host thread label is a reference counter, not a thread identification number (TID).
Nsight displays stack frames as child elements. On the host, it displays the reason for the suspension (such as end of stepping range, breakpoint hit, and signal received) on the thread label . Reason will be shown on the kernel label if debugger suspends in the device code. When a program exits, the exit code is displayed.
The icons that appear in the Debug view include:
| Icons | Name | Description |
|---|---|---|
| Launch instance | Launch configuration name and launch type | |
![]() |
CUDA Kernel | Kernel name, ID, device the kernel is running on |
![]() |
Kernel focus thread | Suspended device thread. See Navigating CUDA application state for details. |
![]() |
Pinned device thread | Pinned device thread |
| Stack frame | Stack frame number, function, file name, and file line number | |
![]() |
All CUDA Threads | Contains all running blocks and threads |
![]() |
Block | Block Idx, device SM where the block is running |
![]() |
Device thread | Thread Idx, warp and lane where the thread is running |
| Host (CPU) process | Shows executable path, PID and CPU cores used | |
| Host (CPU) thread | Host thread number and state | |
| Debugger instance | Debugger name and state |
In addition to controlling the individual stepping of your programs, you can also control the debug session. You can perform actions such as terminating the session and stopping the program by using the debug launch controls available from Debug view.
The table below lists the toolbar options displayed in the Debug view.
| Icons | Name | Description |
|---|---|---|
![]() |
Toggle pinned state | Pins or unpins selected device thread |
| Remove All Terminated Launches | Clears all terminated processes in Debug view | |
| Resume | Select the Resume command to resume execution of the currently suspended debug target. | |
| Suspend | Select the Suspend command to halt execution of the currently selected thread in a debug target. | |
| Terminate | Ends the selected debug session and/or process. The impact of this action depends on the type of the item selected in the Debug view. | |
| Disconnect | Detaches the debugger from the selected process (useful for debugging attached processes). | |
| Step Into | Select to execute the current line, including any routines, and proceed to the next statement. | |
| Step Over | Select to execute the current line, following execution inside a routine. | |
| Step Return | Select to continue execution to the end of the current routine, then follow execution to the routine's caller. | |
| Drop to Frame | Select the Drop to Frame command to re-enter the selected stack frame in the Debug view. | |
| Instruction Stepping Mode | Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. | |
| Use Step Filters | Select the Use Step Filters command to change whether step filters should be used in the Debug view. | |
| Menu | Use the Debug view menu
to:
|
The Debug view context menu commands include:
| Icons | Name | Description |
|---|---|---|
![]() |
Toggle pinned state | Pins or unpins selected device thread |
| Copy Stack | Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard. | |
| Find... | Opens the debug view element searching dialog. | |
| Drop To Frame | Select the Drop to Frame command to re-enter the selected stack frame in the Debug view. | |
| Step Into | Select to execute the current line, including any routines, and proceed to the next statement. | |
| Step Over | Select to execute the current line, following execution inside a routine. | |
| Step Return | Select to continue execution to the end of the current routine, then follow execution to the routine's caller. | |
| Instruction Stepping Mode | Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. | |
| Use Step Filters | Toggles step filters on/off. When on, all step functions apply step filters. | |
| Resume Without Signal | Resume program execution after receiving the signal. | |
| Resume | Select the Resume command to resume execution of the currently suspended debug target. | |
| Suspend | Select the Suspend command to halt execution of the currently selected thread in a debug target. | |
| Terminate | Ends the selected debug session and/or process. The impact of this action depends on the type of the item selected in the Debug view. | |
| Terminate and Relaunch | Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it. | |
| Disconnect | Detaches the debugger from the selected process (useful for debugging attached processes) | |
| Remove All Terminated | Clears all terminated processes in Debug view | |
| Terminate and Remove | Terminates the selected debug target and removes it from the view. | |
| Terminate/Disconnect All | Terminates or disconnects all active launches in the view. | |
| Properties | Opens the Properties for window showing the process properties. |
Debug overview
Debug information
Debugging
Navigating
CUDA application state
CUDA view
Run and Debug dialog box
Debug Breadcrumb
C/C++ Views