[Lldb-commits] [lldb] [lldb] Document DBGSearchPaths (PR #178634)

[Jonas Devlieghere via lldb-commits]

https://github.com/JDevlieghere created https://github.com/llvm/llvm-project/pull/178634

Document DBGSearchPaths on the Symbols on macOS page.

rdar://169137293

>From cb88d0f325ffcf1ef61e05fe43462b85d1d7ecab Mon Sep 17 00:00:00 2001
From: Jonas Devlieghere <jonas at devlieghere.com>
Date: Thu, 29 Jan 2026 11:16:16 +0000
Subject: [PATCH] [lldb] Document DBGSearchPaths

Document DBGSearchPaths on the Symbols on macOS page.

rdar://169137293
---
 lldb/docs/use/symbols.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/lldb/docs/use/symbols.rst b/lldb/docs/use/symbols.rst
index b2de52c306f1a..4b01e5730b23b 100644
--- a/lldb/docs/use/symbols.rst
+++ b/lldb/docs/use/symbols.rst
@@ -73,6 +73,19 @@ this default is set to an empty array:
    # Specify an array of paths to limit spotlight searches to certain directories
    % defaults write com.apple.DebugSymbols DBGSpotlightPaths -array /path/dir1 /path/dir2
 
+
+**DBGSearchPaths**
+
+You can specify an ordered list of directories to use when manually searching
+for dSYM files. Each directory will be recursively searched for any dSYM
+bundles, and the the first UUID match will be returned.
+
+::
+
+   $ defaults write com.apple.DebugSymbols DBGSearchPaths -string /single/path/to/search
+   $ defaults write com.apple.DebugSymbols DBGSearchPaths -array /path/to/search1 /path/to/search2
+
+
 Shell Script Property List Format
 ---------------------------------