LLDB(1) User Commands LLDB(1)
NAME
lldb - manual page for lldb 14
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 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
OPTIONS:
--arch <architecture> Tells the debugger to use the specified architec-
ture 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 "exter-
nal 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
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
--print-script-interpreter-info
Prints out a json dictionary with information about the script-
ing 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.
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
armv7
For convenience, passing the executable after -- is also sup-
ported.
lldb --arch x86_64 -- /path/to/program program argument --arch
armv7
Passing one of the attach options causes lldb to immediately at-
tach 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 load-
ing 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.
lldb 14 February 2023 LLDB(1)
Generated by dwww version 1.15 on Fri Jun 21 22:22:00 CEST 2024.