# LLDB Debugger User Guide

Contents

- [Introduction](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-ug-introduction.html)
    - [Features](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-ug-introduction.html#features)
    - [Conventions](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-ug-introduction.html#conventions)
- [Get started](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html)
    - [Start the debugger](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#start-the-debugger)
    - [Debug commands](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#debug-commands)
    - [Load a program](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#load-a-program)
    - [Set breakpoints](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#set-breakpoints)
    - [Set watchpoints](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#set-watchpoints)
    - [Start your program](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#start-your-program)
    - [Control your program](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#control-your-program)
    - [Examine the thread state](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#examine-the-thread-state)
    - [Examine the stack frame state](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-get-started.html#examine-the-stack-frame-state)
- [Use the debugger](https://docs.qualcomm.com/doc/80-N3040-23/topic/use-the-debugger.html)
    - [Start the debugger](https://docs.qualcomm.com/doc/80-N3040-23/topic/use-the-debugger.html#start-the-debugger)
    - [Debug options](https://docs.qualcomm.com/doc/80-N3040-23/topic/use-the-debugger.html#debug-options)
    - [Debug commands](https://docs.qualcomm.com/doc/80-N3040-23/topic/use-the-debugger.html#debug-commands)
- [Frame and thread formatting](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-and-thread-formatting.html)
    - [Stack frame and thread format](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-and-thread-formatting.html#stack-frame-and-thread-format)
    - [Format strings](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-and-thread-formatting.html#format-strings)
    - [Format example](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-and-thread-formatting.html#format-example)
    - [User-defined formats](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-and-thread-formatting.html#user-defined-formats)
- [Frame symbolication](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html)
    - [Manual symbolication with LLDB](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#manual-symbolication-with-lldb)
    - [Define load addresses for sections](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#define-load-addresses-for-sections)
    - [Load multiple executables](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#load-multiple-executables)
    - [Get variable information](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#get-variable-information)
    - [Use Python API to symbolicate](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#use-python-api-to-symbolicate)
    - [Use built-in Python module to symbolicate](https://docs.qualcomm.com/doc/80-N3040-23/topic/frame-symbolication.html#use-built-in-python-module-to-symbolicate)
- [Variable formatting](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html)
    - [Variable display](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#variable-display)
    - [Type formats](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#type-formats)
    - [Type summaries](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#type-summaries)
    - [Python scripts](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#python-scripts)
    - [Regular expression type names](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#regular-expression-type-names)
    - [Named summaries](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#named-summaries)
    - [Synthetic children](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#synthetic-children)
    - [Filters](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#filters)
    - [Categories](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#categories)
    - [Finding formatters 101](https://docs.qualcomm.com/doc/80-N3040-23/topic/variable-formatting.html#finding-formatters-101)
- [Python scripting](https://docs.qualcomm.com/doc/80-N3040-23/topic/python-scripting.html)
    - [LLDB API](https://docs.qualcomm.com/doc/80-N3040-23/topic/python-scripting.html#lldb-api)
    - [Embedded Python interpreter](https://docs.qualcomm.com/doc/80-N3040-23/topic/python-scripting.html#embedded-python-interpreter)
    - [Run a script when a breakpoint is hit](https://docs.qualcomm.com/doc/80-N3040-23/topic/python-scripting.html#run-a-script-when-a-breakpoint-is-hit)
    - [Create new command using a Python function](https://docs.qualcomm.com/doc/80-N3040-23/topic/python-scripting.html#create-new-command-using-a-python-function)
- [Script example](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html)
    - [The test program and input](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#the-test-program-and-input)
    - [The bug](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#the-bug)
    - [Check for the word in the tree: use DFS](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#check-for-the-word-in-the-tree-use-dfs)
    - [Work with program variables in Python](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#work-with-program-variables-in-python)
    - [Explanation of the DFS script](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#explanation-of-the-dfs-script)
    - [Use the DFS script](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#use-the-dfs-script)
    - [Use breakpoint command scripts](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#use-breakpoint-command-scripts)
    - [Python breakpoint command scripts](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#python-breakpoint-command-scripts)
    - [Decision point breakpoint commands](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#decision-point-breakpoint-commands)
    - [Use breakpoint commands](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#use-breakpoint-commands)
    - [Source files for the example](https://docs.qualcomm.com/doc/80-N3040-23/topic/script-example.html#source-files-for-the-example)
- [Debug with the booter image](https://docs.qualcomm.com/doc/80-N3040-23/topic/debug-with-the-booter-image.html)
- [Troubleshooting](https://docs.qualcomm.com/doc/80-N3040-23/topic/troubleshooting.html)
    - [Breakpoints on target are not being hit](https://docs.qualcomm.com/doc/80-N3040-23/topic/troubleshooting.html#breakpoints-on-target-are-not-being-hit)
    - [File and line breakpoints are not being hit](https://docs.qualcomm.com/doc/80-N3040-23/topic/troubleshooting.html#file-and-line-breakpoints-are-not-being-hit)
    - [Check for debug symbols](https://docs.qualcomm.com/doc/80-N3040-23/topic/troubleshooting.html#check-for-debug-symbols)
- [Architecture](https://docs.qualcomm.com/doc/80-N3040-23/topic/architecture.html)
- [Acknowledgments](https://docs.qualcomm.com/doc/80-N3040-23/topic/lldb-debugger-acknowledgments.html)

Last Published: Oct 06, 2026

[Previous Topic
Statistics](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/statistics.md) [Next Topic
Introduction](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/lldb-debugger-ug-introduction.md)