Changeset 86327 in vbox for trunk/src/VBox/VMM

Timestamp:

Sep 28, 2020 4:20:50 PM (4 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

140613

Message:

Debugger: Allow for different I/O providers instead of only TCP

So far TCP was the only option to communicate remotely with the internal debugger, the other option
was to use the console from the GUI directly. This commit reworks basic I/O to allow for different
providers where TCP is just one option. The second one being introduced is an IPC provider using a local
socket or named pipe depending on the platform. This allows for Windows kernel debugging over a pipe
using the KD stub in VirtualBox and WinDbg running on the host (not tested yet).

Furthermore this commit allows multiple stubs to be listening for connections at the same time, so
one can have a GDB stub listening on one TCP port and the native VBox debugger listening on another one
or even using a different I/O provider. Only one session can be active at a time though, because sharing
debugger states is impossible. To configure this the following CFGM keys need to be set for each listener:

"DBGC/<Some unique ID>/Provider" "tcp|ipc"
"DBGC/<Some unique ID>/StubType" "native|gdb|kd"
"DBGC/<Some unique ID>/Address" "<ip>|<local named pipe or socket path>"
"DBGC/<Some unique ID>/Port" "<port>" (for TCP only)

File:

• trunk/src/VBox/VMM/VMMR3/VM.cpp (modified) (3 diffs)

trunk/src/VBox/VMM/VMMR3/VM.cpp

@@ -650 +650 @@
                              */
                             void *pvUser = NULL;
-                            rc = DBGCTcpCreate(pUVM, &pvUser);
+                            rc = DBGCIoCreate(pUVM, &pvUser);
                             if (    RT_SUCCESS(rc)
                                 ||  rc == VERR_NET_ADDRESS_IN_USE)
@@ -669 +669 @@
                                 }
 #ifdef VBOX_WITH_DEBUGGER
-                                DBGCTcpTerminate(pUVM, pUVM->vm.s.pvDBGC);
+                                DBGCIoTerminate(pUVM, pUVM->vm.s.pvDBGC);
                                 pUVM->vm.s.pvDBGC = NULL;
                             }
@@ -2197 +2197 @@
         AssertRC(rc);
 #ifdef VBOX_WITH_DEBUGGER
-        rc = DBGCTcpTerminate(pUVM, pUVM->vm.s.pvDBGC);
+        rc = DBGCIoTerminate(pUVM, pUVM->vm.s.pvDBGC);
         pUVM->vm.s.pvDBGC = NULL;
 #endif