Starting an Agent Based Debug Session

  1. Click New Connection... in the Intel® System Studio IDE as described in Starting and Finishing a Debugging Session.
  2. Select Any in the Target Type list and EUFI Agent in the Connection Method list, then click Finish.
  3. Click the Connect button and launch the debugger as described in Starting and Finishing a Debugging Session.

    The debugger starts in wait mode, waiting for the debug target to open the connection.

  4. Power on the debug target.

If you want to specify a different connection setup, click the Disconnect button in the upper left corner of the debugger GUI and use the console command CONNECT.

Adding module names to the UEFI module watchlist halts the debug target when a module with a matching name is loaded. Symbols for module on the watchlist are automatically loaded by the debugger if the symbol file is found at the same path on the host PC as read from BIOS. This is true if the PC used for debugging has the symbol files in the path that was used for building the BIOS. If the symbol path doesn't match, you must browse to the symbol file location and load the symbol file manually to be able to debug the source code.

After execution is stopped by a module load and the symbol file is found, the debugger sets a breakpoint to the module entry point and runs to it if there are available HW breakpoints. The module entry breakpoint is left to the breakpoint list. When debugging multiple modules the breakpoints must be deleted manually to allow running to the next module entry point.

For more complete information about compiler optimizations, see our Optimization Notice.