Why is there "sopcinfo2swinfo.exe: command not found" when running sopc-create-header-files under WSL, or Docker under Windows?

Description

An error message like this:

sopc-create-header-files: line 182: sopcinfo2swinfo.exe: command not found 

sopc-create-header-files: sopcinfo2swinfo.exe --input=./peripheral_subsys.sopcinfo --output=/tmp/sopc-create-header-files.1312.tmp.swinfo  failed 

will be seen in the Quartus^® Prime Pro Edition Software version 25.3.1 and earlier, when using the sopc-create-header-files script within the Linux version of the Quartus^® Prime Pro Edition Software, running on the Microsoft* Windows operating system. The Linux version of the tools can be installed under Windows* using WSL, WSL2 or Docker. In all of these cases, the sopc-create-header-files script detects that it is running under Windows* and looks for an internal tool with the suffix “.exe”. However, since the Linux version has been installed, the tool does not have that suffix and so cannot be found by the sopc-create-header-files script.

Resolution

To work around the problem, either switch to using a Windows* installation of the Quartus® Prime Pro Edition Software, or follow these steps to continue using the Linux installation under Windows*:

1. Under Linux, use the command “which sopc-create-header-files” to find the location of the script.
2. Copy the script from this location to another location of your choice.
3. Make the newly copied script version writable using the command:

   chmod +w <path to newly copied script>

4. Modify your newly copied script version. Find the following line:

   windows_exe=.exe

   and either remove it or add a single # symbol at the start to comment it
5. Use your newly modified version of the script instead of the installed version. This will now execute correctly.