You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: launch.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,28 +2,28 @@
2
2
3
3
The **launch.json** file is used to configure the debugger in Visual Studio Code.
4
4
5
-
Visual Studio Code generates a **launch.json** with almost all of the required information. To get started
5
+
Visual Studio Code generates a **launch.json** with almost all of the required information. To get started
6
6
debugging you need to fill in the `program` field with the path to the executable you plan to debug. This must be specified for
7
7
both the launch and attach (if you plan to attach to a running instance at any point) configurations.
8
8
9
-
The generated file contains two sections. One that configures debugging for launch and a second that configures debugging for attach.
9
+
The generated file contains two sections. One that configures debugging for launch and a second that configures debugging for attach.
10
10
11
11
# Configure VS Code's debugging behavior
12
12
13
-
Set or change the following options to control VS Code's behavior during debugging
13
+
Set or change the following options to control VS Code's behavior during debugging:
14
14
15
15
*#### `program` (required)
16
16
Specifies the full path to executable the debugger will launch or attach to.
17
17
18
18
*#### `symbolSearchPath`
19
-
Tells the _Visual Studio Windows Debugger_ what paths to search for symbol (.pdb) files. Separate multiple paths with a semicolon. Example `"C:\\Symbols;C:\\SymbolDir2"`
19
+
Tells the _Visual Studio Windows Debugger_ what paths to search for symbol (.pdb) files. Separate multiple paths with a semicolon. Example `"C:\\Symbols;C:\\SymbolDir2"`.
20
20
21
21
*#### `additionalSOLibSearchPath`
22
22
Tells _GDB or LLDB_ what paths to search for .so files. Separate multiple paths with a semicolon. Example: `"/Users/user/dir1;/Users/user/dir2"`.
23
23
24
24
*#### `externalConsole`
25
25
Windows: When set to true, it will spawn an external console. When set to false, it will use VS Code's integratedTerminal.
26
-
Linux: When set to true, it will notify VS Code to spawn an external console. When set to false, it will use VS Code's integratedTerminal
26
+
Linux: When set to true, it will notify VS Code to spawn an external console. When set to false, it will use VS Code's integratedTerminal.
27
27
macOS: When set to true, it will spawn an external console through `lldb-mi`. When set to false, the output can be seen in VS Code's debugConsole. Due to limitations within `lldb-mi`, integratedTerminal support is not available.
28
28
29
29
*#### `logging`
@@ -96,10 +96,10 @@ The following options enable you to modify the state of the target application w
96
96
97
97
## Customizing GDB or LLDB
98
98
99
-
You can change the behavior of GDB or LLDB by setting the following options.
99
+
You can change the behavior of GDB or LLDB by setting the following options:
100
100
101
101
*#### `MIMode`
102
-
Indicates the debugger that VS Code will connect to. Must be set to `gdb` or `lldb`. This is pre-configured on a per-operating system basis and can be changed as needed.
102
+
Indicates the debugger that VS Code will connect to. Must be set to `gdb` or `lldb`. This is pre-configured on a per-operating system basis and can be changed as needed.
103
103
104
104
*#### `miDebuggerPath`
105
105
The path to the debugger (such as gdb). When only the executable is specified, it will search the operating system's PATH variable for a debugger (GDB on Linux and Windows, LLDB on OS X).
@@ -154,7 +154,7 @@ The C/C++ extension enables debugging dump files on Windows and core dump files
154
154
If you want to debug a Windows dump file, set this to the path to the dump file to start debugging in the `launch` configuration.
155
155
156
156
*#### `coreDumpPath`
157
-
Full path to a core dump file to debug for the specified program. Set this to the path to the core dump file to start debugging in the `launch` configuration.
157
+
Full path to a core dump file to debug for the specified program. Set this to the path to the core dump file to start debugging in the `launch` configuration.
158
158
_Note: core dump debugging is not supported with MinGw._
159
159
160
160
## Remote debugging or debugging with a local debugger server
@@ -177,7 +177,7 @@ _Note: core dump debugging is not supported with MinGw._
177
177
## Additional properties
178
178
179
179
*#### `processId`
180
-
Defaults to `${command.pickProcess}` which will display a list of available processes the debugger can attach to. It is recommended to leave this default, but the property can be explicitly set to a specific process ID for the debugger to attach to.
180
+
Defaults to `${command.pickProcess}` which will display a list of available processes the debugger can attach to. It is recommended to leave this default, but the property can be explicitly set to a specific process ID for the debugger to attach to.
181
181
182
182
*#### `request`
183
183
Indicates whether the configuration section is intended to `launch` the program or `attach` to an already running instance.
@@ -186,7 +186,7 @@ _Note: core dump debugging is not supported with MinGw._
186
186
`Deprecated` This option is no longer needed as the target architecture is automatically detected.
187
187
188
188
*#### `type`
189
-
Indicates the underlying debugger being used. Must be `cppvsdbg` when using the Visual Studio Windows debugger, and `cppdbg` when using GDB or LLDB. This is automatically set to the correct value when the
189
+
Indicates the underlying debugger being used. Must be `cppvsdbg` when using the Visual Studio Windows debugger, and `cppdbg` when using GDB or LLDB. This is automatically set to the correct value when the
0 commit comments