Xen Aware Debugging - 2025.2 English - UG1400

Xen is an open-source hypervisor that allows multiple virtual machines to run on a single physical machine. Xen-aware debugging refers to the debugging techniques and tools specifically designed for debugging software running on the Xen hypervisor. With Xen-aware debug support enabled, you can conduct Xen-aware debug.

Follow these steps to enable Xen-aware debug.

1. Refer to PetaLinux Tools Documentation: Reference Guide (UG1144) to prepare the environment for booting a pre-built Linux as dom0.
2. Start the Vitis Unified IDE.
3. Create and build the application.
4. Launch the Debug configuration.
5. Click New Launch Configuration.
6. Select the Target Connection and set the target mode as Attach to running process.
7. Click the Debug button to start the debug session.
8. Right click on APU Cortex A72 #0 and click on Manage symbol files in the Debug view.
9. Click the + button to add symbols. Select the symbol file xen-syms generated in the PetaLinux project in the first step, enable all the following options and click the Ok button. This step maps the symbols of the Xen hypervisor.
10. Right click VCPU #0 and click Manage Symbol files. Add the vmlinux symbol file from the PetaLinux project in the first step for DOM0. Do not enable the OS Awareness option in this step.
11. Select VCPU #0 and Pause in the Debug view.
12. Check the Call Stack view to ensure the mapping of all symbol files. Use the step-in and step-over options for further debugging.