xref: /llvm-project/lldb/utils/lui/Readme (revision 93f505942c8091a3ebbf6f08764635f19dc79095)
1*93f50594SJonas Devlieghere
2*93f50594SJonas DevlieghereLLDB (Terminal) User Interface
3*93f50594SJonas Devlieghere------------------------------
4*93f50594SJonas Devlieghere
5*93f50594SJonas DevlieghereThis directory contains the curses user interface for LLDB. To use it, ensure Python can find your lldb module. You may have to modify PYTHONPATH for that purpose:
6*93f50594SJonas Devlieghere
7*93f50594SJonas Devlieghere$ export PYTHONPATH=/path/to/lldb/module
8*93f50594SJonas Devlieghere
9*93f50594SJonas DevlieghereThen, run the lui.py. To load a core file:
10*93f50594SJonas Devlieghere$ ./lui.py --core core
11*93f50594SJonas Devlieghere
12*93f50594SJonas DevlieghereTo create a target from an executable:
13*93f50594SJonas Devlieghere$ ./lui.py /bin/echo "hello world"
14*93f50594SJonas Devlieghere
15*93f50594SJonas DevlieghereTo attach to a running process:
16*93f50594SJonas Devlieghere$ ./lui.py --attach <pid>
17*93f50594SJonas Devlieghere
18*93f50594SJonas Devlieghere
19*93f50594SJonas DevlieghereKnown Issues
20*93f50594SJonas Devlieghere------------
21*93f50594SJonas Devlieghere1. Resizing the terminal will most likely cause lui to crash.
22*93f50594SJonas Devlieghere2. Missing paging in command-window
23*93f50594SJonas Devlieghere3. Only minimal testing (on Ubuntu Linux x86_64)
24*93f50594SJonas Devlieghere
25*93f50594SJonas DevlieghereMissing Features
26*93f50594SJonas Devlieghere----------------
27*93f50594SJonas Devlieghere- stdin/stdout/stderr windows
28*93f50594SJonas Devlieghere- memory window
29*93f50594SJonas Devlieghere- backtrace window
30*93f50594SJonas Devlieghere- threads window
31*93f50594SJonas Devlieghere- tab-completion
32*93f50594SJonas Devlieghere- syntax-highlighting (via pygments library)
33*93f50594SJonas Devlieghere- (local) variables window
34*93f50594SJonas Devlieghere- registers window
35*93f50594SJonas Devlieghere- disassembly window
36*93f50594SJonas Devlieghere- custom layout
37