.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH LLDB "1" "August 2019" "lldb 8" "User Commands"
.SH NAME
lldb \- manual page for lldb 8
.SH DESCRIPTION
OVERVIEW: LLDB
.PP
USAGE: lldboptions
.SS "ATTACHING:"
.HP
\fB\-\-attach\-name\fR <name> Tells the debugger to attach to a process with the given name.
.TP
\fB\-\-attach\-pid\fR <pid>
Tells the debugger to attach to a process with the given pid.
.TP
\fB\-n\fR <value>
Alias for \fB\-\-attach\-name\fR
.TP
\fB\-p\fR <value>
Alias for \fB\-\-attach\-pid\fR
.TP
\fB\-\-wait\-for\fR
Tells the debugger to wait for a process with the given pid or name to launch before attaching.
.TP
\fB\-w\fR
Alias for \fB\-\-wait\-for\fR
.SS "COMMANDS:"
.TP
\fB\-\-batch\fR
Tells the debugger to run the commands from \fB\-s\fR, \fB\-S\fR, \fB\-o\fR & \fB\-O\fR, and then quit.
.TP
\fB\-b\fR
Alias for \fB\-\-batch\fR
.TP
\fB\-K\fR <value>
Alias for \fB\-\-source\-on\-crash\fR
.TP
\fB\-k\fR <value>
Alias for \fB\-\-one\-line\-on\-crash\fR
.TP
\fB\-\-no\-lldbinit\fR
Do not automatically parse any '.lldbinit' files.
.TP
\fB\-\-one\-line\-before\-file\fR <command>
Tells the debugger to execute this one\-line lldb command before any file provided on the command line has been loaded.
.TP
\fB\-\-one\-line\-on\-crash\fR <command>
When in batch mode, tells the debugger to source this file of lldb commands if the target crashes.
.HP
\fB\-\-one\-line\fR <command> Tells the debugger to execute this one\-line lldb command after any file provided on the command line has been loaded.
.TP
\fB\-O\fR <value>
Alias for \fB\-\-one\-line\-before\-file\fR
.TP
\fB\-o\fR <value>
Alias for \fB\-\-one\-line\fR
.TP
\fB\-Q\fR
Alias for \fB\-\-source\-quietly\fR
.TP
\fB\-\-source\-before\-file\fR <file>
Tells the debugger to read in and execute the lldb commands in the given file, before any file has been loaded.
.TP
\fB\-\-source\-on\-crash\fR <file>
When in batch mode, tells the debugger to source this file of lldb commands if the target crashes.
.TP
\fB\-\-source\-quietly\fR
Tells the debugger to execute this one\-line lldb command before any file has been loaded.
.TP
\fB\-\-source\fR <file>
Tells the debugger to read in and execute the lldb commands in the given file, after any file has been loaded.
.TP
\fB\-S\fR <value>
Alias for \fB\-\-source\-before\-file\fR
.TP
\fB\-s\fR <value>
Alias for \fB\-\-source\fR
.TP
\fB\-x\fR
Alias for \fB\-\-no\-lldbinit\fR
.SS "OPTIONS:"
.HP
\fB\-\-arch\fR <architecture> Tells the debugger to use the specified architecture when starting and running the program.
.TP
\fB\-a\fR <value>
Alias for \fB\-\-arch\fR
.TP
\fB\-\-capture\fR <filename>
Tells the debugger to capture a reproducer to <filename>.
.TP
\fB\-\-core\fR <filename>
Tells the debugger to use the full path to <filename> as the core file.
.TP
\fB\-c\fR <value>
Alias for \fB\-\-core\fR
.TP
\fB\-\-debug\fR
Tells the debugger to print out extra information for debugging itself.
.TP
\fB\-d\fR
Alias for \fB\-\-debug\fR
.TP
\fB\-\-editor\fR
Tells the debugger to open source files using the host's "external editor" mechanism.
.TP
\fB\-e\fR
Alias for \fB\-\-editor\fR
.TP
\fB\-\-file\fR <filename>
Tells the debugger to use the file <filename> as the program to be debugged.
.TP
\fB\-f\fR <value>
Alias for \fB\-\-file\fR
.TP
\fB\-\-help\fR
Prints out the usage information for the LLDB debugger.
.TP
\fB\-h\fR
Alias for \fB\-\-help\fR
.TP
\fB\-\-no\-use\-colors\fR
Do not use colors.
.TP
\fB\-\-replay\fR <filename>
Tells the debugger to replay a reproducer from <filename>.
.TP
\fB\-\-version\fR
Prints out the current version number of the LLDB debugger.
.TP
\fB\-v\fR
Alias for \fB\-\-version\fR
.TP
\fB\-X\fR
Alias for \fB\-\-no\-use\-color\fR
.SS "REPL:"
.TP
\fB\-r=\fR<flags>
Alias for \fB\-\-repl=\fR<flags>
.HP
\fB\-\-repl\-language\fR <language>
.IP
Chooses the language for the REPL.
.HP
\fB\-\-repl=\fR<flags> Runs lldb in REPL mode with a stub process with the given flags.
.TP
\fB\-\-repl\fR
Runs lldb in REPL mode with a stub process.
.TP
\fB\-R\fR <value>
Alias for \fB\-\-repl\-language\fR
.TP
\fB\-r\fR
Alias for \fB\-\-repl\fR
.SS "SCRIPTING:"
.TP
\fB\-l\fR <value>
Alias for \fB\-\-script\-language\fR
.HP
\fB\-\-python\-path\fR Prints out the path to the lldb.py file for this version of lldb.
.TP
\fB\-P\fR
Alias for \fB\-\-python\-path\fR
.HP
\fB\-\-script\-language\fR <language>
.IP
Tells the debugger to use the specified scripting language for user\-defined scripts.
.SS "EXAMPLES:"
.IP
The debugger can be started in several modes.
.IP
Passing an executable as a positional argument prepares lldb to debug the
given executable. Arguments passed after \fB\-\-\fR are considered arguments to the
debugged executable.
.IP
lldb \fB\-\-arch\fR x86_64 \fI\,/path/to/program\/\fP \fB\-\-\fR \fB\-\-arch\fR arvm7
.IP
Passing one of the attach options causes lldb to immediately attach to the
given process.
.IP
lldb \fB\-p\fR <pid>
lldb \fB\-n\fR <process\-name>
.IP
Passing \fB\-\-repl\fR starts lldb in REPL mode.
.IP
lldb \fB\-r\fR
.IP
Passing \fB\-\-core\fR causes lldb to debug the core file.
.IP
lldb \fB\-c\fR \fI\,/path/to/core\/\fP
.IP
Command options can be combined with either mode and cause lldb to run the
specified commands before or after events, like loading the file or crashing,
in the order provided on the command line.
.IP
lldb \fB\-O\fR 'settings set stop\-disassembly\-count 20' \fB\-o\fR 'run' \fB\-o\fR 'bt'
lldb \fB\-S\fR \fI\,/source/before/file\/\fP \fB\-s\fR \fI\,/source/after/file\/\fP
lldb \fB\-K\fR \fI\,/source/before/crash\/\fP \fB\-k\fR \fI\,/source/after/crash\/\fP