Scroll to navigation

LLDB(1) User Commands LLDB(1)

NAME

lldb - manual page for lldb 3.8

DESCRIPTION

ERROR: ld.so: object 'libfakeroot-sysv.so' from LD_PRELOAD cannot be preloaded (cannot open shared object file): ignored. ERROR: ld.so: object 'libfakeroot-sysv.so' from LD_PRELOAD cannot be preloaded (cannot open shared object file): ignored. ERROR: ld.so: object 'libfakeroot-sysv.so' from LD_PRELOAD cannot be preloaded (cannot open shared object file): ignored. ERROR: ld.so: object 'libfakeroot-sysv.so' from LD_PRELOAD cannot be preloaded (cannot open shared object file): ignored.
Usage:
lldb -h lldb -v [[--] <PROGRAM-ARG-1> [<PROGRAM_ARG-2> ...]] lldb -a <arch> -f <filename> [-c <filename>] [-s <filename>] [-o <none>] [-S <filename>] [-O <none>] [-k <none>] [-K <filename>] [-Q] [-b] [-e] [-x] [-X] [-l <script-language>] [-d] [[--] <PROGRAM-ARG-1> [<PROGRAM_ARG-2> ...]] lldb -n <process-name> -w [-s <filename>] [-o <none>] [-S <filename>] [-O <none>] [-k <none>] [-K <filename>] [-Q] [-b] [-e] [-x] [-X] [-l <script-language>] [-d] lldb -p <pid> [-s <filename>] [-o <none>] [-S <filename>] [-O <none>] [-k <none>] [-K <filename>] [-Q] [-b] [-e] [-x] [-X] [-l <script-language>] [-d] lldb -P lldb -r [<none>] -R <none>
-h
--help
Prints out the usage information for the LLDB debugger.
-v
--version
Prints out the current version number of the LLDB debugger.
-a <arch>
--arch <arch>
Tells the debugger to use the specified architecture when starting and running the program. <architecture> must be one of the architectures for which the program was compiled.
-f <filename>
--file <filename>
Tells the debugger to use the file <filename> as the program to be debugged.
-c <filename>
--core <filename>
Tells the debugger to use the fullpath to <path> as the core file.
-p <pid>
--attach-pid <pid>
Tells the debugger to attach to a process with the given pid.
-n <process-name>
--attach-name <process-name>
Tells the debugger to attach to a process with the given name.
-w
--wait-for
Tells the debugger to wait for a process with the given pid or name to launch before attaching.
-s <filename>
--source <filename>
Tells the debugger to read in and execute the lldb commands in the given file, after any file provided on the command line has been loaded.
-o
--one-line
Tells the debugger to execute this one-line lldb command after any file provided on the command line has been loaded.
-S <filename>
--source-before-file <filename>
Tells the debugger to read in and execute the lldb commands in the given file, before any file provided on the command line has been loaded.
-O
--one-line-before-file
Tells the debugger to execute this one-line lldb command before any file provided on the command line has been loaded.
-k
--one-line-on-crash
When in batch mode, tells the debugger to execute this one-line lldb command if the target crashes.
-K <filename>
--source-on-crash <filename>
When in batch mode, tells the debugger to source this file of lldb commands if the target crashes.
-Q
--source-quietly
Tells the debugger to execute this one-line lldb command before any file provided on the command line has been loaded.
-b
--batch
Tells the debugger to running the commands from -s, -S, -o & -O, and then quit. However if any run command stopped due to a signal or crash, the debugger will return to the interactive prompt at the place of the crash.
-e
--editor
Tells the debugger to open source files using the host's "external editor" mechanism.
-x
--no-lldbinit
Do not automatically parse any '.lldbinit' files.
-X
--no-use-colors
Do not use colors.
-P
--python-path
Prints out the path to the lldb.py file for this version of lldb.
-l <script-language>
--script-language <script-language>
Tells the debugger to use the specified scripting language for user-defined scripts, rather than the default. Valid scripting languages that can be specified include Python, Perl, Ruby and Tcl. Currently only the Python extensions have been implemented.
-d
--debug
Tells the debugger to print out extra information for debugging itself.
-r
--repl
Runs lldb in REPL mode with a stub process.
-R
--repl-language
Chooses the language for the REPL.
Notes:
Multiple "-s" and "-o" options can be provided.
They will be processed
from left to right in order, with the source files and commands interleaved. The same is true of the "-S" and "-O" options. The before file and after file sets can intermixed freely, the command parser will sort them out. The order of the file specifiers ("-c", "-f", etc.) is not significant in this regard.
If you don't provide -f then the first argument will be the file to be debugged which means that 'lldb -- <filename> [<ARG1> [<ARG2>]]' also works. But remember to end the options with "--" if any of your arguments have a "-" in them.

SEE ALSO

The full documentation for lldb is maintained as a Texinfo manual. If the info and lldb programs are properly installed at your site, the command
info lldb
should give you access to the complete manual.
October 2016 lldb 3.8