Skip to content

Commit 1ad625e

Browse files
committed
Promote LLVM/LLDB support to non-experimental status
1 parent d5944a6 commit 1ad625e

6 files changed

Lines changed: 23 additions & 49 deletions

File tree

FAQ/README.md

Lines changed: 6 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -2146,38 +2146,14 @@ report](https://sourceware.org/bugzilla/show_bug.cgi?id=20266).
21462146
21472147
#### How do I get the LLDB debugger?
21482148
2149-
CDT has experimental support for LLDB starting from CDT 9.1. The minimum
2150-
recommended version for LLDB is 3.8.
2149+
CDT has support for LLDB starting from CDT 9.1. The use of LLDB with CDT is
2150+
recommended for local macOS application debugging on Apple silicon (AArch64) only.
21512151
2152-
- Ubuntu
2153-
2154-
Using Ubuntu 16.04, install with
2155-
2156-
`sudo apt-get install lldb`
2157-
2158-
This will install lldb 3.8 along with the necessary lldb-mi executable.
2159-
CDT should find lldb-mi on the PATH (environment variable).
2160-
2161-
Note that previous versions of LLDB that were in previous Ubuntu
2162-
releases could be buggy and not as well tested with CDT.
2163-
2164-
- Fedora
2165-
2166-
Using Fedora 24, install with
2167-
2168-
`sudo dnf install lldb`
2169-
2170-
This will install lldb 3.8 along with the necessary lldb-mi executable.
2171-
CDT should find lldb-mi on the PATH (environment variable).
2172-
2173-
Note that previous versions of LLDB that were in previous Fedora
2174-
releases could be buggy and not as well tested with CDT.
2175-
2176-
- Other Linux
2152+
- Linux
21772153
21782154
The lldb-mi tool was removed from the LLVM repository in 2019 and is no-longer
21792155
present in builds of LLDB from version 10 onwards. If
2180-
lldb-mi is not available (or too old) in your distribution, it is
2156+
lldb-mi is not available in your distribution, it is
21812157
not difficult to build it from source, see the
21822158
[lldb-mi README](https://github.com/lldb-tools/lldb-mi/blob/main/README.md).
21832159
@@ -2195,11 +2171,10 @@ lldb will not be automatically set for you. You will have to edit the
21952171
LLDB path manually in the debug configuration and/or you need to reset
21962172
the preferences to defaults (if it was modified).
21972173
2198-
- Windows
2174+
- Microsoft Windows
21992175
22002176
Debugging on Windows with LLDB is not as mature at this moment and still
2201-
very much in progress. This is very likely to improve in the future
2202-
versions of LLDB (and CDT).
2177+
very much in progress.
22032178
22042179
The lldb-mi tool may be installed using the MSYS2 package manager. Install
22052180
MSYS2 by following instructions on the

doc/org.eclipse.cdt.doc.user/src/concepts/cdt_c_before_you_begin.adoc

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -35,18 +35,17 @@ toolchain with a built-in CDT integration. However, if you downloaded
3535
the CDT from the Eclipse web site, then you will require a toolchain
3636
before you can build and debug any projects.
3737

38-
The standard CDT supports integration with the GNU toolchain. This
39-
includes GNU's make, gcc compiler, and gdb debugger utilities. If you
40-
require a toolchain to build software for your development host, this is
41-
the best choice to get started.
38+
The standard CDT supports integration with both GNU (GCC) and LLVM (Clang) toolchains. If you
39+
require a toolchain to build software for your development host, these are
40+
the best choices to get started.
4241

43-
Each platform that runs the CDT requires different steps to acquire this
44-
toolchain.
42+
Each platform that runs the CDT requires different steps to acquire these
43+
toolchains.
4544

46-
=== Windows
45+
=== Microsoft Windows
4746

48-
For windows, MinGW and Cygwin are the two main platform choices for
49-
acquiring the GNU toolchain. It is important to understand the
47+
For Windows, MinGW and Cygwin are the two main platform choices for
48+
acquiring the GNU and LLVM toolchains. It is important to understand the
5049
difference between them. Cygwin produces executables that use the Cygwin
5150
POSIX runtime. Note that this runtime is GPL licensed. MinGW produces
5251
native Windows executables that do not require a separate runtime.
@@ -116,7 +115,7 @@ distribution.
116115

117116
=== macOS
118117

119-
The CDT supports the _Clang_ toolchain provided by the
118+
The CDT supports the _LLVM with Clang_ toolchain provided by the
120119
_Xcode Command Line Tools_. It is recommended to use the Homebrew
121120
software distribution for any additional tools. The CDT will automatically
122121
detect tools that are installed using the Homebrew package manager.
@@ -133,7 +132,7 @@ individual tools:
133132

134133
|lldb-mi
135134
|`brew install --HEAD cdt-project/tools/lldb-mi`
136-
|Required for local _C/{cpp} Application_ debugging on Apple silicon (you must also install the CDT _C/{cpp} LLDB Debugger Integration_ feature)
135+
|Required for local _C/{cpp} Application_ debugging on Apple silicon
137136

138137
|ninja
139138
|`brew install ninja`

llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
###############################################################################
2-
# Copyright (c) 2016 Ericsson.
2+
# Copyright (c) 2016, 2026 Ericsson and others.
33
#
44
# This program and the accompanying materials
55
# are made available under the terms of the Eclipse Public License 2.0
@@ -10,7 +10,7 @@
1010
###############################################################################
1111

1212
# "featureName" property - name of the feature
13-
featureName=C/C++ LLDB Debugger Integration (experimental)
13+
featureName=C/C++ LLDB Debugger Integration
1414

1515
# "providerName" property - name of the company that provides the feature
1616
providerName=Eclipse CDT
@@ -20,7 +20,7 @@ description=Debug C/C++ programs using the LLDB debugger
2020

2121
# copyright
2222
copyright=\
23-
Copyright (c) 2016 Ericsson.\n\
23+
Copyright (c) 2016, 2026 Ericsson and others.\n\
2424
This program and the accompanying materials\n\
2525
are made available under the terms of the Eclipse Public License 2.0\n\
2626
which accompanies this distribution, and is available at\n\

llvm/org.eclipse.cdt.llvm.dsf.lldb.core/META-INF/MANIFEST.MF

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Bundle-ManifestVersion: 2
33
Bundle-Name: %pluginName
44
Bundle-Vendor: %providerName
55
Bundle-SymbolicName: org.eclipse.cdt.llvm.dsf.lldb.core;singleton:=true
6-
Bundle-Version: 1.102.500.qualifier
6+
Bundle-Version: 1.102.600.qualifier
77
Bundle-RequiredExecutionEnvironment: JavaSE-17
88
Bundle-Localization: plugin
99
Require-Bundle: org.eclipse.debug.core;bundle-version="[3.23.0,4)",

llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
###############################################################################
2-
# Copyright (c) 2016 Ericsson
2+
# Copyright (c) 2016, 2026 Ericsson and others.
33
#
44
# This program and the accompanying materials
55
# are made available under the terms of the Eclipse Public License 2.0
@@ -12,6 +12,6 @@ pluginName=LLDB Debugger Integration Core
1212
providerName=Eclipse CDT
1313

1414
launchDelegate.localApplication.name=LLDB-MI Debug Process
15-
launchDelegate.localApplication.description=Start new application under control of LLBM-MI debugger
15+
launchDelegate.localApplication.description=Start new application under control of LLDB-MI debugger (recommended for macOS C/C++ application debugging on Apple silicon only).
1616
launchDelegate.attach.name=LLDB-MI Attach to Process
1717
launchDelegate.attach.description=Attach the LLDB-MI debugger to a running program locally or remotely.

llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
# NOTE TO TRANSLATOR: Please do not translate the featureVersion variable.
2020

2121

22-
blurb=C/C++ LLDB Debugger Integration (experimental)\n\
22+
blurb=C/C++ LLDB Debugger Integration\n\
2323
\n\
2424
Version: {featureVersion}\n\
2525
Build id: {0}\n\

0 commit comments

Comments
 (0)