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 setting up PetaLinux Working Environment.

Table 1. PetaLinux Working Environment Troubleshooting
Problem / Error Message Description and Solution
WARNING: /bin/sh is not bash Problem Description:

This warning message indicates that your default shell is linked to dash.

Solution:

PetaLinux tools require your host system /bin/sh is bash. If you are using Ubuntu distribution and your /bin/sh is dash, consult your system administrator to change your default host system /bin/sh with the sudo dpkg-reconfigure dash command.
Failed to open PetaLinux lib Problem Description:

This error message indicates that a PetaLinux library failed to load. The possible reasons are:

  • The PetaLinux settings.sh has not been loaded.
  • The Linux Kernel that is running has SELinux configured. This can cause issues with regards to security context and loading libraries.
Solution:
  1. Source the settings.sh script from the top-level PetaLinux directory. For more information, see PetaLinux Working Environment Setup.
  2. If you have SELinux enabled, determine if SELinux is in enforcing mode. If SELinux is configured in enforcing mode, either reconfigure SELinux to permissive mode (see the SELinux manual) or change the security context of the libraries to allow access.
cd $PETALINUX/tools/xsct/lib/lnx64.o
chcon -R -t textrel_shlib_t lib