Message ID | 20200128192449.260550-1-ebiggers@kernel.org (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | [man-pages,v2] statx.2: document STATX_ATTR_VERITY | expand |
On Tue, Jan 28, 2020 at 11:24:49AM -0800, Eric Biggers wrote: > From: Eric Biggers <ebiggers@google.com> > > 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 <ebiggers@google.com> > --- > 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 > Ping? Michael, can you apply this man-pages patch? - Eric
Hello Eric, On 1/28/20 8:24 PM, Eric Biggers wrote: > From: Eric Biggers <ebiggers@google.com> > > 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 > Signed-off-by: Eric Biggers <ebiggers@google.com> > --- > 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 >
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