Intel(r) UEFI Development Kit Debugger Tool User Manual

6
Configure
the Linux Debug
Environment
6.1 Introduction
This section contains these major discussions:
Build the firmware image—described earlier in Section 3 of this manual
Configure the host machine—install and configure software and host settings
Install and configure the Intel UDK Debugger Tool
Connect the host and target systems
6.2 Configure the Linux host machine
To configure a Linux platform, first install the debug solution then configure the host
for debugging the target platform. The following figure shows how the debug components
interact on a Linux platform during a debug session.
Note: For Linux platforms, x64 code can only be debugged when using GDB on x64 Linux
platforms. When debugging x64 platforms, make sure to build the firmware image
on an x64 Linux machine so that the debug symbols are accessible to the GDB.
6.3 Verify the Linux/GDB platform
The GDB is typically installed by default with most Linux OS’s. However, it is advisable
to verify this before trying to configure the host machine or install the Intel UDK Debugger
Tool. Follow these general steps:
1. Make sure the host machine is configured with a supported Linux OS (refer to the list
of supported operating systems in Section 2 of this user manual).
2. Verify that the GDB is installed as appropriate for a Linux-based OS. Although GDB
supports the unresolved breakpoint setting by design, it needs to be recompiled to
include the Expat XML parsing library because the pre-installation doesn’t include it.
Using the GDB pre-installed doesn’t block the other features.
Use “--target=x86_64-w64-mingw32 --with-expat” as the parameter to configure the
GDB before Make so GDB can use the Expat XML parsing library. This library may be
included in the end user’s Linux distribution. If not, it can be easily downloaded
from http://expat.sourceforge.net.
32