From c0809c9b68ad33b9963ff3da1a6ad53ca2c8b6f3 Mon Sep 17 00:00:00 2001
From: Andrew Kelley <andrew@ziglang.org>
Date: Sat, 27 Dec 2025 11:07:28 -0800
Subject: std: add more timespec OMIT and NOW definitions

---
 lib/std/c.zig        | 36 ++++++++++++++++++++++++++++++++++++
 lib/std/os/linux.zig | 12 ++++++++++++
 2 files changed, 48 insertions(+)

(limited to 'lib/std')

diff --git a/lib/std/c.zig b/lib/std/c.zig
index fdd544cba9..2a7579f260 100644
--- a/lib/std/c.zig
+++ b/lib/std/c.zig
@@ -114,6 +114,18 @@ pub const timespec = switch (native_os) {
             return @as(wasi.timestamp_t, @intCast(ts.sec * 1_000_000_000)) +
                 @as(wasi.timestamp_t, @intCast(ts.nsec));
         }
+
+        /// For use with `utimensat` and `futimens`.
+        pub const NOW: timespec = .{
+            .sec = 0,
+            .nsec = 0x3fffffff,
+        };
+
+        /// For use with `utimensat` and `futimens`.
+        pub const OMIT: timespec = .{
+            .sec = 0,
+            .nsec = 0x3ffffffe,
+        };
     },
     // https://github.com/SerenityOS/serenity/blob/0a78056453578c18e0a04a0b45ebfb1c96d59005/Kernel/API/POSIX/time.h#L17-L20
     .windows, .serenity => extern struct {
@@ -123,10 +135,34 @@ pub const timespec = switch (native_os) {
     .dragonfly, .freebsd, .driverkit, .ios, .maccatalyst, .macos, .tvos, .visionos, .watchos => extern struct {
         sec: isize,
         nsec: isize,
+
+        /// For use with `utimensat` and `futimens`.
+        pub const NOW: timespec = .{
+            .sec = 0,
+            .nsec = -1,
+        };
+
+        /// For use with `utimensat` and `futimens`.
+        pub const OMIT: timespec = .{
+            .sec = 0,
+            .nsec = -2,
+        };
     },
     .netbsd, .illumos => extern struct {
         sec: i64,
         nsec: isize,
+
+        /// For use with `utimensat` and `futimens`.
+        pub const NOW: timespec = .{
+            .sec = 0,
+            .nsec = 0x3fffffff,
+        };
+
+        /// For use with `utimensat` and `futimens`.
+        pub const OMIT: timespec = .{
+            .sec = 0,
+            .nsec = 0x3ffffffe,
+        };
     },
     .openbsd, .haiku => extern struct {
         sec: time_t,
diff --git a/lib/std/os/linux.zig b/lib/std/os/linux.zig
index fb08830fcc..174ef64d95 100644
--- a/lib/std/os/linux.zig
+++ b/lib/std/os/linux.zig
@@ -8417,6 +8417,18 @@ pub const timezone = extern struct {
 pub const kernel_timespec = extern struct {
     sec: i64,
     nsec: i64,
+
+    /// For use with `utimensat` and `futimens`.
+    pub const NOW: timespec = .{
+        .sec = 0,
+        .nsec = 0x3fffffff,
+    };
+
+    /// For use with `utimensat` and `futimens`.
+    pub const OMIT: timespec = .{
+        .sec = 0,
+        .nsec = 0x3ffffffe,
+    };
 };
 
 // https://github.com/ziglang/zig/issues/4726#issuecomment-2190337877
-- 
cgit v1.2.3