2.4 KiB
2.4 KiB
Known issues
If you're trying the commands on the homepage and running into issues, it may be one of these known issues.
Windows: File not found
If you encounter an error like this:
Windows does not have symlinks enabled, or Git is not configured to use them. This is very annoying and has been reported to Microsoft.
Two solutions:
- (recommended) Build a native Windows binary by cross-compiling from WSL -> Windows:
cd mach/gpuzig build -Dtarget=x86_64-windows- Run the exe in
zig-out/bin/outside of WSL.
- Enable symlinks in Windows:
- Turn on Development Mode
- Ensure symlinks are installed in Git
git config --global core.symlinks true - Re-clone the repository and try again.
Windows: "SSL certificate problem: unable to get local issuer certificate"
This is a curl SSL CA issue, you may want to Google for proper solutions on your system. That said, you can set CURL_INSECURE=true and retry to disable SSL verification if you want to workaround the issue.
Linux: Error: Couldn't load Vulkan. Searched /tmp/mach/gpu/zig-out/bin/libvulkan.so.1
We're aware of a bug failing to find libvulkan.so on some Linux distros such as Guix.
Error: Couldn't load Vulkan. Searched /tmp/mach/gpu/zig-out/bin/libvulkan.so.1, /tmp/mach/gpu/zig-out/bin/libvulkan.so.1, libvulkan.so.1.
at operator() (/home/runner/work/mach-gpu-dawn/mach-gpu-dawn/libs/dawn/src/dawn/native/vulkan/BackendVk.cpp:198)
at Initialize (/home/runner/work/mach-gpu-dawn/mach-gpu-dawn/libs/dawn/src/dawn/native/vulkan/BackendVk.cpp:203)
at Create (/home/runner/work/mach-gpu-dawn/mach-gpu-dawn/libs/dawn/src/dawn/native/vulkan/BackendVk.cpp:165)
at operator() (/home/runner/work/mach-gpu-dawn/mach-gpu-dawn/libs/dawn/src/dawn/native/vulkan/BackendVk.cpp:420)
found Null backend on CPU adapter: Null backend,
This is a bug in Dawn, you can workaround it for now by specifying the path to libvulkan.so on your system LD_PRELOAD like e.g.:
LD_PRELOAD=/run/current-system/profile/lib/libvulkan.so zig-out/bin/gpu-hello-triangle