From d07f237cded02cd172e4a407bd968e10285ed4fd Mon Sep 17 00:00:00 2001 From: Ebuka Ezike Date: Fri, 19 Dec 2025 11:16:51 +0000 Subject: [PATCH] [lldb-dap] Document stopOnEntry when attaching. (#172927) We have always supported it but it was undocumented. It shows a warning unknown key when added in vscode attach configuration. --- lldb/tools/lldb-dap/README.md | 1 + lldb/tools/lldb-dap/package.json | 5 +++++ 2 files changed, 6 insertions(+) diff --git a/lldb/tools/lldb-dap/README.md b/lldb/tools/lldb-dap/README.md index e83384f89bc1..7aa59ef1b725 100644 --- a/lldb/tools/lldb-dap/README.md +++ b/lldb/tools/lldb-dap/README.md @@ -276,6 +276,7 @@ the following `lldb-dap` specific key/value pairs: | **program** | string | | Path to the executable to attach to. This value is optional but can help to resolve breakpoints prior the attaching to the program. | **pid** | number | | The process id of the process you wish to attach to. If **pid** is omitted, the debugger will attempt to attach to the program by finding a process whose file name matches the file name from **program**. Setting this value to `${command:pickMyProcess}` will allow interactive process selection in the IDE. | **waitFor** | boolean | | Wait for the process to launch. +| **stopOnEntry** | boolean | | Whether to stop program immediately after attaching. | **attachCommands** | [string] | | LLDB commands that will be executed after **preRunCommands** which take place of the code that normally does the attach. The commands can create a new target and attach or launch it however desired. This allows custom launch and attach configurations. Core files can use `target create --core /path/to/core` to attach to core files. ### Configuring `lldb-dap` defaults diff --git a/lldb/tools/lldb-dap/package.json b/lldb/tools/lldb-dap/package.json index 75d86f74a95d..9d058fb4fd95 100644 --- a/lldb/tools/lldb-dap/package.json +++ b/lldb/tools/lldb-dap/package.json @@ -727,6 +727,11 @@ "description": "If set to true, then wait for the process to launch by looking for a process with a basename that matches `program`. No process ID needs to be specified when using this flag.", "default": true }, + "stopOnEntry": { + "type": "boolean", + "description": "Automatically stop after attach.", + "default": false + }, "sourcePath": { "type": "string", "description": "Specify a source path to remap \"./\" to allow full paths to be used when setting breakpoints in binaries that have relative source paths."