User and Reference Guide

  • 2020
  • 10/23/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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804