aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Biggers <ebiggers@google.com>2023-07-05 20:29:07 -0700
committerEric Biggers <ebiggers@google.com>2023-07-05 20:46:59 -0700
commit585e14a87e7b332dfd00c52fac5e96fc1c760136 (patch)
tree92cb3fae27e06c9c05b5fa224c3a4450448811b2
parent5d6f7c4c2f82140207cf0300683217efe6cd0daa (diff)
downloadfsverity-utils-585e14a87e7b332dfd00c52fac5e96fc1c760136.tar.gz
fsverity.1: update documentation for --block-size
Take into account the changes in Linux v6.3. Signed-off-by: Eric Biggers <ebiggers@google.com>
-rw-r--r--man/fsverity.1.md15
1 files changed, 10 insertions, 5 deletions
diff --git a/man/fsverity.1.md b/man/fsverity.1.md
index 8297d86..f268706 100644
--- a/man/fsverity.1.md
+++ b/man/fsverity.1.md
@@ -49,11 +49,16 @@ Options accepted by **fsverity digest**:
**\-\-block-size**=*BLOCK_SIZE*
: The Merkle tree block size (in bytes) to use. This must be a power of 2 and
- at least twice the size of the hash values. However, note that currently
- (as of Linux kernel v5.13), the Linux kernel implementations of fs-verity
- only support the case where the Merkle tree block size is equal to the
- system page size, usually 4096 bytes. The default value of this option is
- 4096.
+ at least twice the size of the hash values.
+
+ Note that the Linux kernel implementations of fs-verity place further
+ restrictions on the Merkle tree block size. Linux v6.2 and earlier require
+ that the Merkle tree block size be equal to both the system page size and
+ the filesystem block size. These values are often 4096. Linux v6.3 and
+ later are more flexible; they require that the Merkle tree block size be a
+ power of 2 that is greater than or equal to 1024 and less than or equal to
+ the system page size and the filesystem block size. The default value of
+ this option is 4096.
**\-\-compact**
: When printing the file digest, only print the actual digest hex string;