[sanitizer] Improve FreeBSD ASLR detection
[llvm-project.git] / lldb / docs / status / status.rst
blob5ad19b898b97bc4d0014c770ec075cdbddbf7dc8
1 Status
2 ======
4 FreeBSD
5 -------
7 LLDB on FreeBSD lags behind the Linux implementation but is improving rapidly.
8 For more details, see the Features by OS section below.
10 Linux
11 -----
13 LLDB is improving on Linux. Linux is nearing feature completeness with Darwin
14 to debug x86_64, i386, ARM, AArch64, IBM POWER (ppc64), IBM Z (s390x), and
15 MIPS64 programs. For more details, see the Features by OS section below.
17 macOS
18 -----
20 LLDB is the system debugger on macOS, iOS, tvOS, and watchOS and
21 can be used for C, C++, Objective-C and Swift development for x86_64,
22 i386, ARM, and AArch64 debugging. The entire public API is exposed
23 through a macOS framework which is used by Xcode and the `lldb`
24 command line tool. It can also be imported from Python. The entire public API is
25 exposed through script bridging which allows LLDB to use an embedded Python
26 script interpreter, as well as having a Python module named "lldb" which can be
27 used from Python on the command line. This allows debug sessions to be
28 scripted. It also allows powerful debugging actions to be created and attached
29 to a variety of debugging workflows.
31 NetBSD
32 ------
34 LLDB is improving on NetBSD and reaching feature completeness with Linux.
36 Windows
37 -------
39 LLDB on Windows is still under development, but already useful for i386
40 programs (x86_64 untested) built with DWARF debug information, including
41 postmortem analysis of minidumps. For more details, see the Features by OS
42 section below.
44 Features Matrix
45 ---------------
46 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
47 | Feature               | FreeBSD            | Linux                   | macOS             | NetBSD             | Windows              |
48 +=======================+====================+=========================+===================+====================+======================+
49 | Backtracing           | YES                | YES                     | YES               | YES                | YES                  |
50 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
51 | Breakpoints           | YES                | YES                     | YES               | YES                | YES                  |
52 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
53 | C++11:                | YES                | YES                     | YES               | YES                | Unknown              |
54 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
55 | Commandline tool      | YES                | YES                     | YES               | YES                | YES                  |
56 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
57 | Core file debugging   | YES (ELF)          | YES (ELF)               | YES (MachO)       | YES (ELF)          | YES (Minidump)       |
58 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
59 | Remote debugging      | YES (lldb-server)  | YES (lldb-server)       | YES (debugserver) | YES (lldb-server)  | NO                   |
60 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
61 | Disassembly           | YES                | YES                     | YES               | YES                | YES                  |
62 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
63 | Expression evaluation | YES (known issues) | YES (known issues)      | YES               | YES (known issues) | YES (known issues)   |
64 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
65 | JIT debugging         | Unknown            | Symbolic debugging only | Untested          | Work In Progress   | NO                   |
66 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+
67 | Objective-C 2.0:      | Unknown            | N/A                     | YES               | Unknown            | N/A                  |
68 +-----------------------+--------------------+-------------------------+-------------------+--------------------+----------------------+