Skip to content

Commit fbaca72

Browse files
authored
Merge pull request #1177 from mezzode/wsl-debug
Update docs for WSL debugging
2 parents ddcc97d + 22f71ea commit fbaca72

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

Documentation/Debugger/gdb/Windows Subsystem for Linux.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
11
# Windows 10's Windows Subsystem for Linux
22
With the release of Windows 10 Creators Update (Build 15063), you will now be able to use Visual Studio Code and the Microsoft C/C++ extension to debug your `Windows Subsystem for Linux (WSL)` [Bash on Ubuntu](https://msdn.microsoft.com/en-us/commandline/wsl/about) projects.
33

4-
Code can be written on Windows itself using VSCode and debugged through `bash.exe` to the Bash on Windows layer.
4+
Code can be written on Windows itself using VSCode and debugged through `bash.exe` to the Bash on Windows layer.
5+
6+
As of the Fall Creator's Update, you can have multiple distros installed, but `bash.exe` and `wsl.exe` use the default distro. Use [WSL Config](https://msdn.microsoft.com/en-us/commandline/wsl/wsl-config) to set your default distro.
57

68
**NOTE: Creator's Update (Build 15063 or later) is required due to bugfixes within the subsystem that we rely on to provide debugging. Debugging using a previous version of WSL is unsupported and likely will not work. To check your Windows version, enter `winver` in a command prompt.**
79

810
## Prerequisites
9-
* [Windows 10 Creators Update with Windows Subsystem for Linux and Bash](https://msdn.microsoft.com/en-us/commandline/wsl/install_guide) installed.
11+
* [Windows 10 Creators Update or later with Windows Subsystem for Linux](https://msdn.microsoft.com/en-us/commandline/wsl/install_guide) installed.
1012
* Install g++/gcc and gdb within `WSL` to allow compiling and debugging. You can use the package manager to do this. For example, to install g++, you can run `sudo apt install g++` in the Bash window.
1113
* [Visual Studio Code](https://code.visualstudio.com) + Microsoft C/C++ extension for VSCode.
1214

0 commit comments

Comments
 (0)