Support auxiliary GDB connections to allow selected operations while CPU running (#181)

* Add `auxiliaryGdb` option to `gdbtarget` type.
Add docs for `auxiliaryGdb` option.

Signed-off-by: Jens Reinecke <[email protected]>

* changelog

Signed-off-by: Jens Reinecke <[email protected]>

---------

Signed-off-by: Jens Reinecke <[email protected]>

Author: jreineckearm

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## Unreleased
+
+- Implements [cdt-gdb-adapter `#442`](https://github.com/eclipse-cdt-cloud/cdt-gdb-adapter/issues/442): Support auxiliary GDB connections to allow selected operations while CPU running.
+
 ## 2.3.0
 
 - Documentation update: Clarify behavior of `initCommands` setting for `gdbtarget` type.

README.md

@@ -50,6 +50,7 @@ Launch and attach configuration settings that can be used with the `gdbtarget` d
 | `program` | x | x | `string` | Path to the program to be debugged. For `launch` requests, this program is also launched.<br>Default: `${workspaceFolder}/${command:askProgramPath}`, which allows to interactively enter the full program path.<br>**Note**: While `program` is marked as required, the debug adapter launches anyway for remote GDB connections. For example to inspect an embedded target system's memory and other hardware resources without debugging a program.  |
 | `gdbAsync` | x | x | `boolean` | Use `mi-async` mode for communication with GDB. Always `true` if `gdbNonStop` is `true`.<br>Default: `true` |
 | `gdbNonStop` | x | x | `boolean` | Use `non-stop` mode for controlling multiple threads.<br> Default: `false` |
+| `auxiliaryGdb` | x | x | `boolean` | Creates an auxiliary GDB connection to the target TCP port to allow memory accesses and expression evaluation while the target is running.<br>Default: `false`<br>**Notes**:<br>* Requires support for multiple connections to the same TCP port in connected GDB server.<br>* Requires `gdbAsync` mode and cannot be used with `gdbNonStop` mode. |
 | `verbose` | x | x | `boolean` | Produce verbose log output. |
 | `logFile` | x | x | `string` | Absolute path to the file to log interaction with GDB.|
 | `openGdbConsole` | x | x | `boolean` | *(UNIX-only)* Open a GDB console in your IDE while debugging. |

package.json

@@ -291,6 +291,11 @@
                 "description": "Use non-stop mode for controlling multiple threads. (defaults to false)",
                 "default": false
               },
+              "auxiliaryGdb": {
+                "type": "boolean",
+                "description": "Creates an auxiliary GDB connection to the target TCP port if supported by connected GDB server.\nRequires `gdbAsync` mode and cannot be used with `gdbNonStop` mode.",
+                "default": false
+              },
               "verbose": {
                 "type": "boolean",
                 "description": "Produce verbose log output",