Wine-NSPA 11.x Documentation

Architecture, implementation, and validation docs for the current Wine-NSPA 11.x tree. Last updated 2026-05-30.

Architecture & Design

• Aggregate-Wait and Async Completion CORE
  Aggregate-wait, same-thread CQE drain, and async completion ownership.
• Architecture Overview CORE
  System map for the current client, wineserver, and kernel layers.
• Audio Stack CORE
  winejack, nspaASIO, and the RT callback audio path.
• Client Scheduler Architecture CORE
  `wine-sched`, `wine-sched-rt`, close queue, and sched-hosted timers.
• Critical Section PI CORE
  Priority inheritance for `CRITICAL_SECTION`.
• Gamma Channel Dispatcher CORE
  Kernel-mediated wineserver IPC, aggregate-wait, and burst drain.
• Hook Cache CORE
  Tier 1 + Tier 2 Win32 hook-chain caching.
• Hot-Path Optimizations CORE
  TEB state, cache layout, SIMD string/Unicode loops, and other cost trims.
• io_uring I/O Architecture CORE
  File, socket, and async `CreateFile` use of `io_uring`.
• librtpi (PI mutex / condvar) CORE
  Wine’s internal PI mutex and condvar shim.
• Local-File Bypass Architecture CORE
  Local regular-file and explicit-directory handling.
• Local Section Bypass CORE
  Client-side unnamed file-backed sections on local-file handles.
• Message Ring Architecture CORE
  Message rings, redraw push, paint cache, and empty-poll caching.
• Memory, Sections, Large Pages, and Working-Set Support CORE
  Sections, large pages, working-set support, and shared-memory backing.
• NT Local Stubs CORE
  The NT-local stub pattern and the active stub surfaces.
• NTSync PI Kernel CORE
  Kernel-side ntsync overlay, PI, channels, and aggregate-wait.
• NTSync Userspace Sync CORE
  Wine-side ntsync cache, wait/signal path, and zero-time waits.
• Thread and Process Shared-State Bypass CORE
  Published thread/process snapshots and zero-time waits.
• NSPA X11 Embed Protocol CORE
  Atomic X11 embedding for Winelib hosts with Wine HWND children.
• NSPA Wayland Embed Protocol CORE
  Native Wayland embedding for Winelib hosts with Wine HWND children.
• Win32 Condvar PI (Requeue-PI) CORE
  Priority inheritance for Win32 condition variables.
• Wineserver Decomposition PLAN
  Residual wineserver scope and decomposition path.

Applications

• Lulada APP
  Linux Digital Audio Workstation with recording, sequencing, JACK routing, and in-process Windows plugins.
• JUCE-NSPA FRAMEWORK
  Framework fork for Linux winelib hosting and native plugin embedding.
• Yabridge-NSPA APP
  Linux VST bridge fork aligned to Wine-NSPA RT and PI rules.

Test Results & Validation

• RT Test Harness DATA
  Native ntsync tests, the PE matrix, and targeted validators.
• State of The Art LIVE
  Current active state, defaults, validation, and key results.
• Test Suite Comparison DATA
  Archived suite snapshots, per-test deltas, and targeted A/Bs.

Wine-NSPA by Jordan Johnston — github.com/nine7nine/Wine-NSPA
Kernel: Linux-NSPA 6.19.11-rt1-1 (PREEMPT_RT) | Wine 11.8 | 2026-05-30