Add windows support

.github/workflows/ci.yml

@@ -148,7 +148,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        config: [default, llvm, gnu32, sanitize, olddeps, newdeps]
+        config: [default, llvm, gnu32, sanitize, olddeps, newdeps, windows]
 
     name: build • ${{ matrix.config }}
 

CMakeLists.txt

@@ -198,6 +198,7 @@ target_link_libraries(multiprocess PUBLIC CapnProto::capnp)
 target_link_libraries(multiprocess PUBLIC CapnProto::capnp-rpc)
 target_link_libraries(multiprocess PUBLIC CapnProto::kj)
 target_link_libraries(multiprocess PUBLIC CapnProto::kj-async)
+target_link_libraries(multiprocess PUBLIC Threads::Threads)
 set_target_properties(multiprocess PROPERTIES
     PUBLIC_HEADER "${MP_PUBLIC_HEADERS}")
 install(TARGETS multiprocess EXPORT LibTargets

ci/README.md

@@ -22,6 +22,7 @@ CI_CONFIG=ci/configs/gnu32.bash    ci/scripts/run.sh
 CI_CONFIG=ci/configs/sanitize.bash ci/scripts/run.sh
 CI_CONFIG=ci/configs/olddeps.bash  ci/scripts/run.sh
 CI_CONFIG=ci/configs/newdeps.bash  ci/scripts/run.sh
+CI_CONFIG=ci/configs/windows.bash  ci/scripts/run.sh
 ```
 
 By default CI jobs will reuse their build directories. `CI_CLEAN=1` can be specified to delete them before running instead.

ci/configs/windows.bash

@@ -0,0 +1,21 @@
+CI_DESC="CI job cross-compiling to Windows with MinGW, tested with Wine"
+CI_DIR=build-windows
+CI_CACHE_NIX_STORE=true
+NIX_ARGS=(
+  --arg windows true
+  --arg minimal true
+)
+CMAKE_ARGS=(
+  -G Ninja
+  -DCMAKE_SYSTEM_NAME=Windows
+  -DCMAKE_FIND_ROOT_PATH_MODE_PROGRAM=NEVER
+  -DCMAKE_CROSSCOMPILING_EMULATOR=wine
+  # -Wa,-mbig-obj: template-heavy C++ generates >32K COFF sections per .obj;
+  # BigCOFF format raises the limit.  Must be passed to the assembler via -Wa.
+  "-DCMAKE_CXX_FLAGS=-Wa,-mbig-obj"
+)
+# CXX is set by the nix cross shell to the mingw g++ wrapper; cmake picks
+# it up from the environment, so no CMAKE_CXX_COMPILER override needed.
+BUILD_ARGS=(-k 0)
+# Build native mpgen first (as a code generator for cross-compiled test/example targets).
+MPGEN_PRE_BUILD=1

ci/scripts/ci.sh

@@ -38,6 +38,49 @@ if [ -n "${CAPNP_CHECKOUT-}" ]; then
 fi
 
 src_dir=$PWD
+
+# If cross-compiling, build native mpgen first so it can be used as a code
+# generator when cmake invokes it from add_custom_command (which does not go
+# through CMAKE_CROSSCOMPILING_EMULATOR, unlike add_test executables).
+if [ -n "${MPGEN_PRE_BUILD-}" ]; then
+  native_dir="${src_dir}/${CI_DIR}-native"
+  [ -n "${CI_CLEAN-}" ] && rm -rf "$native_dir"
+  mkdir -p "$native_dir"
+  # Unset cross-compilation env vars so cmake uses the native compiler and
+  # does a native (not cross) build.  Key vars to clear:
+  #   CXX/CC/AR/RANLIB/LD - set to cross-compiler by the cross shell
+  #   cmakeFlags - nix cross shell injects -DCMAKE_SYSTEM_NAME=Windows etc.
+  # Pass NATIVE_CAPNPROTO_PREFIX as CMAKE_PREFIX_PATH so cmake finds the
+  # native Cap'n Proto rather than the cross-compiled one.
+  native_cmake_args=()
+  if [ -n "${NATIVE_CAPNPROTO_PREFIX-}" ]; then
+    # Build a cmake prefix path with native capnproto and its dependencies
+    # (openssl, zlib) so find_package and find_dependency succeed.
+    native_prefix="${NATIVE_CAPNPROTO_PREFIX}"
+    [ -n "${NATIVE_OPENSSL_DEV-}" ] && native_prefix="${native_prefix};${NATIVE_OPENSSL_DEV}"
+    [ -n "${NATIVE_OPENSSL_LIB-}" ] && native_prefix="${native_prefix};${NATIVE_OPENSSL_LIB}"
+    [ -n "${NATIVE_ZLIB_DEV-}" ]    && native_prefix="${native_prefix};${NATIVE_ZLIB_DEV}"
+    [ -n "${NATIVE_ZLIB_LIB-}" ]    && native_prefix="${native_prefix};${NATIVE_ZLIB_LIB}"
+    native_cmake_args+=(
+      "-DCMAKE_PREFIX_PATH=${native_prefix}"
+      "-DCapnProto_DIR=${NATIVE_CAPNPROTO_PREFIX}/lib/cmake/CapnProto"
+    )
+  fi
+  # -static-libstdc++ / -static-libgcc: the native mpgen must run inside the
+  # cross nix shell where the native libstdc++.so may not be in LD_LIBRARY_PATH.
+  native_cmake_args+=("-DCMAKE_EXE_LINKER_FLAGS=-static-libstdc++ -static-libgcc")
+  (cd "$native_dir" && env -u CXX -u CC -u AR -u RANLIB -u LD -u cmakeFlags cmake "$src_dir" "${native_cmake_args[@]+${native_cmake_args[@]}}" && cmake --build . -t mpgen)
+  CMAKE_ARGS+=("-DMPGEN_EXECUTABLE=${native_dir}/mpgen")
+
+  # Override capnp tool executables: the cross capnproto cmake config sets
+  # CAPNP_EXECUTABLE to capnp.exe (Windows binary), which can't run on Linux.
+  # Use the native capnp/capnpc-c++ binaries from pkgs.capnproto in nativeBuildInputs.
+  _capnp=$(command -v capnp 2>/dev/null || true)
+  _capnpc=$(command -v capnpc-c++ 2>/dev/null || true)
+  [ -n "$_capnp" ]   && CMAKE_ARGS+=("-DCAPNP_EXECUTABLE=$_capnp")
+  [ -n "$_capnpc" ]  && CMAKE_ARGS+=("-DCAPNPC_CXX_EXECUTABLE=$_capnpc")
+fi
+
 mkdir -p "$CI_DIR"
 cd "$CI_DIR"
 export CMAKE_BUILD_PARALLEL_LEVEL="$(nproc)"
@@ -67,4 +110,13 @@ else
     cmake --build . --target "$t" -- "${BUILD_ARGS[@]+"${BUILD_ARGS[@]}"}"
   done
 fi
+# When cross-compiling for Windows, copy GCC and MCF thread runtime DLLs
+# alongside the test executables so wine can find them (wine DLL loading
+# checks the executable's directory first, before any search-path logic).
+if [ -n "${WIN_RUNTIME_DLLS-}" ]; then
+  IFS=: read -ra _dll_dirs <<< "$WIN_RUNTIME_DLLS"
+  for _dir in "${_dll_dirs[@]}"; do
+    find "$_dir" -maxdepth 1 -name "*.dll" -exec cp -n {} test/ \;
+  done
+fi
 ctest --output-on-failure

example/example.cpp

@@ -8,6 +8,7 @@
 #include <cstring> // IWYU pragma: keep
 #include <filesystem>
 #include <fstream>
+#include <functional>
 #include <future>
 #include <iostream>
 #include <kj/common.h>
@@ -26,11 +27,11 @@ namespace fs = std::filesystem;
 
 static auto Spawn(mp::EventLoop& loop, const std::string& process_argv0, const std::string& new_exe_name)
 {
-    const auto [pid, socket] = mp::SpawnProcess([&](mp::SpawnConnectInfo info) -> std::vector<std::string> {
+    const auto [pid, socket] = mp::SpawnProcess([&](std::string connect_info) -> std::vector<std::string> {
         fs::path path = process_argv0;
         path.remove_filename();
         path.append(new_exe_name);
-        return {path.string(), std::move(info)};
+        return {path.string(), std::move(connect_info)};
     });
     return std::make_tuple(mp::ConnectStream<InitInterface>(loop, mp::MakeStream(loop, socket)), pid);
 }

include/mp/util.h

@@ -29,6 +29,17 @@
 #include <memory>
 #endif
 
+#ifdef WIN32
+// WIN32_LEAN_AND_MEAN excludes commdlg.h which defines `#define INTERFACE
+// IPrintDialogServices` — this conflicts with capnp::Kind::INTERFACE used
+// in CAPNP_DECLARE_INTERFACE_HEADER. Must be defined before winsock2.h.
+#ifndef WIN32_LEAN_AND_MEAN
+#define WIN32_LEAN_AND_MEAN
+#endif
+#include <windows.h>
+#include <winsock2.h>
+#endif
+
 namespace mp {
 
 //! Generic utility functions used by capnp code.
@@ -289,33 +300,53 @@ std::string ThreadName(const char* exe_name);
 //! errors in python unit tests.
 std::string LogEscape(const kj::StringTree& string, size_t max_size);
 
+//! Convert an argument vector into a single command line string suitable for
+//! CreateProcess, following the quoting rules of CommandLineToArgvW, which
+//! executables use to split the command line back into arguments. Declared
+//! unconditionally (not just on windows) so it can be unit tested on any
+//! platform.
+std::string CommandLineFromArgv(const std::vector<std::string>& argv);
+
 using Stream = kj::Own<kj::AsyncIoStream>;
 
+#ifdef WIN32
+// On Windows, ProcessId is defined to be the local process HANDLE rather than
+// global process ID, because handles are more useful for controlling and
+// waiting for processes. It it possible to obtain the actual process ID from
+// handles by calling the GetProcessId API.
+using ProcessId = HANDLE;
+using SocketId = SOCKET;
+inline constexpr SocketId SocketError{INVALID_SOCKET};
+#else
 using ProcessId = int;
 using SocketId = int;
 inline constexpr SocketId SocketError{-1};
-
-//! Information about parent process passed to child process as a command-line
-//! argument. On unix this is the child socket fd number formatted as a string.
-using SpawnConnectInfo = std::string;
-
-//! Callback type used by SpawnProcess below.
-using SpawnConnectInfoToArgsFn = std::function<std::vector<std::string>(const SpawnConnectInfo&)>;
+#endif
 
 //! Spawn a new process that communicates with the current process over a socket
-//! pair. Calls connect_info_to_args callback with a connection string that
-//! needs to be passed to the child process, and executes the argv command line
-//! it returns. Returns child process id and socket id.
-std::tuple<ProcessId, SocketId> SpawnProcess(SpawnConnectInfoToArgsFn&& connect_info_to_args);
-
-//! Initialize spawned child process using the SpawnConnectInfo string passed to it,
-//! returning a socket id for communicating with the parent process.
-SocketId StartSpawned(const SpawnConnectInfo& connect_info);
+//! pair. Calls spawn_argv callback with a connection string that needs to be
+//! passed to the child process, and executes the argv command line it returns.
+//! Returns child process id and socket id.
+//!
+//! The connection string is just a file descriptor number on unix. On windows,
+//! it is a path to a named pipe the parent process will write
+//! WSADuplicateSocket info to. In both cases, the child process can call
+//! StartSpawned to get a socket handle from the connection string.
+std::tuple<ProcessId, SocketId> SpawnProcess(const std::function<std::vector<std::string>(std::string)>& spawn_argv);
+
+//! Initialize spawned child process. The connect_info argument is the
+//! connection string SpawnProcess generated in the parent process and passed
+//! to the child on its command line. Returns socket id for communicating with
+//! the parent process.
+SocketId StartSpawned(const std::string& connect_info);
 
 //! Create a socket pair that can be used to communicate within a process or
 //! between parent and child processes.
 std::array<SocketId, 2> SocketPair();
 
+//! Close a socket, throwing a KJ exception on failure.
+void CloseSocket(SocketId fd);
+
 //! Start a process and return its process id. Caller should call WaitProcess
 //! on the returned id.
 ProcessId StartProcess(const std::vector<std::string>& args);

shell.nix

@@ -1,5 +1,6 @@
 { pkgs ? import <nixpkgs> {}
-, crossPkgs ? import <nixpkgs> {}
+, crossPkgs ? null         # null means same as pkgs; overrides windows when set explicitly
+, windows ? false          # Cross-compile for Windows using MinGW; implies crossPkgs = pkgs.pkgsCross.mingwW64
 , enableLibcxx ? false # Whether to use libc++ toolchain and libraries instead of libstdc++
 , minimal ? false # Whether to create minimal shell without extra tools (faster when cross compiling)
 , capnprotoVersion ? null
@@ -11,7 +12,11 @@
 
 let
   lib  = pkgs.lib;
-  llvmBase = crossPkgs.llvmPackages_21;
+  effectiveCrossPkgs =
+    if crossPkgs != null then crossPkgs
+    else if windows then pkgs.pkgsCross.mingwW64
+    else pkgs;
+  llvmBase = pkgs.llvmPackages_21;
   llvm = llvmBase // lib.optionalAttrs (libcxxSanitizers != null) {
     libcxx = llvmBase.libcxx.override {
       devExtraCmakeFlags = [ "-DLLVM_USE_SANITIZER=${libcxxSanitizers}" ];
@@ -27,9 +32,9 @@ let
     "1.1.0" = "sha256-gxkko7LFyJNlxpTS+CWOd/p9x/778/kNIXfpDGiKM2A=";
     "1.2.0" = "sha256-aDcn4bLZGq8915/NPPQsN5Jv8FRWd8cAspkG3078psc=";
   };
-  capnprotoBase = if capnprotoVersion == null then crossPkgs.capnproto else crossPkgs.capnproto.overrideAttrs (old: {
+  capnprotoBase = if capnprotoVersion == null then effectiveCrossPkgs.capnproto else effectiveCrossPkgs.capnproto.overrideAttrs (old: {
     version = capnprotoVersion;
-    src = crossPkgs.fetchFromGitHub {
+    src = effectiveCrossPkgs.fetchFromGitHub {
       owner = "capnproto";
       repo  = "capnproto";
       rev   = "v${capnprotoVersion}";
@@ -50,7 +55,50 @@ let
           "-g"
         ];
     };
-  })).override (lib.optionalAttrs enableLibcxx { clangStdenv = llvm.libcxxStdenv; });
+  } // lib.optionalAttrs windows {
+    # Two CXXFLAGS additions needed for the MinGW cross-build:
+    # - _WIN32_WINNT=0x0601: mcfgthread/fwd.h hard-errors if this isn't defined
+    #   to at least Windows 7; it's pulled in transitively via <atomic> → gthr.h.
+    # - Wno-class-memaccess: GCC promotes this to an error on the memset(&addr,0,…)
+    #   call in kj/async-io-win32.c++; the memset intentionally zeroes a network
+    #   address struct, so the warning is a false positive here.
+    env = (old.env or { }) // {
+      CXXFLAGS = "${old.env.CXXFLAGS or ""} -D_WIN32_WINNT=0x0601 -Wno-class-memaccess";
+    };
+    # Cross-compiling capnproto for Windows with the nixpkgs llvm-mingw toolchain
+    # requires several cmake/nix workarounds:
+    #
+    # - BUILD_SHARED_LIBS=FALSE: static libs mean mptest.exe is self-contained,
+    #   simplifying wine execution (no DLL search path needed).
+    # - WITH_FIBERS=FALSE: kj fiber support on Windows/MinGW may not build.
+    #
+    # Two nix environment issues also need fixing:
+    # 1. The clang wrapper uses GCC's C++ headers (libstdc++), which on this
+    #    GCC version use the MCF thread model.  MCF headers are in a separate
+    #    package (windows.mcfgthreads.dev) not in capnproto's default buildInputs.
+    # 2. The clang wrapper's cc-ldflags is missing the GCC target lib directory
+    #    that contains libgcc_s.a.  We add it in preConfigure.
+    buildInputs = (old.buildInputs or []) ++ [
+      effectiveCrossPkgs.windows.mcfgthreads.dev  # provides mcfgthread/gthr.h
+      effectiveCrossPkgs.windows.mcfgthreads      # provides libmcfgthread.a for linking
+    ];
+    preConfigure = (old.preConfigure or "") + ''
+      # The nixpkgs clang-mingw wrapper omits the GCC target lib directory
+      # ($gcc/x86_64-w64-mingw32/lib) from its search path, so the linker
+      # can't find libgcc_s.a even though the file exists.  Add it explicitly.
+      # Must use 'export' so child processes (cmake, linker) inherit the value.
+      export NIX_LDFLAGS_x86_64_w64_mingw32="''${NIX_LDFLAGS_x86_64_w64_mingw32:-} -L${effectiveCrossPkgs.buildPackages.gcc.cc}/x86_64-w64-mingw32/lib"
+    '';
+    cmakeFlags = (old.cmakeFlags or []) ++ [
+      "-DBUILD_SHARED_LIBS=FALSE"
+      "-DWITH_FIBERS=FALSE"
+    ];
+  })).override (lib.optionalAttrs enableLibcxx { clangStdenv = llvm.libcxxStdenv; }
+             # Switch capnproto's cross-build to effectiveCrossPkgs.stdenv (GCC) instead of
+             # the default clangStdenv. Clang with GCC's libstdc++.a causes MCF thread
+             # symbol errors (_MCF_mutex_lock_slow etc.) because clang doesn't automatically
+             # link GCC's MCF runtime. GCC knows its own runtime and links it correctly.
+             // lib.optionalAttrs windows    { clangStdenv = effectiveCrossPkgs.stdenv; });
   clang = if enableLibcxx then llvm.libcxxClang else llvm.clang;
   clang-tools = llvm.clang-tools.override { inherit enableLibcxx; };
   cmakeHashes = {
@@ -67,7 +115,7 @@ let
     };
     patches = [];
   })).override { isMinimalBuild = true; };
-in crossPkgs.mkShell {
+in effectiveCrossPkgs.mkShell {
   buildInputs = lib.optionals (capnprotoVersion != "none") [
     capnproto
   ];
@@ -79,6 +127,14 @@ in crossPkgs.mkShell {
   ] ++ lib.optional (gcc != null) gcc ++ lib.optionals (!minimal) [
     clang
     clang-tools
+  ] ++ lib.optionals windows [
+    pkgs.capnproto             # native capnp + capnpc-c++ in PATH for cmake code generation
+    pkgs.wine64Packages.staging # run cross-compiled mptest.exe in ctest
+    pkgs.gcc                   # native C++ compiler for the native mpgen pre-build
+    pkgs.openssl.dev           # native capnproto cmake config: find_dependency(OpenSSL) headers
+    pkgs.openssl.out           # native capnproto cmake config: find_dependency(OpenSSL) libs
+    pkgs.zlib.dev              # native capnproto cmake config: find_dependency(ZLIB) headers
+    pkgs.zlib                  # native capnproto cmake config: find_dependency(ZLIB) libs
   ];
 
   CC = if gcc == null then null else "${gcc}/bin/gcc";
@@ -89,4 +145,22 @@ in crossPkgs.mkShell {
 
   # Avoid "SSL certificate problem: unable to get local issuer certificate" error during git clone in ci/scripts/ci.sh
   NIX_SSL_CERT_FILE = "${pkgs.cacert}/etc/ssl/certs/ca-bundle.crt";
+
+  # When cross-compiling, expose native package prefixes so ci.sh can point
+  # the native mpgen pre-build's CMAKE_PREFIX_PATH at them.  CMAKE_PREFIX_PATH
+  # in the cross shell points at the Windows packages, not the native ones.
+  NATIVE_CAPNPROTO_PREFIX = if windows then "${pkgs.capnproto}" else null;
+  # OpenSSL and zlib are dependencies of the native capnproto cmake config
+  # (find_dependency calls); the native cmake build needs to find them too.
+  # FindOpenSSL.cmake needs both the dev output (headers) and out (libs).
+  NATIVE_OPENSSL_DEV = if windows then "${pkgs.openssl.dev}" else null;
+  NATIVE_OPENSSL_LIB = if windows then "${pkgs.openssl.out}" else null;
+  NATIVE_ZLIB_DEV    = if windows then "${pkgs.zlib.dev}" else null;
+  NATIVE_ZLIB_LIB    = if windows then "${pkgs.zlib}" else null;
+  # GCC and MCF thread runtime DLL directories needed by wine to run mptest.exe.
+  # libstdc++-6.dll and libgcc_s_seh-1.dll are in the GCC cross-compiler lib dir;
+  # libmcfgthread-2.dll is in the mcfgthreads package's bin dir.
+  WIN_RUNTIME_DLLS = if windows then
+    "${effectiveCrossPkgs.buildPackages.gcc.cc.lib}/x86_64-w64-mingw32/lib:${effectiveCrossPkgs.windows.mcfgthreads}/bin"
+    else null;
 }