xref: /openbsd-src/gnu/llvm/lldb/utils/lui/Readme (revision 061da546b983eb767bad15e67af1174fb0bcf31c)
1*061da546Spatrick
2*061da546SpatrickLLDB (Terminal) User Interface
3*061da546Spatrick------------------------------
4*061da546Spatrick
5*061da546SpatrickThis 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*061da546Spatrick
7*061da546Spatrick$ export PYTHONPATH=/path/to/lldb/module
8*061da546Spatrick
9*061da546SpatrickThen, run the lui.py. To load a core file:
10*061da546Spatrick$ ./lui.py --core core
11*061da546Spatrick
12*061da546SpatrickTo create a target from an executable:
13*061da546Spatrick$ ./lui.py /bin/echo "hello world"
14*061da546Spatrick
15*061da546SpatrickTo attach to a running process:
16*061da546Spatrick$ ./lui.py --attach <pid>
17*061da546Spatrick
18*061da546Spatrick
19*061da546SpatrickKnown Issues
20*061da546Spatrick------------
21*061da546Spatrick1. Resizing the terminal will most likely cause lui to crash.
22*061da546Spatrick2. Missing paging in command-window
23*061da546Spatrick3. Only minimal testing (on Ubuntu Linux x86_64)
24*061da546Spatrick
25*061da546SpatrickMissing Features
26*061da546Spatrick----------------
27*061da546Spatrick- stdin/stdout/stderr windows
28*061da546Spatrick- memory window
29*061da546Spatrick- backtrace window
30*061da546Spatrick- threads window
31*061da546Spatrick- tab-completion
32*061da546Spatrick- syntax-highlighting (via pygments library)
33*061da546Spatrick- (local) variables window
34*061da546Spatrick- registers window
35*061da546Spatrick- disassembly window
36*061da546Spatrick- custom layout
37