.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH LLDB "1" "August 2018" "lldb 6.0" "User Commands"
.SH NAME
lldb \- manual page for lldb 6.0
.SH DESCRIPTION
Usage:
.IP
lldb \fB\-h\fR
lldb \fB\-v\fR [[\-\-] <PROGRAM\-ARG\-1> [<PROGRAM_ARG\-2> ...]]
lldb \fB\-a\fR <arch> \fB\-f\fR <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 \fB\-n\fR <process\-name> \fB\-w\fR [\-s <filename>] [\-o <none>] [\-S <filename>] [\-O <none>] [\-k <none>] [\-K <filename>] [\-Q] [\-b] [\-e] [\-x] [\-X] [\-l <script\-language>] [\-d]
lldb \fB\-p\fR <pid> [\-s <filename>] [\-o <none>] [\-S <filename>] [\-O <none>] [\-k <none>] [\-K <filename>] [\-Q] [\-b] [\-e] [\-x] [\-X] [\-l <script\-language>] [\-d]
lldb \fB\-P\fR
lldb \fB\-r\fR [<none>] \fB\-R\fR <none>
.HP
\fB\-h\fR
.HP
\fB\-\-help\fR
.IP
Prints out the usage information for the LLDB debugger.
.HP
\fB\-v\fR
.HP
\fB\-\-version\fR
.IP
Prints out the current version number of the LLDB debugger.
.HP
\fB\-a\fR <arch>
.HP
\fB\-\-arch\fR <arch>
.IP
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.
.HP
\fB\-f\fR <filename>
.HP
\fB\-\-file\fR <filename>
.IP
Tells the debugger to use the file <filename> as the program to be
debugged.
.HP
\fB\-c\fR <filename>
.HP
\fB\-\-core\fR <filename>
.IP
Tells the debugger to use the fullpath to <path> as the core file.
.HP
\fB\-p\fR <pid>
.HP
\fB\-\-attach\-pid\fR <pid>
.IP
Tells the debugger to attach to a process with the given pid.
.HP
\fB\-n\fR <process\-name>
.HP
\fB\-\-attach\-name\fR <process\-name>
.IP
Tells the debugger to attach to a process with the given name.
.HP
\fB\-w\fR
.HP
\fB\-\-wait\-for\fR
.IP
Tells the debugger to wait for a process with the given pid or name
to launch before attaching.
.HP
\fB\-s\fR <filename>
.HP
\fB\-\-source\fR <filename>
.IP
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.
.HP
\fB\-o\fR
.HP
\fB\-\-one\-line\fR
.IP
Tells the debugger to execute this one\-line lldb command after any
file provided on the command line has been loaded.
.HP
\fB\-S\fR <filename>
.HP
\fB\-\-source\-before\-file\fR <filename>
.IP
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.
.HP
\fB\-O\fR
.HP
\fB\-\-one\-line\-before\-file\fR
.IP
Tells the debugger to execute this one\-line lldb command before any
file provided on the command line has been loaded.
.HP
\fB\-k\fR
.HP
\fB\-\-one\-line\-on\-crash\fR
.IP
When in batch mode, tells the debugger to execute this one\-line
lldb command if the target crashes.
.HP
\fB\-K\fR <filename>
.HP
\fB\-\-source\-on\-crash\fR <filename>
.IP
When in batch mode, tells the debugger to source this file of lldb
commands if the target crashes.
.HP
\fB\-Q\fR
.HP
\fB\-\-source\-quietly\fR
.IP
Tells the debugger to execute this one\-line lldb command before any
file provided on the command line has been loaded.
.HP
\fB\-b\fR
.HP
\fB\-\-batch\fR
.IP
Tells the debugger to run the commands from \fB\-s\fR, \fB\-S\fR, \fB\-o\fR & \fB\-O\fR, 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.
.HP
\fB\-e\fR
.HP
\fB\-\-editor\fR
.IP
Tells the debugger to open source files using the host's "external
editor" mechanism.
.HP
\fB\-x\fR
.HP
\fB\-\-no\-lldbinit\fR
.IP
Do not automatically parse any '.lldbinit' files.
.HP
\fB\-X\fR
.HP
\fB\-\-no\-use\-colors\fR
.IP
Do not use colors.
.HP
\fB\-P\fR
.HP
\fB\-\-python\-path\fR
.IP
Prints out the path to the lldb.py file for this version of lldb.
.HP
\fB\-l\fR <script\-language>
.HP
\fB\-\-script\-language\fR <script\-language>
.IP
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.
.HP
\fB\-d\fR
.HP
\fB\-\-debug\fR
.IP
Tells the debugger to print out extra information for debugging
itself.
.HP
\fB\-r\fR
.HP
\fB\-\-repl\fR
.IP
Runs lldb in REPL mode with a stub process.
.HP
\fB\-R\fR
.HP
\fB\-\-repl\-language\fR
.IP
Chooses the language for the REPL.
.IP
Notes:
.TP
Multiple "\-s" and "\-o" options can be provided.
They will be processed
.IP
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.
.IP
If you don't provide \fB\-f\fR then the first argument will be the file to be
debugged which means that 'lldb \fB\-\-\fR <filename> [<ARG1> [<ARG2>]]' also
works.  But remember to end the options with "\-\-" if any of your
arguments have a "\-" in them.