GPU621/Group 5
Investigative Report: Integrating OpenMP, TBB, and MPI into VSCode on MacOS v11.0+
Team
Introduction
Since 2020, there has been a lot of updates to the Mac OS ecosystem, and its command line interface. Which has caused for the dependancy documentation for integrating with Mac OS outdated. So this report is our comprehensive findings for interfacing with the OpenMP, TBB, and MPI libraries on Visual Studio Code to leverage Parallel Computing Concepts that are outlined in this course. As many Software Developers working on Mac already now, Visual Studio for Mac only supports some languages, one of which isn’t C/C++. So we’ll be using the common and popular text editor, Visual Studio Code. Visual Studio Code will allow us to use the command line interface for our compiler to integrate and option the dependancies that we want to use.
You should already have Visual Studio Code downloaded, if not, you can find the Download and Install for it here: Visual Studio Code - Code Editing. Redefined
Vocabulary
Going forward, we’ll be using these terms:
- CLI - Command Line Interface
- VScode - Visual Studio Code
Integrating
Pre-Tasks
Before we go into specifically each library, let’s talk about how VScode handles compilers. Within VSCode, when we create a .CPP file, we can either run the code in our terminal, or we can create a task that compiles our code before launching the executable with our runtime arguments. We’ll use this **task and launch** method to setup our environment for C++.
Start by creating a regular C++ workspace:
- Open up VScode and open a directory where you want to code
- Create a C++ file, for our example we’ll call it: `helloworld.cpp`
- You can add this code into it for now:
#include <iostream> int main(int argc, char const *argv[]) { std::cout << "Hello world"; return 0; }
Tasks
From here, we want to tell VScode what **tasks** to run when we press the Run and Debug button. This will be similar to how we use terminal to build our code.
- Press Command+Shift+P
- At the search bar that comes up, type: Tasks: Configure Task and press Enter
- You’ll may see another option come up, to choose what kind of task, select “C/C++: g++ build active file” (If you don’t have other C/C++ compilers installed, you may not, “C/C++: g++ build active file” will be the default)
- This will create a folder called .vscode with a JSON file called: tasks.json
- Open the tasks.json file, it should look like this:
{ "tasks": [ { "type": "cppbuild", // Type of task "label": "C/C++: g++ build active file", // Label for the task This is important!! for our launch file "command": "/usr/bin/g++", // Which command will be used "args": [ // All the arguments that will be used at buildtime "-fdiagnostics-color=always", // Use Diagnostic colors "-g", // Create debugger data to be used "${file}", // Compile this file "-o", // Output it as "${fileDirname}/${fileBasenameNoExtension}" // The File name without the .cpp extension ], "options": { "cwd": "${fileDirname}" // The working directory that we'll run our compiler in }, "problemMatcher": [ "$gcc" ], "group": { "kind": "build", "isDefault": true }, "detail": "Task generated by Debugger." } ], "version": "2.0.0" }
This task tells VScode, when we use this task, run [this].command with [this].args. VScode will inject this into our terminal to automatically compile our code. This will help our VScode Debugger and help our launch task get ready for running our code.
g++ -fdiagnostics-color=always -g helloworld.cpp -o ./helloworld
Launch
Our launch file will facilitate the execution of our code, in the task.json we compiled and produced an output, here we will run our code with the correct information.
- You can create a **launch.json** file by navigating to the RUN AND DEBUG: RUN section on the left side navigator, (or use Command+Shift+D)
- You’ll see an option there that says “To customize your Run and Debug create a launch.json file”. Choose this option, it will allow us to pass arguments into our code.
- This will create a JSON file called launch.json inside the .vscode folder from before. It will look something like this:
{ // Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: [1](https://go.microsoft.com/fwlink/?linkid=830387) "version": "0.2.0", "configurations": [] }
- i. You’ll see many options come up, we want to choose “C/C++: (lldb) Launch”.Now our launch.json should look like this:
{ // Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "name": "(lldb) Launch", // Name of our configuration "type": "cppdbg", // Type of Launch (This type is as C++ Debugger) "request": "launch", // We are requesting to launch our code "program": "enter program name, for example ${workspaceFolder}/a.out", // Here is where we will add the name of our file "args": [], // All arguments we want to use "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": false, "MIMode": "lldb" } ] }
OpenMP
OpenMP
TBB
TBB
MPI
MPI
Testing
OpenMP
OpenMP
TBB
TBB
MPI
MPI