diff --git a/FAQ/README.md b/FAQ/README.md index 6da175fdeeb..0f2c4b9d785 100644 --- a/FAQ/README.md +++ b/FAQ/README.md @@ -2146,38 +2146,14 @@ report](https://sourceware.org/bugzilla/show_bug.cgi?id=20266). #### How do I get the LLDB debugger? -CDT has experimental support for LLDB starting from CDT 9.1. The minimum -recommended version for LLDB is 3.8. +CDT has support for LLDB starting from CDT 9.1. The use of LLDB with CDT is +recommended for local macOS application debugging on Apple silicon (AArch64) only. - - Ubuntu - -Using Ubuntu 16.04, install with - -`sudo apt-get install lldb` - -This will install lldb 3.8 along with the necessary lldb-mi executable. -CDT should find lldb-mi on the PATH (environment variable). - -Note that previous versions of LLDB that were in previous Ubuntu -releases could be buggy and not as well tested with CDT. - - - Fedora - -Using Fedora 24, install with - -`sudo dnf install lldb` - -This will install lldb 3.8 along with the necessary lldb-mi executable. -CDT should find lldb-mi on the PATH (environment variable). - -Note that previous versions of LLDB that were in previous Fedora -releases could be buggy and not as well tested with CDT. - - - Other Linux + - Linux The lldb-mi tool was removed from the LLVM repository in 2019 and is no-longer present in builds of LLDB from version 10 onwards. If -lldb-mi is not available (or too old) in your distribution, it is +lldb-mi is not available in your distribution, it is not difficult to build it from source, see the [lldb-mi README](https://github.com/lldb-tools/lldb-mi/blob/main/README.md). @@ -2195,11 +2171,10 @@ lldb will not be automatically set for you. You will have to edit the LLDB path manually in the debug configuration and/or you need to reset the preferences to defaults (if it was modified). - - Windows + - Microsoft Windows Debugging on Windows with LLDB is not as mature at this moment and still -very much in progress. This is very likely to improve in the future -versions of LLDB (and CDT). +very much in progress. The lldb-mi tool may be installed using the MSYS2 package manager. Install MSYS2 by following instructions on the diff --git a/doc/org.eclipse.cdt.doc.user/src/concepts/cdt_c_before_you_begin.adoc b/doc/org.eclipse.cdt.doc.user/src/concepts/cdt_c_before_you_begin.adoc index 6ec4c5615a6..b85a6e25a75 100644 --- a/doc/org.eclipse.cdt.doc.user/src/concepts/cdt_c_before_you_begin.adoc +++ b/doc/org.eclipse.cdt.doc.user/src/concepts/cdt_c_before_you_begin.adoc @@ -35,18 +35,17 @@ toolchain with a built-in CDT integration. However, if you downloaded the CDT from the Eclipse web site, then you will require a toolchain before you can build and debug any projects. -The standard CDT supports integration with the GNU toolchain. This -includes GNU's make, gcc compiler, and gdb debugger utilities. If you -require a toolchain to build software for your development host, this is -the best choice to get started. +The standard CDT supports integration with both GNU (GCC) and LLVM (Clang) toolchains. If you +require a toolchain to build software for your development host, these are +the best choices to get started. -Each platform that runs the CDT requires different steps to acquire this -toolchain. +Each platform that runs the CDT requires different steps to acquire these +toolchains. -=== Windows +=== Microsoft Windows -For windows, MinGW and Cygwin are the two main platform choices for -acquiring the GNU toolchain. It is important to understand the +For Windows, MinGW and Cygwin are the two main platform choices for +acquiring the GNU and LLVM toolchains. It is important to understand the difference between them. Cygwin produces executables that use the Cygwin POSIX runtime. Note that this runtime is GPL licensed. MinGW produces native Windows executables that do not require a separate runtime. @@ -116,7 +115,7 @@ distribution. === macOS -The CDT supports the _Clang_ toolchain provided by the +The CDT supports the _LLVM with Clang_ toolchain provided by the _Xcode Command Line Tools_. It is recommended to use the Homebrew software distribution for any additional tools. The CDT will automatically detect tools that are installed using the Homebrew package manager. @@ -133,7 +132,7 @@ individual tools: |lldb-mi |`brew install --HEAD cdt-project/tools/lldb-mi` -|Required for local _C/{cpp} Application_ debugging on Apple silicon (you must also install the CDT _C/{cpp} LLDB Debugger Integration_ feature) +|Required for local _C/{cpp} Application_ debugging on Apple silicon |ninja |`brew install ninja` diff --git a/llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties b/llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties index dc8f8b52a0c..479af304635 100644 --- a/llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties +++ b/llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties @@ -1,5 +1,5 @@ ############################################################################### -# Copyright (c) 2016 Ericsson. +# Copyright (c) 2016, 2026 Ericsson and others. # # This program and the accompanying materials # are made available under the terms of the Eclipse Public License 2.0 @@ -10,7 +10,7 @@ ############################################################################### # "featureName" property - name of the feature -featureName=C/C++ LLDB Debugger Integration (experimental) +featureName=C/C++ LLDB Debugger Integration # "providerName" property - name of the company that provides the feature providerName=Eclipse CDT @@ -20,7 +20,7 @@ description=Debug C/C++ programs using the LLDB debugger # copyright copyright=\ -Copyright (c) 2016 Ericsson.\n\ +Copyright (c) 2016, 2026 Ericsson and others.\n\ This program and the accompanying materials\n\ are made available under the terms of the Eclipse Public License 2.0\n\ which accompanies this distribution, and is available at\n\ diff --git a/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/META-INF/MANIFEST.MF b/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/META-INF/MANIFEST.MF index e45a2986d3b..81292bf6a8f 100644 --- a/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/META-INF/MANIFEST.MF +++ b/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/META-INF/MANIFEST.MF @@ -3,7 +3,7 @@ Bundle-ManifestVersion: 2 Bundle-Name: %pluginName Bundle-Vendor: %providerName Bundle-SymbolicName: org.eclipse.cdt.llvm.dsf.lldb.core;singleton:=true -Bundle-Version: 1.102.500.qualifier +Bundle-Version: 1.102.600.qualifier Bundle-RequiredExecutionEnvironment: JavaSE-17 Bundle-Localization: plugin Require-Bundle: org.eclipse.debug.core;bundle-version="[3.23.0,4)", diff --git a/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties b/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties index 4805666a133..c6f5a6c54d3 100644 --- a/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties +++ b/llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties @@ -1,5 +1,5 @@ ############################################################################### -# Copyright (c) 2016 Ericsson +# Copyright (c) 2016, 2026 Ericsson and others. # # This program and the accompanying materials # are made available under the terms of the Eclipse Public License 2.0 @@ -12,6 +12,6 @@ pluginName=LLDB Debugger Integration Core providerName=Eclipse CDT launchDelegate.localApplication.name=LLDB-MI Debug Process -launchDelegate.localApplication.description=Start new application under control of LLBM-MI debugger +launchDelegate.localApplication.description=Start new application under control of LLDB-MI debugger (recommended for macOS C/C++ application debugging on Apple silicon only). launchDelegate.attach.name=LLDB-MI Attach to Process launchDelegate.attach.description=Attach the LLDB-MI debugger to a running program locally or remotely. diff --git a/llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties b/llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties index 3a3132bdabf..60981dee224 100644 --- a/llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties +++ b/llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties @@ -19,7 +19,7 @@ # NOTE TO TRANSLATOR: Please do not translate the featureVersion variable. -blurb=C/C++ LLDB Debugger Integration (experimental)\n\ +blurb=C/C++ LLDB Debugger Integration\n\ \n\ Version: {featureVersion}\n\ Build id: {0}\n\