Xen Aware Debugging - 2025.1 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.

To enable Xen-aware debug, follow the steps below:

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. A dialog box for adding symbols file is displayed.
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. Xen is now enabled and can be observed in the Debug view.
10. Right click on VCPU #0 and click Manage Symbol files and add the vmlinux symbol file generated in 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 all the symbol files are mapped, then use the step-in and step-over options for further debugging.