From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 94861C2D0DB for ; Tue, 28 Jan 2020 19:25:37 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 5CDA524683 for ; Tue, 28 Jan 2020 19:25:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1580239537; bh=M3Y7uG3L87hHEIblJRkwGCUrIWxfUyUuQcFB65l6IOU=; h=From:To:Cc:Subject:Date:List-ID:From; b=BuUxEQ31zqJaY9s6SRGZHWSwGjfVkk6hpOsDlt26GGuYM/3Mf2fVRW8zeQCxTzy/h b5XUvayBnL+FCc7kTrLqlJctrduSQA+u2IBYwxclgnIUExcXY797K0ip2ipWM06Pi/ Dj3dS8J4phER+CgS1EzPo9xxiXcWhXDqGVgLExjM= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726291AbgA1TZh (ORCPT ); Tue, 28 Jan 2020 14:25:37 -0500 Received: from mail.kernel.org ([198.145.29.99]:49548 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726002AbgA1TZh (ORCPT ); Tue, 28 Jan 2020 14:25:37 -0500 Received: from ebiggers-linuxstation.mtv.corp.google.com (unknown [104.132.1.77]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 4AA6C2467E; Tue, 28 Jan 2020 19:25:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1580239536; bh=M3Y7uG3L87hHEIblJRkwGCUrIWxfUyUuQcFB65l6IOU=; h=From:To:Cc:Subject:Date:From; b=wTXco5V78aTgUxIfwidPR1INdxREciyqDqF7/pont4zqUkKXRrsNfKNTjuIRuIHZi HsblQFNH95dkMKqBw5aclAbH+itf7iLvYRjERPOvlbxYPyvh1sZPAml/cAuxvPEZN8 trvb/I0cedRqTxCE15eKdSyDtZLYoF5gFJyGdWOI= From: Eric Biggers To: mtk.manpages@gmail.com Cc: linux-man@vger.kernel.org, linux-fscrypt@vger.kernel.org, linux-ext4@vger.kernel.org, linux-f2fs-devel@lists.sourceforge.net, linux-fsdevel@vger.kernel.org Subject: [man-pages PATCH v2] statx.2: document STATX_ATTR_VERITY Date: Tue, 28 Jan 2020 11:24:49 -0800 Message-Id: <20200128192449.260550-1-ebiggers@kernel.org> X-Mailer: git-send-email 2.25.0.341.g760bfbb309-goog MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-fscrypt-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fscrypt@vger.kernel.org From: Eric Biggers Document the verity attribute for statx(), which was added in Linux 5.5. For more context, see the fs-verity documentation: https://www.kernel.org/doc/html/latest/filesystems/fsverity.html Signed-off-by: Eric Biggers --- man2/statx.2 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/man2/statx.2 b/man2/statx.2 index d2f1b07b8..d015ee73d 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -461,6 +461,11 @@ See .TP .B STATX_ATTR_ENCRYPTED A key is required for the file to be encrypted by the filesystem. +.TP +.B STATX_ATTR_VERITY +Since Linux 5.5: the file has fs-verity enabled. It cannot be written to, and +all reads from it will be verified against a cryptographic hash that covers the +entire file, e.g. via a Merkle tree. .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and -- 2.25.0.341.g760bfbb309-goog