lldb - manual page for lldb 14
OVERVIEW: LLDB
USAGE: lldb [options]
--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
- --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 not to echo commands while sourcing files or one-line
commands provided on the command line.
- --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
--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.
- --reproducer-generate-on-exit
- Generate reproducer on exit.
- --version
- Prints out the current version number of the LLDB debugger.
- -v
- Alias for --version
- -X
- Alias for --no-use-color
- -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
- -l <value>
- Alias for --script-language
--print-script-interpreter-info
- Prints out a json dictionary with information about the scripting language
interpreter.
--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.
- 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 armv7
- For convenience, passing the executable after -- is also
supported.
- lldb --arch x86_64 -- /path/to/program program
argument --arch armv7
- 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.