Debugging a Linux Application from the Vitis IDE - 2024.2 English - UG1209

Debugging Linux applications requires the Linux agent to be set up properly. Refer to Preparing the Linux Agent for Remote Connection for detailed steps.

1. Debug the Linux application:

   1. Right-click hello_linux, then select Debug As → Debug Configurations.

   2. Expand Single Application Debug and select Debugger_hello_linux-Default.

   3. Review the configurations:

      • Debug type: Linux Application Debug

      • Connection: Linux Agent

   4. Click Debug.

   The debug configuration has identical options to the run configuration. The difference between debugging and running is that debugging stops at the main() function.

2. Try the debugging features:

   Hello World is a simple application. It does not contain much to debug, but you can try the following to explore the Vitis debugger:

   • Review the tabs on the upper right corner: Variables, Breakpoints, Expressions, and the rest.

   • Review the call stack on the left.

   • The next line to execute has a green background.

   • Step over by clicking the icon on the toolbar or pressing F6 on the keyboard. The printed string will be shown on the Console panel.

   

3. Disconnect the connection:

   • Click the Terminate button on the toolbar or press Ctrl+F2.

   • Click the Disconnect button on the toolbar.