Skip to contentSkip to conversation

statx.2: document STATX_ATTR_VERITY

PATCH In review Eric Biggers 2 participants 3 messages Jan 28, 2020 – Mar 12, 2020

Subsystems (3)
lore
Share & tools
lore

Eric Biggers

author maintainer
#0 lore raw

PATCH v2 1/1 statx.2: document STATX_ATTR_VERITY

From: Eric Biggers <[email protected]>

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

---
 man2/statx.2 | 5 +++++
 1 file changed, 5 insertions(+)
man2/statx.2 +5 -0
index d2f1b07b8..d015ee73d 100644
@@ -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
Signature · 1 line
2.25.0.341.g760bfbb309-goog
author maintainer
#1 lore raw
Quoted 32 lines · Eric Biggers

From: Eric Biggers <[email protected]>

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

---
 man2/statx.2 | 5 +++++
 1 file changed, 5 insertions(+)
man2/statx.2 +5 -0
index d2f1b07b8..d015ee73d 100644
@@ -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
Signature · 1 line
2.25.0.341.g760bfbb309-goog

Ping? Michael, can you apply this man-pages patch?

- Eric

#2 lore raw
In reply to Eric Biggers

Hello Eric,

Quoted 7 lines · Eric Biggers

From: Eric Biggers <[email protected]>

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

Thanks for the patch! Applied.

Cheers,

Michael

Quoted 22 lines
---
 man2/statx.2 | 5 +++++
 1 file changed, 5 insertions(+)
man2/statx.2 +5 -0
index d2f1b07b8..d015ee73d 100644
@@ -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
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/