Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 3. The LLDB debugger

The LLDB debugger is a command-line tool for debugging C and C++ programs. Use LLDB to inspect memory within the code being debugged, control the execution state of the code, and detect the execution of particular sections of code.

LLVM Toolset is distributed with LLDB 19.1.7.

3.1. Prerequisites
Copy link

3.2. Starting a debugging session
Copy link

Use LLDB to start an interactive debugging session.

Procedure

  1. Run LLDB on a program you want to debug: 

    $ lldb <binary_file>
    Copy to Clipboard Toggle word wrap

    Replace <binary_file> with the name of your compiled program.

    You have started your LLDB debugging session in interactive mode. Your command-line terminal now displays the default prompt (lldb).

  2. To quit the debugging session and return to the shell prompt: 

    (lldb) quit
    Copy to Clipboard Toggle word wrap

Use LLDB to execute your program during your debugging session. The execution of your program stops when the first breakpoint is reached, when an error occurs, or when the program terminates.

Prerequisites

Procedure

  • Execute the program you are debugging: 

    (lldb) run
    Copy to Clipboard Toggle word wrap

    Alternatively, execute the program you are debugging by using a specific argument: 

    (lldb) run <argument>
    Copy to Clipboard Toggle word wrap

    Replace <argument> with the command-line argument you want to use.

3.4. Using breakpoints
Copy link

Use breakpoints to pause the execution of your program at a set point in your source code.

Prerequisites

Procedure

  • To set a new breakpoint on a specific line, enter: 

    (lldb) breakpoint set --file <source_file_name> --line <line_number>
    Copy to Clipboard Toggle word wrap

    Replace <source_file_name> with the name of your source file and <line_number> with the line number you want to set your breakpoint at.

  • To set a breakpoint on a specific function, enter: 

    (lldb) breakpoint set --name <function_name>
    Copy to Clipboard Toggle word wrap
    • Replace <function_name> with the name of the function you want to set your breakpoint at.

  • To display a list of currently set breakpoints, enter: 

    (lldb) breakpoint list
    Copy to Clipboard Toggle word wrap

  • To delete a breakpoint, run: 

    (lldb) breakpoint clear -f <source_file_name> -l <line_number>
    Copy to Clipboard Toggle word wrap
    • Replace <source_file_name> with the name of your source file and <line_number> with line number of the breakpoint you want to delete.

  • To resume the execution of your program after it reached a breakpoint, enter: 

    (lldb) continue
    Copy to Clipboard Toggle word wrap

  • To skip a specific number of breakpoints, enter: 

    (lldb) continue -i <breakpoints_to_skip>
    Copy to Clipboard Toggle word wrap
    • Replace <breakpoints_to_skip> with the number of breakpoints you want to skip. To skip a loop, set the <breakpoints_to_skip> to match the loop iteration count.

3.5. Stepping through code
Copy link

You can use LLDB to step through the code of your program to execute only one line of code after the line pointer.

Prerequisites

Procedure

  1. Set your line pointer to the line you want to execute.

  2. Enter: 

    (lldb) step
    Copy to Clipboard Toggle word wrap

3.6. Listing source code
Copy link

Before you run the program you are debugging, the LLDB debugger automatically displays the first 10 lines of source code. Each time the execution of the program is stopped, LLDB displays the line of source code on which it stopped and its surrounding lines. You can use LLDB to manually trigger the display of source code during your debugging session.

Prerequisites

Procedure

  • To list the first 10 lines of the source code of the program you are debugging, enter: 

    (lldb) list
    Copy to Clipboard Toggle word wrap 
    (lldb) list <source_file_name>:<line_number>
    Copy to Clipboard Toggle word wrap

    Replace <source_file_name> with the name of your source file and <line_number> with the number of the line you want to display.

3.7. Displaying current program data
Copy link

The LLDB debugger provides data on variables of any complexity, any valid expressions, and function call return values. You can use LLDB to display data relevant to the program state.

Prerequisites

Procedure

  • Display the current value of a certain variable, expression, or return value: 

    (lldb) print <data_name>
    Copy to Clipboard Toggle word wrap

    Replace <data_name> with data you want to display.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat