GPU621/Sentinel

From CDOT Wiki
Revision as of 17:48, 23 November 2018 by Ezaytseva (talk | contribs) (Fix the images alignment)
Jump to: navigation, search

Multithreaded Application Debugging in Visual Studio

Group Members

  1. Ekaterina Zaytseva
  2. Mohammad Yasir
  3. Natan Ross
  4. eMail All

Introduction

Multithreaded applications debugging overview

Debugging is one of the crucial software development stages. While all of us know the importance and the basics of debugging in the Visual Studio, debugging the multithreaded applications is more complicated than that of the serial programs we were used to before. The first problem of the multithreaded debugging is keeping track of multiple threads instead of just one as we did with the serial programs. Secondly, having multiple threads introduces new kinds of bugs and issues that can seriously affect the output of the software. Such issues include race conditions and deadlocks. A race condition is the behavior of the system when the output is dependent on the sequence of other events or commands. It becomes a bug when the events are out of order (Race condition wiki). Deadlock is a situation when each member of the group (a group of threads in our case) is waiting for some other member to take action, it typically happens when mutual exclusion is executed incorrectly, and the lock on the resource cannot be released (Deadlock wiki).

Visual Studio tools for multithreaded debugging

Threads Window
Parallel Stacks Window
Parallel Watch Window
Debug Location Windows
Tasks Windows
GPU Threads Windows
Attach to Process Dialog
Processes Window

Visual Studio provides the developers with a variety of tools to assist with the multithreaded application debugging:

1. Threads window - Allows to view and manipulate the threads, also provides partial call stack for each of the threads

2. Thread markers - Icon resembling two cloth threads indicating where a thread is stopped. Provides a DataTip containing the name and thread ID, as well as thread manipulation shortcut menu

3. Parallel Stacks window - Shows call stack information for all the threads in the program

4. Parallel Watch window - Tracks the values produced by the multithreaded expression

5. Debug Location toolbar - Allows manipulating threads and processes

6. Tasks window - Lists all the current parallel and scheduled tasks

7. GPU Threads window - Allows working with the GPU threads

8. Attach to Process dialog box - Allows the developer to attach the VS debugger to the process, enables the process debugging

9. Processes window - Lists all the processes currently attached to the debugger

The tools mentioned above can be divided into the following categories depending on the multithreading technique:

1. Threads - Threads windows, Thread markers, Parallel Stacks window, Parallel Parallel Watch window, Debug Location toolbar

2. Tasks - Parallel Stacks window, Parallel Watch window, Tasks window

3. GPU Threads - GPU Threads window

4. Processes - Attach to Process dialog, Processes window, Debug Location toolbar

For our project, we are going to do OpenMP debugging, so we will need the following tools:

  • Breakpoints
  • Watch window
  • Thread markers
  • Threads window
  • Parallel Watch window
  • Parallel Stacks window


Basic Debugging Steps

  1. Setting up a Solution in Visual Studio 2017 Comunity Edition
  2. Build in Debug mode
  3. Double-check the outputs
  4. Start where the bug is

Setting up a Solution in Visual Studio 2017 Comunity Edition

This tutorial begins after the installation and setup of Intel Parallel Studios. Also, you should already have openMP running properly on your setup.

1. Create a new project and select the properties.

Properties.png

2. Click the configuration manager at the top right of your properties window.

3. Create a new configuration

New Configuration.png

4. Copy your current working openMP configuration for the current project (with the working openMP solution) and give the new configuration a nice name

Copy Old Configuration.png.

5. Go to the C/C++ configuration and then select optimization. Ensure that optimization is turned off for debugging.

Optimization Off.png

6. Finally, ensure that all threads stop when hitting a breakpoint by editing the debug configuration and enabling the setting Break all processes when one process breaks.

BreakAll.png

How to Debug Multithreaded Application in VS

  1. Tools in more detail (maybe show an example ourselves)
  2. Walkthrough (workshop-style)

Note: Add the link to the configurations