NAME

       lldb - manual page for lldb 11

DESCRIPTION

       OVERVIEW: LLDB

       USAGE: lldb [options]

   ATTACHING:
       --attach-name <name> Tells the debugger to attach to a process with the given name.

       --attach-pid <pid>
              Tells the debugger to attach to a process with the given pid.

       -n <value>
              Alias for --attach-name

       -p <value>
              Alias for --attach-pid

       --wait-for
              Tells the debugger to wait for a process with the given pid or name to launch before attaching.

       -w     Alias for --wait-for

   COMMANDS:
       --batch
              Tells the debugger to run the commands from -s, -S, -o & -O, and then quit.

       -b     Alias for --batch

       -K <value>
              Alias for --source-on-crash

       -k <value>
              Alias for --one-line-on-crash

       --local-lldbinit
              Allow  the  debugger  to  parse  the  .lldbinit  files  in  the  current working directory, unless
              --no-lldbinit is passed.

       --no-lldbinit
              Do not automatically parse any '.lldbinit' files.

       --one-line-before-file <command>
              Tells the debugger to execute this one-line lldb command before any file provided on  the  command
              line has been loaded.

       --one-line-on-crash <command>
              When in batch mode, tells the debugger to run this one-line lldb command if the target crashes.

       --one-line  <command> Tells the debugger to execute this one-line lldb command after any file provided on
              the command line has been loaded.

       -O <value>
              Alias for --one-line-before-file

       -o <value>
              Alias for --one-line

       -Q     Alias for --source-quietly

       --source-before-file <file>
              Tells the debugger to read in and execute the lldb commands in the given file, before any file has
              been loaded.

       --source-on-crash <file>
              When in batch mode, tells the debugger to source this file of lldb commands if the target crashes.

       --source-quietly
              Tells the debugger to execute this one-line lldb command before any file has been loaded.

       --source <file>
              Tells  the debugger to read in and execute the lldb commands in the given file, after any file has
              been loaded.

       -S <value>
              Alias for --source-before-file

       -s <value>
              Alias for --source

       -x     Alias for --no-lldbinit

   OPTIONS:
       --arch <architecture> Tells the debugger to use the specified architecture when starting and running  the
              program.

       -a <value>
              Alias for --arch

       --capture-path <filename>
              Tells the debugger to use the given filename for the reproducer.

       --capture
              Tells the debugger to capture a reproducer.

       --core <filename>
              Tells the debugger to use the full path to <filename> as the core file.

       -c <value>
              Alias for --core

       --debug
              Tells the debugger to print out extra information for debugging itself.

       -d     Alias for --debug

       --editor
              Tells the debugger to open source files using the host's "external editor" mechanism.

       -e     Alias for --editor

       --file <filename>
              Tells the debugger to use the file <filename> as the program to be debugged.

       -f <value>
              Alias for --file

       --help Prints out the usage information for the LLDB debugger.

       -h     Alias for --help

       --no-use-colors
              Do not use colors.

       --replay <filename>
              Tells the debugger to replay a reproducer from <filename>.

       --reproducer-generate-on-exit
              Generate reproducer on exit.

       --reproducer-no-generate-on-signal
              Don't generate reproducer when a signal is received.

       --reproducer-no-version-check
              Disable the reproducer version check.

       --version
              Prints out the current version number of the LLDB debugger.

       -v     Alias for --version

       -X     Alias for --no-use-color

   REPL:
       -r=<flags>
              Alias for --repl=<flags>

       --repl-language <language>

              Chooses the language for the REPL.

       --repl=<flags> Runs lldb in REPL mode with a stub process with the given flags.

       --repl
              Runs lldb in REPL mode with a stub process.

       -R <value>
              Alias for --repl-language

       -r     Alias for --repl

   SCRIPTING:
       -l <value>
              Alias for --script-language

       --python-path Prints out the path to the lldb.py file for this version of lldb.

       -P     Alias for --python-path

       --script-language <language>

              Tells the debugger to use the specified scripting language for user-defined scripts.

   EXAMPLES:
              The debugger can be started in several modes.

              Passing  an  executable  as  a positional argument prepares lldb to debug the given executable. To
              disambiguate between arguments passed to lldb and arguments passed  to  the  debugged  executable,
              arguments starting with a - must be passed after --.

              lldb --arch x86_64 /path/to/program program argument -- --arch arvm7

              For convenience, passing the executable after -- is also supported.

              lldb --arch x86_64 -- /path/to/program program argument --arch arvm7

              Passing one of the attach options causes lldb to immediately attach to the given process.

              lldb -p <pid> lldb -n <process-name>

              Passing --repl starts lldb in REPL mode.

              lldb -r

              Passing --core causes lldb to debug the core file.

              lldb -c /path/to/core

              Command  options  can  be  combined  with these modes 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.

              lldb  -O  'settings set stop-disassembly-count 20' -o 'run' -o 'bt' lldb -S /source/before/file -s
              /source/after/file lldb -K /source/before/crash -k /source/after/crash

              Note: In REPL mode no file is loaded, so commands specified to run after loading the file (via  -o
              or -s) will be ignored.