Intel® System Debugger - System Debug User and Reference Guide

User and Reference Guide

  • 2021.1
  • 12/04/2020
  • Public Content
Contents

Automatic Loading

The automatic method is based on scanning the memory for PE/COFF module headers.
To load debug information automatically, select the desired debug context in the Debug view and click the
load this
 Load available debug symbols
 (formerly named
Load This
) button in the Eclipse* toolbar:
load this context
The selected context defines the address range that will be searched for debug information:
  • If you select a
    thread instance suspended
     hardware thread, the memory scan will start from the program counter of the thread.
    The value is equal to the program counter of the first stack frame of the thread.
  • If you select a
    stack frame instance
     stack frame, the start point will be its program counter (displayed in the view).
IMPORTANT
: Clicking
Load available debug symbols
 results in loading the debug information only for the currently executing EFI module (at the time of the target halt). If you want to load debug information for multiple modules, use map files with required debug information.
If the search is successful, you should see the following changes:
  • In the ISD Shell, the following information is displayed under the
    INFO:
     tag:
    • Memory addresses that the debugger searched between.
    • The detected module, its address, and its size in bytes.
    • The file name of the loaded module, for which a memory mapping is created.
  • In the Modules view, a new entry is displayed specifying the path, the address, and the size of the loaded file.
  • In the Debug view, new stack frames are displayed under the selected debug context.
NOTE
: During one execution of
Load available debug symbols
, the debugger loads only one file and stops searching for other modules after the first one is found.
For details on fixing issues with symbols loading, refer to the Troubleshooting section.
Intel® Slim Bootloader (Intel® SBL) Support
Intel® System Debugger supports Firmware with Terse Executable (TE) sections such as Intel® Slim Bootloader (Intel® SBL). To enable automatic loading of debug information with the Intel® SBL supported, do the following:
  1. Open the environment file for editing:
    • For Windows* OS:
      <install_dir>/env.d/win32/*-isysdbg-env.bat
    • For Linux* OS:
      <install_dir>/env.d/linux/*-isysdbg-env.sh
  2. Add the following environment variables:
    • ISYSDBG_FLASH_BASE
       - set it to the base address for the flash memory, in hex format.
    • ISYSDBG_FLASH_SIZE
       - set it to the total size of flash memory, in hex format.
  3. Save the file.
Now you can use the
load this
 Load available debug symbols
 button to load debug information automatically.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.