This is an archive of the discontinued LLVM Phabricator instance.

Differential D115877

[lldb][docs] Update instructions for building libc++
ClosedPublic

Authored by torarnv on Dec 16 2021, 7:10 AM.

Details

Reviewers
sylvestre.ledru
Commits
rG427f6e11e68a: [lldb][docs] Update instructions for building libc++

Diff Detail

Event Timeline

torarnv requested review of this revision.Dec 16 2021, 7:10 AM
torarnv created this revision.
Herald added a project: Restricted Project. · View Herald TranscriptDec 16 2021, 7:10 AM
Herald added a subscriber: lldb-commits. · View Herald Transcript
torarnv added inline comments.Dec 16 2021, 7:11 AM
lldb/docs/resources/build.rst
307–308

Dunno if libcxx would have been enough here, and libcxxabi would follow automatically as a dep?

Herald added a subscriber: JDevlieghere. · View Herald TranscriptDec 16 2021, 7:11 AM
Harbormaster completed remote builds in B139661: Diff 394864.Dec 16 2021, 7:13 AM
torarnv updated this revision to Diff 394869.Dec 16 2021, 7:15 AM
Harbormaster completed remote builds in B139664: Diff 394869.Dec 16 2021, 7:23 AM
sylvestre.ledru accepted this revision.Dec 16 2021, 7:39 AM

LGTM, thanks!

This revision is now accepted and ready to land.Dec 16 2021, 7:39 AM
torarnv added a comment.Dec 16 2021, 7:43 AM

Thanks! Do I do something now or does it land automatically?

sylvestre.ledru added a comment.Dec 16 2021, 7:47 AM

I will push it for you. What do you want to use as full name + email ?

torarnv added a comment.Dec 16 2021, 7:49 AM

Thanks :) You can use Tor Arne Vestbø <torarnv@gmail.com>

This revision was landed with ongoing or failed builds.Dec 16 2021, 7:51 AM
Closed by commit rG427f6e11e68a: [lldb][docs] Update instructions for building libc++ (authored by torarnv, committed by sylvestre.ledru). · Explain Why
This revision was automatically updated to reflect the committed changes.
sylvestre.ledru added a commit: rG427f6e11e68a: [lldb][docs] Update instructions for building libc++.

Revision Contents

PathSize
lldb/
docs/
resources/
10 lines

Diff 394882

lldb/docs/resources/build.rst

Show First 20 Lines • Show All 298 Lines • ▼ Show 20 Lines
project, and use F5 to run it. You need only edit the project settings to set project, and use F5 to run it. You need only edit the project settings to set
the executable and the working directory to point to binaries inside of the the executable and the working directory to point to binaries inside of the
ninja tree. ninja tree.
macOS macOS
^^^^^ ^^^^^
On macOS the LLDB test suite requires libc++. Either add ``libcxx`` to On macOS the LLDB test suite requires libc++. Either add
``LLVM_ENABLE_PROJECTS`` or disable the test suite with ``LLVM_ENABLE_RUNTIMES="libcxx;libcxxabi"`` or disable the test suite with
torarnvAuthorUnsubmitted
Done
ReplyInline Actions

Dunno if libcxx would have been enough here, and libcxxabi would follow automatically as a dep?

torarnv: Dunno if `libcxx` would have been enough here, and `libcxxabi` would follow automatically as a…
``LLDB_INCLUDE_TESTS=OFF``. Further useful options: ``LLDB_INCLUDE_TESTS=OFF``. Further useful options:
* ``LLDB_BUILD_FRAMEWORK:BOOL``: Builds the LLDB.framework. * ``LLDB_BUILD_FRAMEWORK:BOOL``: Builds the LLDB.framework.
* ``LLDB_CODESIGN_IDENTITY:STRING``: Set the identity to use for code-signing * ``LLDB_CODESIGN_IDENTITY:STRING``: Set the identity to use for code-signing
all executables. If not explicitly specified, only ``debugserver`` will be all executables. If not explicitly specified, only ``debugserver`` will be
code-signed with identity ``lldb_codesign`` (see :ref:`CodeSigning`). code-signed with identity ``lldb_codesign`` (see :ref:`CodeSigning`).
* ``LLDB_USE_SYSTEM_DEBUGSERVER:BOOL``: Use the system's debugserver, so lldb is * ``LLDB_USE_SYSTEM_DEBUGSERVER:BOOL``: Use the system's debugserver, so lldb is
functional without setting up code-signing. functional without setting up code-signing.
Show All 21 Lines
LLVM <https://llvm.org/docs/BuildingADistribution.html>`_): LLVM <https://llvm.org/docs/BuildingADistribution.html>`_):
:: ::
$ git clone https://github.com/llvm/llvm-project $ git clone https://github.com/llvm/llvm-project
$ cmake -B /path/to/lldb-build -G Ninja \ $ cmake -B /path/to/lldb-build -G Ninja \
-C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-macOS.cmake \ -C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-macOS.cmake \
-DLLVM_ENABLE_PROJECTS="clang;libcxx;lldb" \ -DLLVM_ENABLE_PROJECTS="clang;lldb" \
-DLLVM_ENABLE_RUNTIMES="libcxx;libcxxabi" \
llvm-project/llvm llvm-project/llvm
$ DESTDIR=/path/to/lldb-install ninja -C /path/to/lldb-build check-lldb install-distribution $ DESTDIR=/path/to/lldb-install ninja -C /path/to/lldb-build check-lldb install-distribution
.. _CMakeGeneratedXcodeProject: .. _CMakeGeneratedXcodeProject:
Build LLDB standalone for development with Xcode: Build LLDB standalone for development with Xcode:
:: ::
$ git clone https://github.com/llvm/llvm-project $ git clone https://github.com/llvm/llvm-project
$ cmake -B /path/to/llvm-build -G Ninja \ $ cmake -B /path/to/llvm-build -G Ninja \
-C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-base.cmake \ -C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-base.cmake \
-DLLVM_ENABLE_PROJECTS="clang;libcxx" \ -DLLVM_ENABLE_PROJECTS="clang" \
-DLLVM_ENABLE_RUNTIMES="libcxx;libcxxabi" \
llvm-project/llvm llvm-project/llvm
$ ninja -C /path/to/llvm-build $ ninja -C /path/to/llvm-build
$ cmake -B /path/to/lldb-build \ $ cmake -B /path/to/lldb-build \
-C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-Xcode.cmake \ -C /path/to/llvm-project/lldb/cmake/caches/Apple-lldb-Xcode.cmake \
-DLLVM_DIR=/path/to/llvm-build/lib/cmake/llvm \ -DLLVM_DIR=/path/to/llvm-build/lib/cmake/llvm \
llvm-project/lldb llvm-project/lldb
$ open lldb.xcodeproj $ open lldb.xcodeproj
▲ Show 20 Lines • Show All 237 Lines • Show Last 20 Lines