From patchwork Thu Feb 14 10:00:15 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Omar Sandoval X-Patchwork-Id: 10812275 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 61E4913B5 for ; Thu, 14 Feb 2019 10:01:13 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 507052CCD9 for ; Thu, 14 Feb 2019 10:01:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 44F952CCD5; Thu, 14 Feb 2019 10:01:13 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DFF2F2CD1B for ; Thu, 14 Feb 2019 10:01:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2438169AbfBNKBL (ORCPT ); Thu, 14 Feb 2019 05:01:11 -0500 Received: from mail-pl1-f195.google.com ([209.85.214.195]:44089 "EHLO mail-pl1-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2438164AbfBNKBL (ORCPT ); Thu, 14 Feb 2019 05:01:11 -0500 Received: by mail-pl1-f195.google.com with SMTP id p4so2893460plq.11 for ; Thu, 14 Feb 2019 02:01:10 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=osandov-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=d+8KZV8DZGLRgOGveg0J5W9rdB86sPJhcL3c0ZOutP4=; b=KBigOq3GMXA46Jf89YvNpjxlwERRxbxOiixUCSXyzVypgfz18m0TnCHmw1LyIEsxR4 u6CDoAfa4rQ7KY/p2gcWjJ1ObjGVOW3ndV/O1b2WxLe6RXzRJL/NzNrCBqafIlJ2aOkD p1rSTMbHQlWEAH6xxKIC7HjRBeUfOO/OF/1RI60Wax/m60qqEMkaBcjKkonAp2tKzI3y wEXdVnN0IFQ1ApKeOt118c68aubGz8o/bcxwq+WwMYe02S6SaHSWHwIOSzs8jfA/6fFo ze21Yp4QeNw1EvEH8PPzRIVKuRm+9Erw+MntpM8yfHD+Z66bffp5tU+lqClAB13QjgeH IbLQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=d+8KZV8DZGLRgOGveg0J5W9rdB86sPJhcL3c0ZOutP4=; b=IJuxZ0gbEs1qQz8F1cxq94i8v8lUJb77yBysYB5PhFPNTgJgYjt/poWYV+SIgvBLnr VsXgxZLH/XlvRqGSlEWdRbLvbwYhie7f3hw8C1lf5QjAQbH7aQHHWaqKdj1tYxP8WuoJ irA47RMrnAzvr7PZFwsjjEujN8KWjtwSl8BEPDEv6YwKhP9EPCMjOTKBTwBBfNMSFWCQ FHTR0xixpjAGPu3b24x5aV28EEzIuik4UIpvsQ/W3+PPa8MiS36H/ZEVnaoCaeB4TXaW C2U9Du2UvJ+yl31qowwJECLStPUKKTFfFo4RI3pogp+/KjNbzOV5j8CmT37lkBjCUYps v21g== X-Gm-Message-State: AHQUAuaEyCTE8wgkl6gf5JGb0Erhv2TMMgQ4mEIBRM42YeNpANQZ/YSf K6AcYNuTBOdq7k37FMM2I1OWXyLCyD0= X-Google-Smtp-Source: AHgI3IZogSV5UwpjCxYG7lGfREUHa8OCIB5+L9KpQ00X2q5DUXho0Vqz3KaP7xFD8o20aziCZ1rMAg== X-Received: by 2002:a17:902:8303:: with SMTP id bd3mr3361013plb.10.1550138470199; Thu, 14 Feb 2019 02:01:10 -0800 (PST) Received: from vader.thefacebook.com ([2620:10d:c090:180::1:5849]) by smtp.gmail.com with ESMTPSA id i184sm2686952pfc.41.2019.02.14.02.01.09 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 14 Feb 2019 02:01:09 -0800 (PST) From: Omar Sandoval To: linux-fsdevel@vger.kernel.org, Al Viro Cc: kernel-team@fb.com, linux-api@vger.kernel.org, linux-btrfs@vger.kernel.org, linux-ext4@vger.kernel.org, linux-f2fs-devel@lists.sourceforge.net, linux-xfs@vger.kernel.org Subject: [PATCH] utimensat2: document AT_UTIME_BTIME Date: Thu, 14 Feb 2019 02:00:15 -0800 Message-Id: <4717a88b238f1f03272598295942ebe8f24c2939.1550138203.git.osandov@fb.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: References: MIME-Version: 1.0 Sender: linux-fsdevel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fsdevel@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Omar Sandoval Signed-off-by: Omar Sandoval --- man2/utimensat.2 | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/man2/utimensat.2 b/man2/utimensat.2 index d61b43e96..3b7c62181 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -211,7 +211,7 @@ is ignored. .PP The .I flags -field is a bit mask that may be 0, or include the following constant, +field is a bit mask that may be 0, or include the following constants, defined in .IR : .TP @@ -220,6 +220,36 @@ If .I pathname specifies a symbolic link, then update the timestamps of the link, rather than the file to which it refers. +.TP +.B AT_UTIME_BTIME +Also update the file's "creation time" (\fIbtime\fP). If +.I times +is not NULL, then its length must be at least 3, and +.IR times [2] +specifies the new creation time. The +.I tv_nsec +field may be +.BR UTIME_NOW +or +.BR UTIME_OMIT ; +this has the same meaning as for the first two timestamps. +If +.I times +is NULL, then the creation time is set to the current time. +.IP +Not all filesystems store the file creation time; if a filesystem does not, an +error is returned. At least the following filesystems store the creation time: +.RS +.IP * 3 +Btrfs +.IP * +ext4, if the filesystem was created with an inode size of at least 256 +.IP * +F2FS, if the filesystem was created with the inode_crtime feature +.IP * +XFS, if the filesystem was created with the v5 format (i.e., with CRCs enabled) +.HP +Support for this flag was added in Linux 5.2. .SH RETURN VALUE On success, .BR utimensat () @@ -359,6 +389,12 @@ or, one of the prefix components of .I pathname is not a directory. .TP +.B EOPNOTSUPP +.I flags +contains +.BR AT_UTIME_BTIME +but the filesystem does not store the file creation time. +.TP .B EPERM The caller attempted to change one or both timestamps to a value other than the current time,