NAME

       lldb - manual page for lldb 5.0

DESCRIPTION

       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 run 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.

lldb 5.0                                          October 2017                                           LLDB(1)