FreeBSD LLDB port

LLDB, part of the LLVM family of projects, is a modern, high-performance source-level debugger. It supports (at some level) OS X, Linux, FreeBSD, and Windows. This page describes the ongoing work to bring the FreeBSD LLDB port to completion.

• LLDB to GDB command map
• Tutorial with command info
• LLDB FreeBSD bug list (including resolved)
• FreeBSD-hosted FreeBSD amd64 buildbot (last 200 builds) (2014-11-26: currently offline)
• LLVM-hosted FreeBSD amd64 buildbot
• FreeBSD i386 buildbot
• Debian Linux amd64 buildbot

FreeBSD-HEAD contains a snapshot of LLDB at upstream revision r225923 (as of the last update of this wiki page). It is not yet built by default and may be enabled by adding WITH_LLDB=YES to /etc/src.conf, and then following a standard buildworld and installworld, or building directly in lib/clang and then usr.bin/clang/lldb.

Previous snapshot versions in FreeBSD:

Install the following ports / packages:

• python
• swig (I used swig 1.3)
• cmake
• ninja
• git

This can be accomplished by running:

pkg install git python cmake ninja swig13

Install the ports / packages listed above for FreeBSD 10, and also install:

• libexecinfo

and build and install libc++:

cd /usr/src/lib/libcxxrt
CXX=clang++ make all install clean
cd /usr/src/lib/libc++
CXX=clang++ make all install clean

LLDB developers working on other platforms who wish to test their changes on FreeBSD can start with a virtual machine image from the table below.

Quick start instructions:

1. Log in as root on the console
2. Run “ifconfig -l” to list network interfaces The virtual nic will likely be em0 or vtnet0 depending on the VM software.
3. Add to /etc/rc.conf (assuming vtnet0 interface here):

ifconfig_vtnet0="DHCP"                                                       
sshd_enable="YES"                                                            

1. Run pkg and answer Y to install the package management tool
2. Run pkg install git python27 cmake ninja swig13 zsh
3. Run adduser to create a user account
4. Run shutdown -r now to reboot
5. ssh to the VM as your user account and follow the steps below under “Checkout and Build”.

I build LLDB with the in-tree Clang and libc++. It should also be possible to build with a recent GCC port installed (and dropping CC=, CXX=, and -stdlib= from the cmake line below), but I encountered a number of issues.

Checkout and build LLDB (assuming a Bourne shell):

git clone http://llvm.org/git/llvm.git
cd llvm/tools
git clone http://llvm.org/git/clang.git
git clone http://llvm.org/git/lldb.git
cd ..
mkdir build
cd build
CC=clang CXX=clang++ cmake ../ -G Ninja -DCMAKE_CXX_FLAGS="-std=c++11 -stdlib=libc++ -I/usr/local/include/python2.7 -g"
ninja lldb
ninja check-lldb # if you want to run tests

• For details on the need for -std=c++11 see http://lists.cs.uiuc.edu/pipermail/lldb-dev/2013-November/002755.html
• CC= and CXX= are required for 9.x builds only; clang is the default compiler on 10.0 and later.

1. Investigate and fix open PRs. To find annotated failing or skipped tests, try:

find test -name '*.py' -print0 | xargs -r0 egrep 'skipIfFreeBSD|expectedFailureFreeBSD'