Troubleshooting - Troubleshooting - 2026.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID
UG1144
Release Date
2026-06-23
Version
2026.1 English

This section describes some common issues you can experience while debugging applications with GDB.

Table 1. Debugging Zynq UltraScale+ MPSoC Applications with GDB Troubleshooting
Problem / Error Message Description and Solution
GDB error message: <IP Address>:<port>: Connection refused. GDB cannot connect to the target board using <IP>: <port> Problem Description:

This error message indicates that the GDB client failed to connect to the GDB server.

Solution:

Check whether the gdbserver is running on the target system.

Check whether there is another GDB client already connected to the GDB server. This can be done by looking at the target console. If you can see Remote Debugging from host <IP>, it means there is another GDB client connecting to the server.

Check whether the IP address and the port are correctly set.