Commit d218bee8 authored by Chao Liu's avatar Chao Liu Committed by Jonathan Corbet

docs: filesystems: f2fs: fix description about compress ioctl

Since commit c6140415 ("f2fs: introduce FI_COMPRESS_RELEASED
instead of using IMMUTABLE bit"), we no longer use the IMMUTABLE
bit to prevent writing data for compression. Let's correct the
corresponding documentation.

BTW, this patch fixes some alignment issues in the compress
metadata layout.
Signed-off-by: default avatarChao Liu <liuchao@coolpad.com>
Link: https://lore.kernel.org/r/20220613020800.3379482-1-chaoliu719@gmail.comSigned-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 910cb313
...@@ -818,10 +818,11 @@ Compression implementation ...@@ -818,10 +818,11 @@ Compression implementation
Instead, the main goal is to reduce data writes to flash disk as much as Instead, the main goal is to reduce data writes to flash disk as much as
possible, resulting in extending disk life time as well as relaxing IO possible, resulting in extending disk life time as well as relaxing IO
congestion. Alternatively, we've added ioctl(F2FS_IOC_RELEASE_COMPRESS_BLOCKS) congestion. Alternatively, we've added ioctl(F2FS_IOC_RELEASE_COMPRESS_BLOCKS)
interface to reclaim compressed space and show it to user after putting the interface to reclaim compressed space and show it to user after setting a
immutable bit. Immutable bit, after release, it doesn't allow writing/mmaping special flag to the inode. Once the compressed space is released, the flag
on the file, until reserving compressed space via will block writing data to the file until either the compressed space is
ioctl(F2FS_IOC_RESERVE_COMPRESS_BLOCKS) or truncating filesize to zero. reserved via ioctl(F2FS_IOC_RESERVE_COMPRESS_BLOCKS) or the file size is
truncated to zero.
Compress metadata layout:: Compress metadata layout::
...@@ -830,12 +831,12 @@ Compress metadata layout:: ...@@ -830,12 +831,12 @@ Compress metadata layout::
| cluster 1 | cluster 2 | ......... | cluster N | | cluster 1 | cluster 2 | ......... | cluster N |
+-----------------------------------------------+ +-----------------------------------------------+
. . . . . . . .
. . . . . . . .
. Compressed Cluster . . Normal Cluster . . Compressed Cluster . . Normal Cluster .
+----------+---------+---------+---------+ +---------+---------+---------+---------+ +----------+---------+---------+---------+ +---------+---------+---------+---------+
|compr flag| block 1 | block 2 | block 3 | | block 1 | block 2 | block 3 | block 4 | |compr flag| block 1 | block 2 | block 3 | | block 1 | block 2 | block 3 | block 4 |
+----------+---------+---------+---------+ +---------+---------+---------+---------+ +----------+---------+---------+---------+ +---------+---------+---------+---------+
. . . .
. . . .
. . . .
+-------------+-------------+----------+----------------------------+ +-------------+-------------+----------+----------------------------+
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment