Debugger Setup

This is an old revision of Debugger Setup, edited by Martin at . The current revision is 77146.

From Lazarus 2.0 onwards the IDE has an LLDB based debugger for MacOS. Many of the captions in the IDE still refer explicitly to GDB, but the options apply to LLDB too.

Configure the IDE

In order to be able to debug your projects, you need to make sure the IDE is correctly configured.

These settings do not usually change. You need to make them only once after you installed Lazarus, or if you changed/updated your installation

Open the Lazarus option dialog

The image shows where to find the option dialog in Lazarus 0.9.31 and up. In previous versions the entry is in the "Environment" menu.

Lazarus 2.0 and up: On Windows 64 find the option "FixIncorrectStepOver" in the property grid and set it to enabled (true).

Project Options

In order to debug your project, you need to tell the IDE to compile it in a special way, which provides additional information required by the debugger.

Please note: This will considerably increase the size of your executable (See FAQ). If you want to build a release version of your software you should switch those settings off (see also Build Modes)

The required settings are made in the "Project Options" dialog:

GDB Version

GDB 7.5 requires Lazarus 1.4 or higher.

GDB 7.7.1 seems to work well with Lazarus 1.2.4.

On MacOS: LLDB is part of the developer tools by Apple

See also