James Stringer
9f1772ce60
- LICENSE: MIT, Copyright (c) 2026 James Stringer.
- THIRD-PARTY-NOTICES.md: scopes the MIT grant around bundled third-party
components, documenting each one's license/copyright:
dxgkrnl (Microsoft WSL2 GPU driver) GPL-2.0; iso-patch/engine/xz 0BSD;
wsl-mesa prebuilt (Mesa 25.3.6) MIT; WDF SDK, WebView2 SDK, DevCon (Microsoft).
- tools/linux/dxgkrnl/COPYING: verbatim GPL-2.0 text shipped with the GPL'd
driver source.
- tools/linux/wsl-mesa/prebuilt/MESA-LICENSE.txt: Mesa's headline MIT license,
shipped next to the prebuilt binary.
- README: license section points to LICENSE + THIRD-PARTY-NOTICES.
- Info.plist: copyright string now names the holder and notes MIT.
The asb_drm Linux kernel module keeps its existing dual (GPL-2.0 OR MIT)
licensing; vendored sources keep their own SPDX headers.
wsl-mesa — Mesa with d3d12 gallium + dzn Vulkan, prebuilt
Custom Mesa build that exposes Hyper-V GPU-PV (via /dev/dxg) to
userspace OpenGL and Vulkan workloads on a Linux guest, with zero
Microsoft proprietary blobs.
Meson flags:
-D gallium-drivers=llvmpipe,d3d12
-D vulkan-drivers=swrast,microsoft-experimental
-D microsoft-clc=enabled
-D video-codecs=all
-D glvnd=enabled
The two drivers we care about are both pure-open-source: Mesa's
d3d12 gallium driver and the microsoft-experimental Vulkan driver
(aka dzn, Direct3D 12 backend for Vulkan). Both reach the GPU
partition adapter via /dev/dxg ioctls directly — they ship their
own dxcore-equivalent code in src/microsoft/ so we don't need
libdxcore.so/libd3d12.so/libdirectml.so from a WSL2 install.
Layout
tools/wsl-mesa/
├── README.md
├── build/
│ └── build-mesa.sh ← reproduces a build on any 26.04 VM
└── prebuilt/
└── ubuntu-26.04-amd64/
├── wsl-mesa.tar.zst ← /opt/wsl-mesa tarball
└── BUILDINFO ← Mesa version, source commit, LLVM ver
Install on a Linux VM
sudo mkdir -p /opt/wsl-mesa
sudo zstd -d wsl-mesa.tar.zst -c | sudo tar -C / -x
echo /opt/wsl-mesa/lib/x86_64-linux-gnu | sudo tee /etc/ld.so.conf.d/wsl-mesa.conf
sudo ldconfig
# Vulkan ICD search:
sudo install -d /etc/vulkan/icd.d
sudo ln -sf /opt/wsl-mesa/share/vulkan/icd.d/dzn_icd.x86_64.json \
/etc/vulkan/icd.d/dzn_icd.x86_64.json
To opt in per-process instead of system-wide:
export LD_LIBRARY_PATH=/opt/wsl-mesa/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
export VK_DRIVER_FILES=/opt/wsl-mesa/share/vulkan/icd.d/dzn_icd.x86_64.json
export __GLX_VENDOR_LIBRARY_NAME=mesa
export MESA_LOADER_DRIVER_OVERRIDE=d3d12
Why a separate prefix
Installing to /opt/wsl-mesa instead of /usr keeps Ubuntu's apt
Mesa intact. apt upgrade mesa-* won't clobber our build, and we
won't break apps that need stock Mesa. Switch is via ld.so.conf.d
or per-process env vars.
Versioning
Prebuilt artifacts are keyed on <ubuntu-codename>-<arch> since the
binaries are tied to glibc and libstdc++ ABIs, not kernel versions
(unlike dxgkrnl). One subdir per supported distro tuple.
Rebuilding
Run build/build-mesa.sh on a VM with the target codename installed.
Takes ~30 min on a 6-core machine. The script handles deps, source
fetch, meson configure, ninja build, and install.