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

@@ -951,6 +951,33 @@
     "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": "Full path to the LLDB-DAP debugger executable. If not specified, the extension will search for the debugger in the system PATH.",
+    "c_cpp.debuggers.cpplldb.debuggerArgs.description": "Additional arguments for the LLDB-DAP 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": "Expand 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 to where relative object files can be located.",
+    "c_cpp.debuggers.cpplldb.targetTriple.description": "Overrides the triplet 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 ommands 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 a synthetic children, also display the actual contents of the variable at the end under an entry. This is useful when creating sythetic 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.description": "When specified, stack frames will have descriptions generated based on the provided format. See https://lldb.llvm.org/use/formatting.html",
+    "c_cpp.debuggers.cpplldb.customThreadFormat.description": "When specified, threads will have descriptions generated based on the provided format. See 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.description": "Wait for the process to launch by looking for a process with a basename that matches `program`.",
+    "c_cpp.debuggers.cpplldb.coreFile.description": "Path to the core file to debug.",
+    "c_cpp.debuggers.cpplldb.gdbRemotePort.description": "TCP/IP port to attach to a remote system. Specifying both processId and port is an error.",
+    "c_cpp.debuggers.cpplldb.gdbRemoteHost.description": "The hostname to connect to a remote system. The default hostname being used 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

@@ -21,13 +21,38 @@ export interface AttachItemsProvider {
     getAttachItems(token?: vscode.CancellationToken): Promise<AttachItem[]>;
 }
 
+export function processMatches(filterTo: string, processName: string, fullPath: string | undefined) {
+    const normalized = path.resolve(filterTo);
+    const executable = util.executableName(filterTo);
+
+    // Filter out the processes that do not somehow match.
+    return processName === filterTo || util.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,8 +202,7 @@ export class RemoteAttachPicker {
                             return 0;
                         }
                         return aLower < bLower ? -1 : 1;
-                    })
-                    .map(p => p.toAttachItem());
+                    });
             }
         }
     }