Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 6 additions & 31 deletions FAQ/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).

Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand All @@ -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`
Expand Down
6 changes: 3 additions & 3 deletions llvm/org.eclipse.cdt.llvm.dsf.lldb-feature/feature.properties
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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
Expand All @@ -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\
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)",
Expand Down
4 changes: 2 additions & 2 deletions llvm/org.eclipse.cdt.llvm.dsf.lldb.core/plugin.properties
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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.
2 changes: 1 addition & 1 deletion llvm/org.eclipse.cdt.llvm.dsf.lldb.ui/about.properties
Original file line number Diff line number Diff line change
Expand Up @@ -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\
Expand Down
Loading