From cb1e09f53c0e6a9323f52ceff78d017aac84a152 Mon Sep 17 00:00:00 2001
From: wangzhankun <bitwangzhankun@gmail.com>
Date: Sun, 21 Jan 2024 16:47:21 +0800
Subject: [PATCH 1/3] add postRemoteConnectCommands comment
---
docs/cpp/launch-json-reference.md | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/docs/cpp/launch-json-reference.md b/docs/cpp/launch-json-reference.md
index 2506963241..88d7d5bbe7 100644
--- a/docs/cpp/launch-json-reference.md
+++ b/docs/cpp/launch-json-reference.md
@@ -143,6 +143,12 @@ If set to true, the debugger should stop after connecting to the target. If set
JSON array of commands to execute in order to set up the GDB or LLDB. Example: `"setupCommands": [ { "text": "target-run", "description": "run target", "ignoreFailures": false }]`.
+### postRemoteConnectCommands
+
+JSON array of commands to execute in order to set up the GDB or LLDB. Example: `"postRemoteConnectCommands": [ { "description": "set hardware breakpoints", "text": "break main.cpp:20", "ignoreFailures": false } ]`.
+
+The difference between `setupCommands` and `postRemoteConnectCommands` is that `setupCommands` are executed before loading the debug target, while `postRemoteConnectCommands` are executed after loading the debug target.
+
### customLaunchSetupCommands
If provided, this replaces the default commands used to launch a target with some other commands. For example, this can be "-target-attach" in order to attach to a target process. An empty command list replaces the launch commands with nothing, which can be useful if the debugger is being provided launch options as command-line options. Example: `"customLaunchSetupCommands": [ { "text": "target-run", "description": "run target", "ignoreFailures": false }]`.
From 562c6ece77573323c6243c49a47889d360485ba5 Mon Sep 17 00:00:00 2001
From: wangzhankun <bitwangzhankun@gmail.com>
Date: Sun, 21 Jan 2024 17:18:00 +0800
Subject: [PATCH 2/3] add gdb-commands.md file
---
docs/cpp/gdb-commands.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
create mode 100644 docs/cpp/gdb-commands.md
diff --git a/docs/cpp/gdb-commands.md b/docs/cpp/gdb-commands.md
new file mode 100644
index 0000000000..2a56b53467
--- /dev/null
+++ b/docs/cpp/gdb-commands.md
@@ -0,0 +1,19 @@
+---
+Order:
+Area: cpp
+TOCTitle: Setup Help for GDB-COMMANDS
+ContentId: 1097b015-54b7-4e87-afc9-25a36e7357e8
+PageTitle: The execution order of GDB commands to set up GDB
+DateApproved: 1/22/2024
+MetaDescription: The execution order of GDB commands
+---
+
+# The execution order of GDB commands to set up GDB
+
+In the VS code environment, there are some ways to set up GDB when debugging C/C++ applications:
+
+1. `.gdbinit` file in the directory indicated by the `"cwd"` field in the `launch.json`
+2. `"setupCommands"` filed in `launch.json`
+3. `"postRemoteConnectCommands"` filed in `launch.json`
+
+When starting debugging, the working directory for gdb is specified by the "cwd" field in `launch.json`. When gdb is launched, it automatically searches for the `.gdbinit` file in the working directory and executes the commands from `.gdbinit`. And then, GDB will execute the commands from `"setupCommands"` filed and `"postRemoteConnectCommands"` filed. The difference between `setupCommands` and `postRemoteConnectCommands` is that `setupCommands` are executed before loading the debug target, while `postRemoteConnectCommands` are executed after loading the debug target.
From ed23df8b6f2f9cb5d1dce34d45a2bb9b1efc27c2 Mon Sep 17 00:00:00 2001
From: wangzhankun <bitwangzhankun@gmail.com>
Date: Mon, 22 Jan 2024 14:23:09 +0800
Subject: [PATCH 3/3] update gdb-commands.md
---
docs/cpp/gdb-commands.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/cpp/gdb-commands.md b/docs/cpp/gdb-commands.md
index 2a56b53467..278dbf5a24 100644
--- a/docs/cpp/gdb-commands.md
+++ b/docs/cpp/gdb-commands.md
@@ -17,3 +17,5 @@ In the VS code environment, there are some ways to set up GDB when debugging C/C
3. `"postRemoteConnectCommands"` filed in `launch.json`
When starting debugging, the working directory for gdb is specified by the "cwd" field in `launch.json`. When gdb is launched, it automatically searches for the `.gdbinit` file in the working directory and executes the commands from `.gdbinit`. And then, GDB will execute the commands from `"setupCommands"` filed and `"postRemoteConnectCommands"` filed. The difference between `setupCommands` and `postRemoteConnectCommands` is that `setupCommands` are executed before loading the debug target, while `postRemoteConnectCommands` are executed after loading the debug target.
+
+In some cases, we may need to load the `.gdbinit` file after loading the debugging target, for example, set hardware breakpoint. In such cases, it is recommended to rename the `.gdbinit` file, for example, to hello.gdbinit, and then add `{"text": "source /path/to/hello.gdbinit"}` to the `postRemoteConnectCommands` field.