Commit 4428d52ea145ed0f14af2e39569026c2a708e547 | zig

author	Andrew Kelley <andrew@ziglang.org> 2026-10-12 13:30:02-07:00
committer	Alex Rønne Petersen <alex@alexrp.com> 2026-10-14 21:08:26+02:00
log	4428d52ea145ed0f14af2e39569026c2a708e547
tree	e7a7dac17992fe0e8b906a27c4cd19486798a5d9
parent	77aa4155ea62fa88895ddcc566ed99d0d7031c55
signature	Signed by SSH key SHA256:7B/LJ7bpR1eX8aCXSr4mtd5M45VMPKcx9zY8e95b5QM

std.Io.Threaded: handle unsupported renamePreserveLinux

with link/unlink fallback. closes #31960

2 files changed, 18 insertions(+), 4 deletions(-)

lib
- std
  - Io
    Dir.zig
    Threaded.zig

lib/std/Io/Dir.zig+7-2

 @@ -1122,8 +1122,7 @@ pub const RenamePreserveError = error{
     /// policy of the current thread or process disallows dataless directory materialization.
     AccessDenied,
     PathAlreadyExists,
-    /// Operating system or file system does not support atomic nonreplacing
+    /// Operating system or file system does not support atomic nonreplacing rename.
-    /// rename.
     OperationUnsupported,
 } || RenameError;
 @@ -1131,6 +1130,12 @@ pub const RenamePreserveError = error{
 ///
 /// If `new_sub_path` already exists, `error.PathAlreadyExists` will be returned.
 ///
+/// If the operating system supports it, the entire operation will be done atomically. If unsupported, will
+/// fall back to hard link followed by unlink, which is atomic with respect to `new_sub_path` but leaves a
+/// window where the cleanup of `old_sub_path may fail. Although the operation is fairly portable, technically
+/// this fallback, too, may be unsupported in some environments, in which case `error.OperationUnsupported` is
+/// returned.
+///
 /// * On Windows, both paths should be encoded as [WTF-8](https://wtf-8.codeberg.page/).
 /// * On WASI, both paths should be encoded as valid UTF-8.
 /// * On other platforms, both paths are an opaque sequence of bytes with no particular encoding.

lib/std/Io/Threaded.zig+11-2

 @@ -7734,7 +7734,14 @@ fn dirRenamePreserve(
     const t: *Threaded = @ptrCast(@alignCast(userdata));
     if (is_windows) return dirRenameWindowsInner(old_dir, old_sub_path, new_dir, new_sub_path, false);
     if (is_darwin) return dirRenamePreserveDarwin(old_dir, old_sub_path, new_dir, new_sub_path);
-    if (native_os == .linux) return dirRenamePreserveLinux(old_dir, old_sub_path, new_dir, new_sub_path);
+    if (native_os == .linux) {
+        if (dirRenamePreserveLinux(old_dir, old_sub_path, new_dir, new_sub_path)) |_| {
+            return;
+        } else |err| switch (err) {
+            else => |e| return e,
+            error.OperationUnsupported => {}, // Fall back to link/unlink below.
+        }
+    }
     // Make a hard link then delete the original.
     try dirHardLink(t, old_dir, old_sub_path, new_dir, new_sub_path, .{ .follow_symlinks = false });
     const prev = swapCancelProtection(t, .blocked);
 @@ -8062,8 +8069,10 @@ fn dirRenamePreserveLinux(
         .ROFS => return syscall.fail(error.ReadOnlyFileSystem),
         .XDEV => return syscall.fail(error.CrossDevice),
         .ILSEQ => return syscall.fail(error.BadPathName),
+        // EINVAL when passing NOREPLACE=true observed on ext4, 7.0.0-38-generic #38~24.04.4-Ubuntu.
+        // OPNOTSUPP handled defensively.
+        .INVAL, .OPNOTSUPP => return syscall.fail(error.OperationUnsupported),
         .FAULT => |err| return syscall.errnoBug(err),
-        .INVAL => return syscall.fail(error.OperationUnsupported),
         else => |err| return syscall.unexpectedErrno(err),
     };
 }