From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.128.43 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793498244; b=hAci3nkPXOo3nrkA3upYKWFso/+9B8/mgE72lkzsZ+d0CzUD4UNWxRTAvnDOo4B+t08f OReseI39wUm533tUy7j3UT0a287u32YdzRHaen/iT85ZWiTfDbrAH83vYuwWZ12SDoupo qUUontZpfUZyGcFPe/sFVyC45rOPt7sPSpm/glzIpNBGqPBrCzq08iEsn2+uY82T0OMVt OijQPvcdoTT6lYJxV5fd5W0O1PV2nArIoA2uToq+8BklQI1Kpi+THCd+MHSCEiVM4Rdda y9TebpFq13Ta9AsHFfSXNQbNeNlr+vXuhdN+eEdoqO+3TAJB8eS8p0ZmyOYlqqbw5Eg== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793498244; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Forwarded-Encrypted:X-Gm-Message-State:X-Gm-Gg:X-Received:Received: From:To:Cc:Subject:Date:Message-ID:X-Mailer:In-Reply-To:References: MIME-Version:Content-Transfer-Encoding; bh=HjxZWeiY3BNoKLFLjn9gfnGpTfHowaS1Ix4espIgNNc=; b=RfMyNr9aIPtjxPROqzP/tulq0OkEXWUxcowmNXBhcBb7r+JUKQwXuekkFdS/Ajo3vghp R1fZRH/CyK+/3NtjTSuA/BKqTcVO2mXiBP9V5nU+w0HDGYhqiJ/Qj35EJtk3rZa69eCXN R/zU3Gxhu9WBgtUXoZXcPppoeabnJ8MXOj0vJJ7cdf/DWbW/HxT+9wRAXy0kkhAoqcCZ1 cx4igVq1VqnkWSXzRx98fnBNIj8Bi017m0D4KvF8vZCRj75NSO9zcUSlc2BWTUc99DWQK VwtyYJeUTP+Zk8kk73xhkWZc4AHEImQ95IUMpFK/PTK0X0buD0CS77JwFO87f/LMdfQ== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=E6U1aYpw; arc=none smtp.remote-ip=209.85.128.43 Received: from mail-wm1-f43.google.com (mail-wm1-f43.google.com [209.85.128.43]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DF98060A2604 for ; Sun, 1 Nov 2026 01:57:23 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org DF98060A2604 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=E6U1aYpw Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-4a2084d62cdso16770865e9.1 for ; Sat, 31 Oct 2026 18:57:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20260707; t=1793498242; x=1794103042; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=HjxZWeiY3BNoKLFLjn9gfnGpTfHowaS1Ix4espIgNNc=; b=E6U1aYpw3eifXJWi/HI54PDUOjXJwFSKQwOxY5GtSo71wT73Gy6pzoeeoVFSQWZ/7B 3fPct60jWxxCuDYzUnvtpXIxUjHj8FdBOLXuO13qds94Z3cNr5tXMet8DSQFOA/m3zPf eeqU8cst1mUCVtwdkSGJ5yzvt5Pqriqu/Me3dzck7L2/D46HlQFnXyuv9jEjHfXcRKTx kTpxe3JntdV6yxcGBm1DYHQLakOJyrnnjV0V5hGllH8CyaS8M13PgxfkK8fP9rK7cFlB AChF2tEHoAEU3WefLHmXQePfBXyA8dJ7+DZKdwqRibs4j9mxt8lA4hcARjqHk6KLU5Jl eiIQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1793498242; x=1794103042; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=HjxZWeiY3BNoKLFLjn9gfnGpTfHowaS1Ix4espIgNNc=; b=D0Rvy0wEU8oQ2FcXngpiF6d0O8YLeClBrVbciDsYCu0tPkcJ5ZItzKt3uF891A0A/2 zYCKx03wRN+3S+PjixgIWtLhAEuOekVeo87W2cbfMLIYVz99tSq0W8A6sn0U2BWxbMpy SGrqQ89mHH2GoVrJgUj0QqfkERZiyGr1ZDH4Ra7YVFCbmh7na1dPwhdQRUNXR1JdkvRI jiZRZQOFw0W8ydbhEc1SBVDpUg8sJ2BfwxHT0Qvbdm85zweMQSA1I0mbHokwkW5iDVUP eHGJSKhWBSZSg2sKQGz/qUezHSn2jKRA8s88+8xywyDVuOnx1UboRWxqKXtH4cZqbG1r +i3g== X-Forwarded-Encrypted: i=1; AKwUvBx1drCJg/TwSF96vhd7mbV+QD29/2v89q8vYf0drpJIULdD7PGjETuOW5CpAcOTdJEw2lrhH6Ww+iA=@vger.kernel.org X-Gm-Message-State: AFq9FYJp+bl49ipebDa2dW9QwHwFAD5jSX8ABEnWYAfIBIKTPnOcCKkI zeDcn+bfXsOOjIumqfdLXtY8C3RsAAXRly+oi8IX8AyOFQA+IIZYjiqP X-Gm-Gg: AYBFou0WCa1gU8jnDE+iCfpQ0aT7fFgMAqJBJtGaJ0D0Vnowme0L7vfzx/k6RpQWGWC XiKmGhS4kh3w8zhV25Gt8QQ9FsTU4ap2GSfA9DNRGYGo5qtZ8nzyi5eViV6Ooqb8+Ccv5nT0ztP RQ30HNNSeOJlJDm64CvwrkjTWtknUYdS1PkeoqBzy9sGIngqo/tNK4nispHXLmt8loL/CEakj/K UKoexpECCVMETGM595jOnTJJ2HR/qMKVPeuWs/v5Rdh38lFVHk8ceqmKaImsVzWUUDownPp9kP1 kr52k+26JpVj0qUN1Cn/gNRsGJp6ZZHTsP8g2y+C0bV9fuP629xrD/ws1f7JUHDfVurXC/2IMZB tMPaCWwDK/4cMlNJkgIdO0dhkKigWaN7sgYEZISAFfKl11CzbGWLOXDI9Tu6OOrM+GxWdEklQDn QMyT64cDQuhnLmOLirt/wisz2NpN8qljhGpnVXM9ZERlklcd5xYs2kCpHcvh3QBhJcGRcfSeOa1 NaJnxmomi8KC3K6fROt4NldwDa0AxZH3v7mDtfT8ZbcJkvXl9cw1/EVAxcX69RfwPgdpA2QaAU7 U8w4VrL7vcBy2Yy7iMmpa5lI X-Received: by 2002:a05:600c:3f0f:b0:4a2:1612:636e with SMTP id 5b1f17b1804b1-4ac16bc4645mr143132385e9.5.1793498242131; Sat, 31 Oct 2026 18:57:22 -0700 (PDT) Received: from infinity ([2001:b07:5d26:7a6a:365a:60ff:fe0d:cfc6]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4aa81b7fe80sm273532835e9.11.2026.10.31.18.57.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 31 Oct 2026 18:57:21 -0700 (PDT) From: koraynilay To: David Sterba , Alexander Viro , Christian Brauner , Namjae Jeon , Sungjong Seo , Konstantin Komarov Cc: Chris Mason , Jan Kara , Yuezhang Mo , Chuck Lever , "Darrick J . Wong" , Sean Smith , Andrey Albershteyn , Pedro Falcato , Amir Goldstein , =?UTF-8?q?Pali=20Roh=C3=A1r?= , linux-btrfs@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, exfat@lists.linux.dev, ntfs3@lists.linux.dev, linux-api@vger.kernel.org, koraynilay Subject: [RFC PATCH v3 1/5] vfs: add provenance time (ptime) Date: Sun, 1 Nov 2026 02:55:47 +0100 Message-ID: <20261101015551.786044-2-koray.fra@gmail.com> X-Mailer: git-send-email 2.56.0 In-Reply-To: <20261101015551.786044-1-koray.fra@gmail.com> References: <20261101015551.786044-1-koray.fra@gmail.com> X-Mailing-List: linux-api@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add provenance time (ptime), indicating the time when a file or directory was created. This is user-settable via file_setattr() and retrievable via statx(2) (using STATX_PTIME) or file_getattr(). The semantics of when to preserve this new timestamp are the same as mtime, the idea being that there is a correspondence like this: ctime <-> btime mtime <-> ptime so every operation (copying, moving, ...) that currently preserves mtime should also preserve ptime. Furthermore, in order to avoid the legacy FS_IOC_FSSETXATTR accepting FS_XFLAG_PTIME, add an FS_FILE_ATTR_XFLAGS_MASK mask to support new xflags, and use it in fileattr_to_file_attr()/file_attr_to_fileattr() to allow ptime to be used with the file_setattr()/file_getattr() syscalls. [ This is a re-implementation of the initial patch[1] by Sean Smith , following the advice[2] from Darrick J. Wong of using file_setattr() instead of updating utimensat() ] [1]: https://lore.kernel.org/20260405195007.1306-2-DefendTheDisabled@gmail.com [2]: https://lore.kernel.org/20260407014129.GC6192@frogsfrogsfrogs Assisted-by: Gemini:3.8-flash-high antigravity-cli-1.4.7 Signed-off-by: koraynilay --- fs/file_attr.c | 33 +++++++++++++++++++++++++++++++-- fs/stat.c | 2 ++ include/linux/fileattr.h | 5 +++++ include/linux/stat.h | 1 + include/uapi/linux/fs.h | 8 +++++++- include/uapi/linux/stat.h | 7 ++++++- 6 files changed, 52 insertions(+), 4 deletions(-) diff --git a/fs/file_attr.c b/fs/file_attr.c index 833e03810b24..c0645cb22bf3 100644 --- a/fs/file_attr.c +++ b/fs/file_attr.c @@ -102,7 +102,7 @@ EXPORT_SYMBOL(vfs_fileattr_get); static void fileattr_to_file_attr(const struct file_kattr *fa, struct file_attr *fattr) { - __u32 mask = FS_XFLAGS_MASK; + __u32 mask = FS_FILE_ATTR_XFLAGS_MASK; memset(fattr, 0, sizeof(struct file_attr)); fattr->fa_xflags = fa->fsx_xflags & mask; @@ -110,6 +110,8 @@ static void fileattr_to_file_attr(const struct file_kattr *fa, fattr->fa_nextents = fa->fsx_nextents; fattr->fa_projid = fa->fsx_projid; fattr->fa_cowextsize = fa->fsx_cowextsize; + fattr->fa_ptime_sec = fa->fsx_ptime.tv_sec; + fattr->fa_ptime_nsec = fa->fsx_ptime.tv_nsec; } /** @@ -141,15 +143,20 @@ EXPORT_SYMBOL(copy_fsxattr_to_user); static int file_attr_to_fileattr(const struct file_attr *fattr, struct file_kattr *fa) { - __u64 mask = FS_XFLAGS_MASK; + __u64 mask = FS_FILE_ATTR_XFLAGS_MASK; if (fattr->fa_xflags & ~mask) return -EINVAL; + if (fattr->fa_pad != 0) + return -EINVAL; + fileattr_fill_xflags(fa, fattr->fa_xflags & ~FS_XFLAG_RDONLY_MASK); fa->fsx_extsize = fattr->fa_extsize; fa->fsx_projid = fattr->fa_projid; fa->fsx_cowextsize = fattr->fa_cowextsize; + fa->fsx_ptime.tv_sec = fattr->fa_ptime_sec; + fa->fsx_ptime.tv_nsec = fattr->fa_ptime_nsec; return 0; } @@ -232,6 +239,20 @@ static int fileattr_set_prepare(struct inode *inode, !S_ISREG(inode->i_mode) && !S_ISDIR(inode->i_mode)) return -EINVAL; + if (fa->fsx_xflags & FS_XFLAG_PTIME) { + if (!(old_ma->fsx_xflags & FS_XFLAG_PTIME)) + return -EOPNOTSUPP; + + if ((unsigned long)fa->fsx_ptime.tv_nsec >= NSEC_PER_SEC) + return -EINVAL; + + fa->fsx_ptime = timestamp_truncate(fa->fsx_ptime, inode); + + if (!timespec64_equal(&old_ma->fsx_ptime, &fa->fsx_ptime) && + (fa->flags & old_ma->flags) & (FS_APPEND_FL | FS_IMMUTABLE_FL)) + return -EPERM; + } + /* * It is only valid to set the DAX flag on regular files and * directories on filesystems. @@ -293,6 +314,7 @@ int vfs_fileattr_set(const struct mnt_idmap *idmap, struct dentry *dentry, fa->fsx_nextents = old_ma.fsx_nextents; fa->fsx_projid = old_ma.fsx_projid; fa->fsx_cowextsize = old_ma.fsx_cowextsize; + fa->fsx_ptime = old_ma.fsx_ptime; } else { fa->flags |= old_ma.flags & ~FS_COMMON_FL; } @@ -423,6 +445,10 @@ SYSCALL_DEFINE5(file_getattr, int, dfd, const char __user *, filename, return error; fileattr_to_file_attr(&fa, &fattr); + + if (usize < FILE_ATTR_SIZE_VER1) + fattr.fa_xflags &= ~FS_XFLAG_PTIME; + error = copy_struct_to_user(ufattr, usize, &fattr, sizeof(struct file_attr), NULL); @@ -459,6 +485,9 @@ SYSCALL_DEFINE5(file_setattr, int, dfd, const char __user *, filename, if (error) return error; + if ((fattr.fa_xflags & FS_XFLAG_PTIME) && usize < FILE_ATTR_SIZE_VER1) + return -EINVAL; + error = file_attr_to_fileattr(&fattr, &fa); if (error) return error; diff --git a/fs/stat.c b/fs/stat.c index a2e63c6c45b7..e426f41253f6 100644 --- a/fs/stat.c +++ b/fs/stat.c @@ -728,6 +728,8 @@ cp_statx(const struct kstat *stat, struct statx __user *buffer) tmp.stx_ctime.tv_nsec = stat->ctime.tv_nsec; tmp.stx_mtime.tv_sec = stat->mtime.tv_sec; tmp.stx_mtime.tv_nsec = stat->mtime.tv_nsec; + tmp.stx_ptime.tv_sec = stat->ptime.tv_sec; + tmp.stx_ptime.tv_nsec = stat->ptime.tv_nsec; tmp.stx_rdev_major = MAJOR(stat->rdev); tmp.stx_rdev_minor = MINOR(stat->rdev); tmp.stx_dev_major = MAJOR(stat->dev); diff --git a/include/linux/fileattr.h b/include/linux/fileattr.h index 09e32b84e02a..0b93f9609284 100644 --- a/include/linux/fileattr.h +++ b/include/linux/fileattr.h @@ -35,6 +35,10 @@ (FS_XFLAG_COMMON | FS_XFLAG_RDONLY_MASK | FS_XFLAG_VALUES_MASK | \ FS_XFLAG_DIRONLY_MASK | FS_XFLAG_MISC_MASK) +/* Flags only for fa_ fields */ +#define FS_FILE_ATTR_XFLAGS_MASK \ + (FS_XFLAGS_MASK | FS_XFLAG_PTIME) + /* * Merged interface for miscellaneous file attributes. 'flags' originates from * ext* and 'fsx_flags' from xfs. There's some overlap between the two, which @@ -49,6 +53,7 @@ struct file_kattr { u32 fsx_nextents; /* nextents field value (get) */ u32 fsx_projid; /* project identifier (get/set) */ u32 fsx_cowextsize; /* CoW extsize field value (get/set)*/ + struct timespec64 fsx_ptime; /* provenance (settable birth) time */ /* selectors: */ bool flags_valid:1; bool fsx_valid:1; diff --git a/include/linux/stat.h b/include/linux/stat.h index 9c5709132862..69d2ecfd1bf2 100644 --- a/include/linux/stat.h +++ b/include/linux/stat.h @@ -48,6 +48,7 @@ struct kstat { struct timespec64 mtime; struct timespec64 ctime; struct timespec64 btime; /* File creation time */ + struct timespec64 ptime; /* File provenance (user-settable creation) time */ u64 blocks; u64 mnt_id; u64 change_cookie; diff --git a/include/uapi/linux/fs.h b/include/uapi/linux/fs.h index a46c33692aa2..c00e72fcfa3e 100644 --- a/include/uapi/linux/fs.h +++ b/include/uapi/linux/fs.h @@ -229,10 +229,14 @@ struct file_attr { __u32 fa_nextents; /* nextents field value (get) */ __u32 fa_projid; /* project identifier (get/set) */ __u32 fa_cowextsize; /* CoW extsize field value (get/set) */ + __s64 fa_ptime_sec; /* provenance (settable birth) time (seconds) */ + __u32 fa_ptime_nsec; /* provenance (settable birth) time (nanoseconds) */ + __u32 fa_pad; }; #define FILE_ATTR_SIZE_VER0 24 -#define FILE_ATTR_SIZE_LATEST FILE_ATTR_SIZE_VER0 +#define FILE_ATTR_SIZE_VER1 40 +#define FILE_ATTR_SIZE_LATEST FILE_ATTR_SIZE_VER1 /* * Flags for the fsx_xflags field @@ -261,6 +265,8 @@ struct file_attr { */ #define FS_XFLAG_CASEFOLD 0x00040000 /* case-insensitive lookups */ #define FS_XFLAG_CASENONPRESERVING 0x00080000 /* case not preserved */ + +#define FS_XFLAG_PTIME 0x00100000 /* provenance time */ #define FS_XFLAG_HASATTR 0x80000000 /* no DIFLAG for this */ /* the read-only stuff doesn't really belong here, but any other place is diff --git a/include/uapi/linux/stat.h b/include/uapi/linux/stat.h index 1686861aae20..f3a1013ba022 100644 --- a/include/uapi/linux/stat.h +++ b/include/uapi/linux/stat.h @@ -187,7 +187,11 @@ struct statx { __u32 __spare2[1]; /* 0xc0 */ - __u64 __spare3[8]; /* Spare space for future expansion */ + /* Data provenance (creation) time */ + struct statx_timestamp stx_ptime; + + /* 0xd0 */ + __u64 __spare3[6]; /* Spare space for future expansion */ /* 0x100 */ }; @@ -219,6 +223,7 @@ struct statx { #define STATX_SUBVOL 0x00008000U /* Want/got stx_subvol */ #define STATX_WRITE_ATOMIC 0x00010000U /* Want/got atomic_write_* fields */ #define STATX_DIO_READ_ALIGN 0x00020000U /* Want/got dio read alignment info */ +#define STATX_PTIME 0x00040000U /* Want/got stx_ptime */ #define STATX__RESERVED 0x80000000U /* Reserved for future struct statx expansion */ -- 2.56.0