Merge tag 'for-5.15/io_uring-2021-09-04' of git://git.kernel.dk/linux-block

[linux-2.6-microblaze.git] / Documentation / filesystems / f2fs.rst

diff --git a/Documentation/filesystems/f2fs.rst b/Documentation/filesystems/f2fs.rst
index ff9e7cc..09de6eb 100644 (file)
--- a/Documentation/filesystems/f2fs.rst
+++ b/Documentation/filesystems/f2fs.rst
@@ -185,6 +185,7 @@ fault_type=%d                Support configuring fault injection type, should be
                         FAULT_KVMALLOC           0x000000002
                         FAULT_PAGE_ALLOC         0x000000004
                         FAULT_PAGE_GET           0x000000008
+                        FAULT_ALLOC_BIO          0x000000010 (obsolete)
                         FAULT_ALLOC_NID          0x000000020
                         FAULT_ORPHAN             0x000000040
                         FAULT_BLOCK              0x000000080
@@ -195,6 +196,7 @@ fault_type=%d                Support configuring fault injection type, should be
                         FAULT_CHECKPOINT         0x000001000
                         FAULT_DISCARD            0x000002000
                         FAULT_WRITE_IO           0x000004000
+                        FAULT_SLAB_ALLOC         0x000008000
                         ===================      ===========
 mode=%s                         Control block allocation mode which supports "adaptive"
                         and "lfs". In "lfs" mode, there should be no random
@@ -312,6 +314,14 @@ inlinecrypt                 When possible, encrypt/decrypt the contents of encrypted
                         Documentation/block/inline-encryption.rst.
 atgc                    Enable age-threshold garbage collection, it provides high
                         effectiveness and efficiency on background GC.
+discard_unit=%s                 Control discard unit, the argument can be "block", "segment"
+                        and "section", issued discard command's offset/size will be
+                        aligned to the unit, by default, "discard_unit=block" is set,
+                        so that small discard functionality is enabled.
+                        For blkzoned device, "discard_unit=section" will be set by
+                        default, it is helpful for large sized SMR or ZNS devices to
+                        reduce memory cost by getting rid of fs metadata supports small
+                        discard.
 ======================== ============================================================
 
 Debugfs Entries
@@ -857,8 +867,11 @@ Compression implementation
   directly in order to guarantee potential data updates later to the space.
   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
-  congestion. Alternatively, we've added ioctl interface to reclaim compressed
-  space and show it to user after putting the immutable bit.
+  congestion. Alternatively, we've added ioctl(F2FS_IOC_RELEASE_COMPRESS_BLOCKS)
+  interface to reclaim compressed space and show it to user after putting the
+  immutable bit. Immutable bit, after release, it doesn't allow writing/mmaping
+  on the file, until reserving compressed space via
+  ioctl(F2FS_IOC_RESERVE_COMPRESS_BLOCKS) or truncating filesize to zero.
 
 Compress metadata layout::