Support LLDB-DAP as a debugger (OSX/Linux/Windows)

Extension/.scripts/generateOptionsSchema.ts

@@ -134,6 +134,10 @@ export async function main() {
     packageJSON.contributes.debuggers[1].configurationAttributes.launch = schemaJSON.definitions.CppvsdbgLaunchOptions;
     packageJSON.contributes.debuggers[1].configurationAttributes.attach = schemaJSON.definitions.CppvsdbgAttachOptions;
 
+    // cpplldb
+    packageJSON.contributes.debuggers[2].configurationAttributes.launch = schemaJSON.definitions.CpplldbLaunchOptions;
+    packageJSON.contributes.debuggers[2].configurationAttributes.attach = schemaJSON.definitions.CpplldbAttachOptions;
+
     let content: string = JSON.stringify(packageJSON, null, 4);
 
     // We use '\u200b' (unicode zero-length space character) to break VS Code's URL detection regex for URLs that are examples. This process will

Extension/package.nls.json

@@ -979,6 +979,69 @@
     "c_cpp.debuggers.vsCodeCommand.description": "VS Code command to be invoked. Can be a command in VS Code or an active extension.",
     "c_cpp.debuggers.vsCodeCommand.command.description": "VS Code command to be invoked.",
     "c_cpp.debuggers.vsCodeCommand.args.description": "Arguments to the VS Code command.",
+    "c_cpp.debuggers.cpplldb.debuggerPath.description": {
+        "message": "Full path to the LLDB-DAP debugger executable. If not specified, the extension will search for the debugger in the system PATH.",
+        "comment": [
+            "{Locked=\"LLDB-DAP\"} {Locked=\"PATH\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.debuggerArgs.description": {
+        "message": "Additional arguments for the LLDB-DAP debugger.",
+        "comment": [
+            "{Locked=\"LLDB-DAP\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.externalConsole.description": "If true, launch the external console for the debugger.",
+    "c_cpp.debuggers.cpplldb.disableAslr.description": "Disable Address Space Layout Randomization (if supported).",
+    "c_cpp.debuggers.cpplldb.disableStdio.description": "Disables the standard input/output streams during debugging.",
+    "c_cpp.debuggers.cpplldb.expandShellArguments.description": "Expands program arguments as a shell would (does not actually launch the program in a shell).",
+    "c_cpp.debuggers.cpplldb.detachOnError.description": "Detach the debugger when an error occurs.",
+    "c_cpp.debuggers.cpplldb.debuggerRoot.description": "The directory where relative object files can be located.",
+    "c_cpp.debuggers.cpplldb.targetTriple.description": "Overrides the target triple of the target program.",
+    "c_cpp.debuggers.cpplldb.platformName.description": "Overrides the platform name of the target program.",
+    "c_cpp.debuggers.cpplldb.initCommands.description": "LLDB commands executed upon debugger startup prior to creating the LLDB target.",
+    "c_cpp.debuggers.cpplldb.preRunCommands.description": "LLDB commands executed just before launching/attaching, after the LLDB target has been created.",
+    "c_cpp.debuggers.cpplldb.postRunCommands.description": "LLDB commands executed after launching when it's in a stopped state prior to any automatic continuation.",
+    "c_cpp.debuggers.cpplldb.launchCommands.description": "Custom LLDB commands that are executed instead of launching a process.",
+    "c_cpp.debuggers.cpplldb.stopCommands.description": "LLDB commands executed each time the program stops.",
+    "c_cpp.debuggers.cpplldb.exitCommands.description": "LLDB commands executed when the program exits.",
+    "c_cpp.debuggers.cpplldb.terminateCommands.description": "LLDB commands executed when the debugging session ends.",
+    "c_cpp.debuggers.cpplldb.enableAutoVariableSummaries.description": "Enable auto-generated summaries for variables when no summaries exist for a given type. This feature can cause performance delays in large projects when viewing variables.",
+    "c_cpp.debuggers.cpplldb.displayExtendedBacktrace.description": "Enable language-specific extended backtraces.",
+    "c_cpp.debuggers.cpplldb.enableSyntheticChildDebugging.description": "If a variable is displayed using synthetic children, also display the actual contents of the variable at the end under an entry. This is useful when creating synthetic child plug-ins as it lets you see the actual contents of the variable.",
+    "c_cpp.debuggers.cpplldb.commandEscapePrefix.description": "The escape prefix character to use for executing regular LLDB commands in the Debug Console, instead of printing variables.",
+    "c_cpp.debuggers.cpplldb.customFrameFormat.markdownDescription": {
+        "message": "When specified, stack frames will have descriptions generated based on the provided format. See https://lldb.llvm.org/use/formatting.html.",
+        "comment": [
+            "{Locked=\"https://lldb.llvm.org/use/formatting.html\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.customThreadFormat.markdownDescription": {
+        "message": "When specified, threads will have descriptions generated based on the provided format. See https://lldb.llvm.org/use/formatting.html.",
+        "comment": [
+            "{Locked=\"https://lldb.llvm.org/use/formatting.html\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.attachCommands.description": "Custom LLDB commands that are executed instead of attaching to a process ID or to a process by name.",
+    "c_cpp.debuggers.cpplldb.waitFor.markdownDescription": {
+        "message": "Wait for the process to launch by looking for a process with a basename that matches the value specified in `program`.",
+        "comment": [
+            "{Locked=\"`program`\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.coreFile.description": "Path to the core file to debug.",
+    "c_cpp.debuggers.cpplldb.gdbRemotePort.markdownDescription": {
+        "message": "TCP/IP port to attach to a remote system. Specifying both `processId` and `port` is an error.",
+        "comment": [
+            "{Locked=\"`processId`\"} {Locked=\"`port`\"}"
+        ]
+    },
+    "c_cpp.debuggers.cpplldb.gdbRemoteHost.markdownDescription": {
+        "message": "The hostname to connect to a remote system. The default hostname is `localhost`.",
+        "comment": [
+            "{Locked=\"`localhost`\"}"
+        ]
+    },
     "c_cpp.taskDefinitions.name.description": "The name of the task.",
     "c_cpp.taskDefinitions.command.description": "The path to either a compiler or script that performs compilation.",
     "c_cpp.taskDefinitions.args.description": "Additional arguments to pass to the compiler or compilation script.",

Extension/src/Debugger/attachQuickPick.ts

@@ -28,6 +28,10 @@ class RefreshButton implements vscode.QuickInputButton {
 
 export interface AttachItem extends vscode.QuickPickItem {
     id?: string;
+    name?: string;
+    pid?: string;
+    commandLine?: string;
+    fullPath?: string;
 }
 
 // We should not await on this function.

Extension/src/Debugger/attachToProcess.ts

@@ -12,6 +12,7 @@ import * as path from 'path';
 import * as vscode from 'vscode';
 import * as nls from 'vscode-nls';
 import * as util from '../common';
+import { executableName, ProcessReturnType, spawnChildProcess } from '../common-remote-safe';
 import * as debugUtils from './utils';
 
 nls.config({ messageFormat: nls.MessageFormat.bundle, bundleFormat: nls.BundleFormat.standalone })();
@@ -21,13 +22,52 @@ export interface AttachItemsProvider {
     getAttachItems(token?: vscode.CancellationToken): Promise<AttachItem[]>;
 }
 
+/**
+ * Determines if a process matches the specified filter criteria.
+ *
+ * This function checks if the given process name or its full path matches
+ * the provided filter string. It also normalizes the filter string to handle
+ * relative paths and compares the executable name derived from the filter
+ * with the executable name of the process.
+ *
+ * @param filterTo - The filter string to match against. This can be a process name,
+ *                   an executable name, or a file path.
+ * @param processName - The name of the process to check.
+ * @param fullPath - The full path of the process executable, if available.
+ * @returns `true` if the process matches the filter criteria; otherwise, `false`.
+ */
+export function processMatches(filterTo: string, processName: string, fullPath: string | undefined) {
+    const normalized = path.resolve(filterTo);
+    const executable = executableName(filterTo);
+
+    // Filter out the processes that do not somehow match.
+    return processName === filterTo || executableName(processName) === executable || fullPath === filterTo || fullPath === normalized;
+}
+
 export class AttachPicker {
     constructor(private attachItemsProvider: AttachItemsProvider) { }
 
     // We should not await on this function.
     public async ShowAttachEntries(token?: vscode.CancellationToken): Promise<string | undefined> {
         return showQuickPick(() => this.attachItemsProvider.getAttachItems(token));
     }
+
+    /** Shows the Attach QuickPick, but if a valid filterTo process name/path is passed in, it only shows those entries. */
+    public async ShowAttachEntriesFiltered(filterTo?: string, token?: vscode.CancellationToken): Promise<string | undefined> {
+        return showQuickPick(async () => {
+
+            const items = await this.attachItemsProvider.getAttachItems(token);
+            if (filterTo) {
+                // Filter out the processes that do not somehow match.
+                const filtered = items.filter(each => processMatches(filterTo, each.label, each.fullPath));
+                if (filtered.length > 0) {
+                    // Only filter the list if we have actual matches.
+                    return filtered;
+                }
+            }
+            return items;
+        });
+    }
 }
 
 export class RemoteAttachPicker {
@@ -177,18 +217,17 @@ export class RemoteAttachPicker {
                             return 0;
                         }
                         return aLower < bLower ? -1 : 1;
-                    })
-                    .map(p => p.toAttachItem());
+                    });
             }
         }
     }
 
     private async getRemoteProcessesExtendedRemote(miDebuggerPath: string, miDebuggerServerAddress: string): Promise<AttachItem[]> {
         const args: string[] = [`-ex "target extended-remote ${miDebuggerServerAddress}"`, '-ex "info os processes"', '-batch'];
-        let processListOutput: util.ProcessReturnType = await util.spawnChildProcess(miDebuggerPath, args);
+        let processListOutput: ProcessReturnType = await spawnChildProcess(miDebuggerPath, args);
         // The device may not be responsive for a while during the restart after image deploy. Retry 5 times.
         for (let i: number = 0; i < 5 && !processListOutput.succeeded && processListOutput.outputError.length === 0; i++) {
-            processListOutput = await util.spawnChildProcess(miDebuggerPath, args);
+            processListOutput = await spawnChildProcess(miDebuggerPath, args);
         }
 
         if (!processListOutput.succeeded) {