Tools to debug threads and processes in Visual Studio
Applies to: 
Visual Studio 
Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
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 and features
The tools you need to use in Visual Studio depend on what type of code you are trying to debug:
For processes, the primary tools are the Attach to Process dialog box, the Processes window, and the Debug Location toolbar.
For threads, the primary tools for debugging threads are the Threads window, thread markers in source windows, Parallel Stacks window, Parallel Watch window, and the Debug Location toolbar.
For code that uses the Task in the Task Parallel Library (TPL), the Concurrency Runtime (native code), the primary tools for debugging multithreaded applications are the Parallel Stacks window, the Parallel Watch window, and the Tasks window (the Tasks window also supports the JavaScript promise object).
For debugging threads on the GPU, the primary tool is the 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 - 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 Tasks view - Flag or unflag a thread - Zoom |
| 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 |
| 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 |
| GPU Threads window | - The flag column, in which you can mark a thread that you want to pay special attention to. - The current thread column, in which a yellow arrow indicates the current thread. - 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 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 |