First stage of Mingw build support (#171). What remains is to replace

signal_guard in quickcpplib, as it'll never be mingw compatible.

Author: ned14

.github/workflows/unittests_windows.yml

@@ -26,43 +26,77 @@ jobs:
       id: vars
       shell: bash
       run: |
-       if [ "${{ matrix.image }}" = "windows-2025" ]; then
-         NAME=VS2025;
-         GENERATOR="Visual Studio 18 2025";
-       else
-         NAME=VS2022;
-         GENERATOR="Visual Studio 17 2022";
-       fi
-       echo ::set-output name=NAME::${NAME}
-       echo ::set-output name=GENERATOR::${GENERATOR}
+        if [ "${{ matrix.image }}" = "windows-2025" ]; then
+          NAME=VS2025;
+          GENERATOR="Visual Studio 18 2025";
+        else
+          NAME=VS2022;
+          GENERATOR="Visual Studio 17 2022";
+        fi
+        echo ::set-output name=NAME::${NAME}
+        echo ::set-output name=GENERATOR::${GENERATOR}
 
-          
+           
     - name: CMake tests Windows
       shell: bash
       env:
         NAME: ${{ steps.vars.outputs.NAME }}-${{ matrix.configuration }}
       run: |
-       if [ "${{ matrix.configuration }}" = "status_code" ]; then
-         export CMAKE_CONFIGURE_OPTIONS="-DLLFIO_USE_EXPERIMENTAL_SG14_STATUS_CODE=ON"
-       fi
-       ctest -S .ci.cmake -VV --timeout 900 "-DCTEST_CONFIGURE_OPTIONS=$CMAKE_CONFIGURE_OPTIONS" -DCTEST_SITE=$NAME -DCTEST_CMAKE_GENERATOR="${{ steps.vars.outputs.GENERATOR }}"
-      
+        if [ "${{ matrix.configuration }}" = "status_code" ]; then
+          export CMAKE_CONFIGURE_OPTIONS="-DLLFIO_USE_EXPERIMENTAL_SG14_STATUS_CODE=ON"
+        fi
+        ctest -S .ci.cmake -VV --timeout 900 "-DCTEST_CONFIGURE_OPTIONS=$CMAKE_CONFIGURE_OPTIONS" -DCTEST_SITE=$NAME -DCTEST_CMAKE_GENERATOR="${{ steps.vars.outputs.GENERATOR }}"
+       
     - name: Upload Prebuilt Binaries
       uses: actions/upload-artifact@v4
       with:
         name: Windows ${{ steps.vars.outputs.NAME }} ${{ matrix.configuration }} prebuilt binaries
         path: llfio-v2.0-binaries-win64.zip
-      
+     
     - name: Upload Test Results
       if: always()
       uses: actions/upload-artifact@v4
       with:
         name: Windows ${{ steps.vars.outputs.NAME }} ${{ matrix.configuration }} test results
         path: prebuilt/merged_junit_results.xml
 
+  WinMinGW:
+    name: MinGW-MSYS2
+    strategy:
+      fail-fast: false
+      matrix:
+        configuration: [error_code, status_code]
+    runs-on: windows-latest
+
+    steps:
+    - uses: msys2/setup-msys2@v2
+      with:
+        msystem: MINGW64
+        update: true
+        install: mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja
+
+    - uses: actions/checkout@v4
+
+    - name: CMake tests Windows
+      shell: msys2 {0}
+      env:
+        NAME: MinGW-${{ matrix.configuration }}
+      run: |
+        if [ "${{ matrix.configuration }}" = "status_code" ]; then
+          export CMAKE_CONFIGURE_OPTIONS="-DLLFIO_USE_EXPERIMENTAL_SG14_STATUS_CODE=ON"
+        fi
+        ctest -S .ci.cmake -VV --timeout 900 "-DCTEST_CONFIGURE_OPTIONS=$CMAKE_CONFIGURE_OPTIONS" -DCTEST_SITE=$NAME -DCTEST_CMAKE_GENERATOR=Ninja
+       
+    - name: Upload Test Results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: Windows MinGW ${{ matrix.configuration }} test results
+        path: prebuilt/merged_junit_results.xml
+
   publish-test-results:
     name: "Publish Unit Tests Results"
-    needs: [WinVS2022]
+    needs: [WinVS2022, WinMinGW]
     runs-on: ubuntu-latest
     if: success() || failure()
 

AGENTS.md

@@ -0,0 +1,12 @@
+# Agentic coding guidelines
+
+The main git repository for this project is at https://github.com/ned14/llfio.
+
+1. All source, header and test files MUST be kept compatible with the 2017
+ISO C++ standard. Where using a latest ISO C++ standard feature would make
+sense, try to use the existing preprocessor macro infrastructure where
+possible. Otherwise ask for direction on what to do.
+2. Run `clang-format` on every changed header and source file. Do NOT run
+`clang-format` on cmake files.
+3. When building and testing, extract what to do for the current platform
+from `.github/workflows/unittests_*.yml`.

Build.md

@@ -6,6 +6,7 @@ These compilers and OSs are regularly tested by CI:
 - [Clang](https://clang.llvm.org/) on Linux
 - Xcode on Mac OS
 - Visual Studio on Windows
+- MinGW on Windows (note that you'll get lots of warnings)
 
 Other compilers, architectures and OSs may work, but are not tested regularly.
 You will need a working Filesystem implementation in your STL, and at least C++ 17.

cmake/toolchain-windows-mingw.cmake

@@ -0,0 +1,9 @@
+set(CMAKE_SYSTEM_NAME Windows)
+set(CMAKE_SYSTEM_PROCESSOR x86_64)
+set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
+set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
+set(CMAKE_CXX_FLAGS_INIT "-DLLFIO_DISABLE_SIGNAL_GUARD=1")  ## temporary
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+set(CXX_HAS_CXX17_FILESYSTEM_EXITCODE 0)

doc/html

@@ -1,4 +1,4 @@
 // Note the second line of this file must ALWAYS be the git SHA, third line ALWAYS the git SHA update time
-#define LLFIO_PREVIOUS_COMMIT_REF    aa1077c18f704607a40417ba3b10b424c66fde3d
-#define LLFIO_PREVIOUS_COMMIT_DATE   "2025-12-17 17:13:08 +00:00"
-#define LLFIO_PREVIOUS_COMMIT_UNIQUE aa1077c1
+#define LLFIO_PREVIOUS_COMMIT_REF    b3c9308f143e27161c40f6d52a8fd18e8f05761b
+#define LLFIO_PREVIOUS_COMMIT_DATE   "2026-01-18 17:53:09 +00:00"
+#define LLFIO_PREVIOUS_COMMIT_UNIQUE b3c9308f

include/llfio/ntkernel-error-category

@@ -1,5 +1,5 @@
 /* A handle to something
-(C) 2015-2021 Niall Douglas <http://www.nedproductions.biz/> (11 commits)
+(C) 2015-2026 Niall Douglas <http://www.nedproductions.biz/> (11 commits)
 File Created: Dec 2015
 
 
@@ -25,9 +25,6 @@ Distributed under the Boost Software License, Version 1.0.
 #include "../../../byte_io_handle.hpp"
 #include "import.hpp"
 
-#include <WinSock2.h>
-#include <ws2ipdef.h>
-
 LLFIO_V2_NAMESPACE_BEGIN
 
 size_t byte_io_handle::_do_max_buffers() const noexcept
@@ -46,7 +43,8 @@ size_t byte_io_handle::_do_max_buffers() const noexcept
 }
 
 template <class BuffersType>
-inline bool do_cancel(const native_handle_type &nativeh, span<windows_nt_kernel::IO_STATUS_BLOCK> ols, byte_io_handle::io_request<BuffersType> reqs) noexcept
+inline bool do_cancel(const native_handle_type &nativeh, span<windows_nt_kernel::IO_STATUS_BLOCK> ols,
+                      byte_io_handle::io_request<BuffersType> reqs) noexcept
 {
   using namespace windows_nt_kernel;
   using EIOSB = windows_nt_kernel::IO_STATUS_BLOCK;
@@ -75,8 +73,9 @@ inline bool do_cancel(const native_handle_type &nativeh, span<windows_nt_kernel:
 
 // Returns true if operation completed immediately
 template <bool blocking, class Syscall, class BuffersType>
-inline bool do_read_write(byte_io_handle::io_result<BuffersType> &ret, Syscall &&syscall, const native_handle_type &nativeh,
-                          span<windows_nt_kernel::IO_STATUS_BLOCK> ols, byte_io_handle::io_request<BuffersType> reqs, deadline d) noexcept
+inline bool do_read_write(byte_io_handle::io_result<BuffersType> &ret, Syscall &&syscall,
+                          const native_handle_type &nativeh, span<windows_nt_kernel::IO_STATUS_BLOCK> ols,
+                          byte_io_handle::io_request<BuffersType> reqs, deadline d) noexcept
 {
   using namespace windows_nt_kernel;
   using EIOSB = windows_nt_kernel::IO_STATUS_BLOCK;
@@ -130,7 +129,8 @@ inline bool do_read_write(byte_io_handle::io_result<BuffersType> &ret, Syscall &
 #endif
     reqs.offset += req.size();
     ol.Status = 0x103 /*STATUS_PENDING*/;
-    NTSTATUS ntstat = syscall(nativeh.h, nullptr, nullptr, nullptr, &ol, (PVOID) req.data(), static_cast<DWORD>(req.size()), &offset, nullptr);
+    NTSTATUS ntstat = syscall(nativeh.h, nullptr, nullptr, nullptr, &ol, (PVOID) req.data(),
+                              static_cast<DWORD>(req.size()), &offset, nullptr);
     if(ntstat < 0 && ntstat != 0x103 /*STATUS_PENDING*/)
     {
       InterlockedCompareExchange(&ol.Status, ntstat, 0x103 /*STATUS_PENDING*/);
@@ -191,8 +191,8 @@ inline bool do_read_write(byte_io_handle::io_result<BuffersType> &ret, Syscall &
   return true;
 }
 
-byte_io_handle::io_result<byte_io_handle::buffers_type> byte_io_handle::_do_read(byte_io_handle::io_request<byte_io_handle::buffers_type> reqs,
-                                                                                 deadline d) noexcept
+byte_io_handle::io_result<byte_io_handle::buffers_type>
+byte_io_handle::_do_read(byte_io_handle::io_request<byte_io_handle::buffers_type> reqs, deadline d) noexcept
 {
   windows_nt_kernel::init();
   using namespace windows_nt_kernel;
@@ -216,8 +216,8 @@ byte_io_handle::io_result<byte_io_handle::buffers_type> byte_io_handle::_do_read
   return ret;
 }
 
-byte_io_handle::io_result<byte_io_handle::const_buffers_type> byte_io_handle::_do_write(byte_io_handle::io_request<byte_io_handle::const_buffers_type> reqs,
-                                                                                        deadline d) noexcept
+byte_io_handle::io_result<byte_io_handle::const_buffers_type>
+byte_io_handle::_do_write(byte_io_handle::io_request<byte_io_handle::const_buffers_type> reqs, deadline d) noexcept
 {
   windows_nt_kernel::init();
   using namespace windows_nt_kernel;
@@ -241,8 +241,9 @@ byte_io_handle::io_result<byte_io_handle::const_buffers_type> byte_io_handle::_d
   return ret;
 }
 
-byte_io_handle::io_result<byte_io_handle::const_buffers_type> byte_io_handle::_do_barrier(byte_io_handle::io_request<byte_io_handle::const_buffers_type> reqs,
-                                                                                          barrier_kind kind, deadline d) noexcept
+byte_io_handle::io_result<byte_io_handle::const_buffers_type>
+byte_io_handle::_do_barrier(byte_io_handle::io_request<byte_io_handle::const_buffers_type> reqs, barrier_kind kind,
+                            deadline d) noexcept
 {
   windows_nt_kernel::init();
   using namespace windows_nt_kernel;