aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEric Biggers <ebiggers@google.com>2019-11-17 17:48:47 -0800
committerTheodore Ts'o <tytso@mit.edu>2019-11-18 12:14:33 -0500
commitbe335e31e77a28a8448d538b0d9416a2a3f8eb0d (patch)
treef4d496eacef1ca1bb75923edcf26dd0bed7517be
parentb9bb6a512ef566b43b7734fe1c5177c15b6a7d25 (diff)
downloade2fsprogs-be335e31e77a28a8448d538b0d9416a2a3f8eb0d.tar.gz
chattr.1: document the verity attribute
Document the verity file attribute ('V'). Signed-off-by: Eric Biggers <ebiggers@google.com> Signed-off-by: Theodore Ts'o <tytso@mit.edu>
-rw-r--r--misc/chattr.1.in12
1 files changed, 11 insertions, 1 deletions
diff --git a/misc/chattr.1.in b/misc/chattr.1.in
index 1c9e89646..2122a13ef 100644
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -52,7 +52,8 @@ The following attributes are read-only, and may be listed by
but not modified by chattr:
encrypted (E),
indexed directory (I),
-and inline data (N).
+inline data (N),
+and verity (V).
.PP
Not all flags are supported or utilized by all filesystems; refer to
filesystem-specific man pages such as
@@ -189,6 +190,15 @@ saved. This allows the user to ask for its undeletion. Note: please
make sure to read the bugs and limitations section at the end of this
document.
.PP
+A file with the 'V' attribute set has fs-verity enabled. It cannot be
+written to, and the filesystem will automatically verify all data read
+from it against a cryptographic hash that covers the entire file's
+contents, e.g. via a Merkle tree. This makes it possible to efficiently
+authenticate the file. This attribute may not be set or reset using
+.BR chattr (1),
+although it can be displayed by
+.BR lsattr (1).
+.PP
.SH AUTHOR
.B chattr
was written by Remy Card <Remy.Card@linux.org>. It is currently being