https://github.com/DavidSpickett updated https://github.com/llvm/llvm-project/pull/171468
>From 0c3d5744c86ad069e20f30e83f1bc8dfdc61aeae Mon Sep 17 00:00:00 2001 From: David Spickett <[email protected]> Date: Tue, 9 Dec 2025 16:11:51 +0000 Subject: [PATCH 1/3] [lldb][docs] Describe how to check enabled features This makes use of `version -v` added by #170772, along with a fallback method for LLDB prior to 22. The fallback uses readelf because running ldd on binaries you don't trust is not a good idea. https://man7.org/linux/man-pages/man1/ldd.1.html "some versions of ldd may attempt to obtain the dependency information by attempting to directly execute the program" People will be inspecting downloaded builds of LLDB so this is best avoided. --- lldb/docs/use/troubleshooting.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/lldb/docs/use/troubleshooting.rst b/lldb/docs/use/troubleshooting.rst index e6604f6ecffea..c25371ec3c615 100644 --- a/lldb/docs/use/troubleshooting.rst +++ b/lldb/docs/use/troubleshooting.rst @@ -97,3 +97,33 @@ for any source file and line breakpoints that the IDE set using: :: (lldb) breakpoint list --verbose + +How Do I Find Out What Features My Version Of LLDB Has? +------------------------------------------------------- + +Some features such as XML parsing are optional and must be enabled when LLDB is +built. To check which features your copy of LLDB has enabled, use the ``version`` +command from within LLDB: + +:: + + (lldb) version -v + +.. note:: + This feature was added in LLDB 22. If you are using an earlier version, you + can use the method below. + +Alternatively, you can check the shared library dependencies of LLDB. For example +on Linux you can use the following command: + +:: + + $ readelf -d ./bin/lldb | grep NEEDED + 0x0000000000000001 (NEEDED) Shared library: [liblldb.so.22.0git] + 0x0000000000000001 (NEEDED) Shared library: [libxml2.so.2] + 0x0000000000000001 (NEEDED) Shared library: [libedit.so.2] + <...> + 0x0000000000000001 (NEEDED) Shared library: [libc.so.6] + +The output above shows us that this particular copy of LLDB has XML parsing +(``libxml2``) and editline (``libedit``) enabled. >From 1abd8e615d477aab5a41f6fd6058e5ae7e427d85 Mon Sep 17 00:00:00 2001 From: David Spickett <[email protected]> Date: Tue, 9 Dec 2025 16:17:57 +0000 Subject: [PATCH 2/3] remove a bit of a path --- lldb/docs/use/troubleshooting.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lldb/docs/use/troubleshooting.rst b/lldb/docs/use/troubleshooting.rst index c25371ec3c615..83748bb0570eb 100644 --- a/lldb/docs/use/troubleshooting.rst +++ b/lldb/docs/use/troubleshooting.rst @@ -118,7 +118,7 @@ on Linux you can use the following command: :: - $ readelf -d ./bin/lldb | grep NEEDED + $ readelf -d lldb | grep NEEDED 0x0000000000000001 (NEEDED) Shared library: [liblldb.so.22.0git] 0x0000000000000001 (NEEDED) Shared library: [libxml2.so.2] 0x0000000000000001 (NEEDED) Shared library: [libedit.so.2] >From b3aa6ca8032ac1de415bcd02310c0c71f41055fd Mon Sep 17 00:00:00 2001 From: David Spickett <[email protected]> Date: Tue, 9 Dec 2025 16:18:26 +0000 Subject: [PATCH 3/3] what -> which --- lldb/docs/use/troubleshooting.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lldb/docs/use/troubleshooting.rst b/lldb/docs/use/troubleshooting.rst index 83748bb0570eb..92c811609d7d5 100644 --- a/lldb/docs/use/troubleshooting.rst +++ b/lldb/docs/use/troubleshooting.rst @@ -98,8 +98,8 @@ for any source file and line breakpoints that the IDE set using: (lldb) breakpoint list --verbose -How Do I Find Out What Features My Version Of LLDB Has? -------------------------------------------------------- +How Do I Find Out Which Features My Version Of LLDB Has? +-------------------------------------------------------- Some features such as XML parsing are optional and must be enabled when LLDB is built. To check which features your copy of LLDB has enabled, use the ``version`` _______________________________________________ lldb-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-commits
