Debug Threads and Processes in Visual Studio

Threads and processes are related concepts in computer science. Both represent sequences of instructions that must execute in a specific order. Instructions in separate threads or processes, however, can execute in parallel.

Processes exist in the operating system and correspond to what users see as programs or applications. A thread, on the other hand, exists within a process. For this reason, threads are sometimes referred to as light-weight processes. Each process consists of one or more threads.

The existence of multiple processes enables a computer to perform more than one task at a time. The existence of multiple threads enables a process to separate work to be performed in parallel. On a computer with multiprocessors, processes or threads can run on different processors. This enables true parallel processing.

Perfect parallel processing is not always possible. Threads sometimes must be synchronized. One thread may have to wait for a result from another thread, or one thread may need exclusive access to a resource that another thread is using. Synchronization problems are a common cause of bugs in multithreaded applications. Sometimes threads may end up waiting for a resource that never becomes available. This results in a condition called deadlock.

The Visual Studio debugger provides powerful but easy-to-use tools for debugging threads and processes.

Tools for Debugging Threads and Processes in Visual Studio

The primary tools for working with processes in Visual Studio are the Attach to Process dialog box, the Processes window, and the Debug Location toolbar. The primary tools for debugging threads are the Threads window, thread markers in source windows, and the Debug Location toolbar.

The primary tools for debugging multithreaded applications are the Parallel Stacks and Parallel Tasks, Parallel Watch, and GPU Threads windows.

The following table shows the information available and the actions you can perform in each of these places:

User Interface	Information Available	Actions You Can Perform
Attach to Process dialog box	Available Processes you can attach to: Process name (.exe) Process ID number Menubar Title Type (Managed v4.0; Managed v2.0, v1.1, v1.0; x86; x64; IA64) User Name (account name) Session number	Select a process to attach to Select a remote computer Change transport type for connecting to remote computers
Processes window	Attached Processes: Process Name Process ID number Path to process .exe Menubar Title State (Break. Running) Debugging (Native, Managed, and so on.) Transport type (default, native with no authentication) Transport Qualifier (remote computer)	Tools: Attach Detach Terminate Shortcut menu: Attach Detach Detach when debugging stopped Terminate
Threads window	Threads in current process: Thread ID Managed ID Category (main thread, interface thread, remote procedure call handler, or worker thread) Thread Name Location where thread is created Priority Affinity Mask Suspended Count Process Name Flag Indicator Suspended indicator	Tools: Search Search Call Stack Flag Just My Code Flag Custom Module Selection Group by Columns Expand/Collapse callstacks Expand/Collapse groups Freeze/Thaw Threads Shortcut menu: Show threads in source Switch to a thread Freeze a running thread Thaw a frozen thread Flag a thread for additional study Unflag a thread Rename a thread Show and hide threads Other actions: View the call stack for a thread in a DataTip
Source window	Thread indicators in left gutter indicate single or multiple threads (off by default, turned on by using shortcut menu in Threads window)	Shortcut menu: Switch to a thread Flag a thread for additional study Unflag a thread
Debug Location toolbar	Current process Show the application thumbnail Suspend the application Resume the application Suspend and shut down the application Current thread Toggle current thread flag state Show only flagged threads Show only current process Current stack frame	Switch to another process Suspend, resume, or shut down the application Switch to another thread in current process Switch to another stack frame in current thread Flag or unflag current threads Show only flagged threads Show only the current process
Parallel Stacks window	Call stacks for multiple threads in one window. Active stack frame for each thread. Callers and callees for any method.	Filter out specified threads Switch to Parallel Tasks view Flag or unflag a thread Zoom
Parallel Tasks window	View information about Task objects including task ID, task status (scheduled, running, waiting, deadlocked), and which thread is assigned to the task. Current location in call stack. Delegate passed to the task at creation time	Switch to current task Flag or unflag a task Freeze or thaw a task
Parallel Watch window	The flag column, in which you can mark a thread that you want to pay special attention to. The frame column, in which an arrow indicates the selected frame. A configurable column that can display the machine, process, tile, task, and thread.	Flag or unflag a thread Display only flagged threads Switch frames Sort a column Group threads Freeze or thaw threads export the data in the Parallel Watch window
GPU Threads window	The flag column, in which you can mark a thread that you want to pay special attention to. The active thread column, in which a yellow arrow indicates an active thread. An arrow indicates a thread where execution broke into the debugger. The Thread Count column, which displays the number of threads at the same location. The Line column, which displays the line of code where each group of threads is located. The Address column, which displays the instruction address where each group of threads is located. The Location column, which is the location in the code of the address. The Status column, which shows whether the thread is active or blocked. The Tile column, which shows the tile index for the threads in the row.	Change to a different active thread Display a particular tile and thread Display or hide a column Sort by a column Group threads Freeze or thaw threads Flag or unflag a thread Display only flagged threads

See Also

Other Resources

Attach to Running Processes with the Visual Studio Debugger

Debug Multithreaded Applications in Visual Studio

Debugging GPU Code