2016-10-23 19:43:45

by Fabian Frédérick

[permalink] [raw]
Subject: [PATCH 1/1 linux-next] ext4: fix block_validity definition

Fix ext4 documentation according to commit 45f1a9c3f63d
("ext4: enable block_validity by default")

Also fix some typos.

Signed-off-by: Fabian Frederick <[email protected]>
---
Documentation/filesystems/ext4.txt | 7 +++----
1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt
index 6c0108e..024c6db 100644
--- a/Documentation/filesystems/ext4.txt
+++ b/Documentation/filesystems/ext4.txt
@@ -351,14 +351,13 @@ nouid32 Disables 32-bit UIDs and GIDs. This is for
interoperability with older kernels which only
store and expect 16-bit values.

-block_validity This options allows to enables/disables the in-kernel
+block_validity(*) This option allows to enable/disable the in-kernel
noblock_validity facility for tracking filesystem metadata blocks
within internal data structures. This allows multi-
block allocator and other routines to quickly locate
extents which might overlap with filesystem metadata
- blocks. This option is intended for debugging
- purposes and since it negatively affects the
- performance, it is off by default.
+ blocks. Initially intended for debugging, it's now
+ enabled by default.

dioread_lock Controls whether or not ext4 should use the DIO read
dioread_nolock locking. If the dioread_nolock option is specified
--
2.7.4


2016-10-23 20:10:13

by Darrick J. Wong

[permalink] [raw]
Subject: Re: [PATCH 1/1 linux-next] ext4: fix block_validity definition

On Sun, Oct 23, 2016 at 09:43:34PM +0200, Fabian Frederick wrote:
> Fix ext4 documentation according to commit 45f1a9c3f63d
> ("ext4: enable block_validity by default")
>
> Also fix some typos.
>
> Signed-off-by: Fabian Frederick <[email protected]>
> ---
> Documentation/filesystems/ext4.txt | 7 +++----
> 1 file changed, 3 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt
> index 6c0108e..024c6db 100644
> --- a/Documentation/filesystems/ext4.txt
> +++ b/Documentation/filesystems/ext4.txt
> @@ -351,14 +351,13 @@ nouid32 Disables 32-bit UIDs and GIDs. This is for
> interoperability with older kernels which only
> store and expect 16-bit values.
>
> -block_validity This options allows to enables/disables the in-kernel
> +block_validity(*) This option allows to enable/disable the in-kernel

This sentence still reads awkwardly. How about:

"These options enable or disable the in-kernel facility for tracking..."

The rest looks ok, so
Reviewed-by: Darrick J. Wong <[email protected]>

--D

> noblock_validity facility for tracking filesystem metadata blocks
> within internal data structures. This allows multi-
> block allocator and other routines to quickly locate
> extents which might overlap with filesystem metadata
> - blocks. This option is intended for debugging
> - purposes and since it negatively affects the
> - performance, it is off by default.
> + blocks. Initially intended for debugging, it's now
> + enabled by default.
>
> dioread_lock Controls whether or not ext4 should use the DIO read
> dioread_nolock locking. If the dioread_nolock option is specified
> --
> 2.7.4
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-ext4" in
> the body of a message to [email protected]
> More majordomo info at http://vger.kernel.org/majordomo-info.html

2016-12-03 21:44:29

by Theodore Ts'o

[permalink] [raw]
Subject: Re: [PATCH 1/1 linux-next] ext4: fix block_validity definition

I've applied this patch with some further cleanups. The documentation
for the mount options now reads:

block_validity(*) These options enable or disable the in-kernel
noblock_validity facility for tracking filesystem metadata blocks
within internal data structures. This allows multi-
block allocator and other routines to notice
bugs or corrupted allocation bitmaps which cause
blocks to be allocated which overlap with
filesystem metadata blocks.

- Ted