Debug C and C++ with LLDB

Debug C and C++ programs on Red Hat Enterprise Linux from the command line by using LLDB, the LLVM debugger in LLVM Toolset. Use LLDB 21.1.8 to inspect memory, control program execution, and set breakpoints when investigating application behavior.

Prerequisites

  • LLVM Toolset is installed.
  • Your compiler is configured to create debug information.

Start a debugging session

Use LLDB to start an interactive debugging session.

Procedure

  1. Run LLDB on a program you want to debug:
    $ lldb <binary_file>

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

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

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

Run the program in a debugging session

Use LLDB to run 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.

Before you begin

  • You started an interactive debugging session with LLDB.

Procedure

Run the program you are debugging:
(lldb) run

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

(lldb) run <argument>

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

Use breakpoints

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

Before you begin

  • You started an interactive debugging session with LLDB.

Procedure

  • To set a new breakpoint on a specific line, enter:
    (lldb) breakpoint set --file <source_file_name> --line <line_number>

    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>
    • 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
  • To delete a breakpoint, run:
    (lldb) breakpoint clear -f <source_file_name> -l <line_number>
    • 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
  • To skip a specific number of breakpoints, enter:
    (lldb) continue -i <breakpoints_to_skip>
    • 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.

Step through code

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

Before you begin

  • You started an interactive debugging session with LLDB.

Procedure

  1. Set your line pointer to the line you want to run.
  2. Enter:
    (lldb) step

List source code

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

Before you begin

  • You started an interactive debugging session with LLDB.

Procedure

To list the first 10 lines of the source code of the program you are debugging, enter:
(lldb) list
(lldb) list <source_file_name>:<line_number>

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

Display current program data

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.

Before you begin

  • You started an interactive debugging session with LLDB.

Procedure

Display the current value of a certain variable, expression, or return value:
(lldb) print <data_name>

Replace <data_name> with data you want to display.