.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH LLDB "1" "March 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.
.SH "SEE ALSO"
The full documentation for
.B lldb
is maintained as a Texinfo manual.  If the
.B info
and
.B lldb
programs are properly installed at your site, the command
.IP
.B info lldb
.PP
should give you access to the complete manual.