^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/fs/f2fs/<disk>/gc_max_sleep_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: July 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description: Controls the maximum sleep time for gc_thread. Time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) is in milliseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) What: /sys/fs/f2fs/<disk>/gc_min_sleep_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Date: July 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Description: Controls the minimum sleep time for gc_thread. Time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) is in milliseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) What: /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Date: July 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Description: Controls the default sleep time for gc_thread. Time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) is in milliseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) What: /sys/fs/f2fs/<disk>/gc_idle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Date: July 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Contact: "Namjae Jeon" <namjae.jeon@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Description: Controls the victim selection policy for garbage collection.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Setting gc_idle = 0(default) will disable this option. Setting:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) =========== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) gc_idle = 1 will select the Cost Benefit approach & setting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) gc_idle = 2 will select the greedy approach & setting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) gc_idle = 3 will select the age-threshold based approach.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) =========== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) What: /sys/fs/f2fs/<disk>/reclaim_segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Date: October 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Description: This parameter controls the number of prefree segments to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) reclaimed. If the number of prefree segments is larger than
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) the number of segments in the proportion to the percentage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) over total volume size, f2fs tries to conduct checkpoint to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) reclaim the prefree segments to free segments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) By default, 5% over total # of segments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) What: /sys/fs/f2fs/<disk>/main_blkaddr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Date: November 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Contact: "Ramon Pantin" <pantin@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) Shows first block address of MAIN area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) What: /sys/fs/f2fs/<disk>/ipu_policy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Date: November 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Description: Controls the in-place-update policy.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) updates in f2fs. User can set:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) ==== =================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 0x01 F2FS_IPU_FORCE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) 0x02 F2FS_IPU_SSR
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) 0x04 F2FS_IPU_UTIL
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 0x08 F2FS_IPU_SSR_UTIL
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 0x10 F2FS_IPU_FSYNC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 0x20 F2FS_IPU_ASYNC,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 0x40 F2FS_IPU_NOCACHE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) ==== =================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) Refer segment.h for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) What: /sys/fs/f2fs/<disk>/min_ipu_util
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) Date: November 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Description: Controls the FS utilization condition for the in-place-update
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) policies. It is used by F2FS_IPU_UTIL and F2FS_IPU_SSR_UTIL policies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) What: /sys/fs/f2fs/<disk>/min_fsync_blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) Date: September 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Description: Controls the dirty page count condition for the in-place-update
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) policies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) What: /sys/fs/f2fs/<disk>/min_seq_blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Date: August 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) Description: Controls the dirty page count condition for batched sequential
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) writes in writepages.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) What: /sys/fs/f2fs/<disk>/min_hot_blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) Date: March 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) Description: Controls the dirty page count condition for redefining hot data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) What: /sys/fs/f2fs/<disk>/min_ssr_sections
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Date: October 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) Description: Controls the free section threshold to trigger SSR allocation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) If this is large, SSR mode will be enabled early.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) What: /sys/fs/f2fs/<disk>/max_small_discards
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) Date: November 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) Description: Controls the issue rate of discard commands that consist of small
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) blocks less than 2MB. The candidates to be discarded are cached until
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) checkpoint is triggered, and issued during the checkpoint.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) By default, it is disabled with 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) What: /sys/fs/f2fs/<disk>/discard_granularity
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) Date: July 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) Description: Controls discard granularity of inner discard thread. Inner thread
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) will not issue discards with size that is smaller than granularity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) The unit size is one block(4KB), now only support configuring
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) in range of [1, 512]. Default value is 4(=16KB).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) What: /sys/fs/f2fs/<disk>/umount_discard_timeout
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Date: January 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) Description: Set timeout to issue discard commands during umount.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) Default: 5 secs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) What: /sys/fs/f2fs/<disk>/pending_discard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Date: November 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) Description: Shows the number of pending discard commands in the queue.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) What: /sys/fs/f2fs/<disk>/max_victim_search
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) Date: January 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) Description: Controls the number of trials to find a victim segment
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) when conducting SSR and cleaning operations. The default value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) is 4096 which covers 8GB block address range.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) What: /sys/fs/f2fs/<disk>/migration_granularity
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) Date: October 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) Description: Controls migration granularity of garbage collection on large
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) section, it can let GC move partial segment{s} of one section
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) in one GC cycle, so that dispersing heavy overhead GC to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) multiple lightweight one.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) What: /sys/fs/f2fs/<disk>/dir_level
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) Date: March 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) Description: Controls the directory level for large directory. If a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) directory has a number of files, it can reduce the file lookup
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) latency by increasing this dir_level value. Otherwise, it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) needs to decrease this value to reduce the space overhead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) The default value is 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) What: /sys/fs/f2fs/<disk>/ram_thresh
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) Date: March 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) Description: Controls the memory footprint used by free nids and cached
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) nat entries. By default, 1 is set, which indicates
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) 10 MB / 1 GB RAM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) What: /sys/fs/f2fs/<disk>/batched_trim_sections
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) Date: February 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) Description: Controls the trimming rate in batch mode.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) <deprecated>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) What: /sys/fs/f2fs/<disk>/cp_interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) Date: October 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) Description: Controls the checkpoint timing, set to 60 seconds by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) What: /sys/fs/f2fs/<disk>/idle_interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) Date: January 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) Description: Controls the idle timing of system, if there is no FS operation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) during given interval.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) Set to 5 seconds by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) What: /sys/fs/f2fs/<disk>/discard_idle_interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) Date: September 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) Contact: "Sahitya Tummala" <stummala@codeaurora.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) Description: Controls the idle timing of discard thread given
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) this time interval.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) Default is 5 secs.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) What: /sys/fs/f2fs/<disk>/gc_idle_interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) Date: September 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) Contact: "Sahitya Tummala" <stummala@codeaurora.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) Description: Controls the idle timing for gc path. Set to 5 seconds by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) What: /sys/fs/f2fs/<disk>/iostat_enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) Date: August 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) Description: Controls to enable/disable IO stat.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) What: /sys/fs/f2fs/<disk>/ra_nid_pages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) Date: October 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) Contact: "Chao Yu" <chao2.yu@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) Description: Controls the count of nid pages to be readaheaded.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) When building free nids, F2FS reads NAT blocks ahead for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) speed up. Default is 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) What: /sys/fs/f2fs/<disk>/dirty_nats_ratio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) Date: January 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) Contact: "Chao Yu" <chao2.yu@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) Description: Controls dirty nat entries ratio threshold, if current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) ratio exceeds configured threshold, checkpoint will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) be triggered for flushing dirty nat entries.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) What: /sys/fs/f2fs/<disk>/lifetime_write_kbytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) Date: January 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) Contact: "Shuoran Liu" <liushuoran@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) Description: Shows total written kbytes issued to disk.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) What: /sys/fs/f2fs/<disk>/features
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) Date: July 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) Description: <deprecated: should use /sys/fs/f2fs/<disk>/feature_list/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) Shows all enabled features in current device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) Supported features:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) encryption, blkzoned, extra_attr, projquota, inode_checksum,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) verity, sb_checksum, casefold, readonly, compression, pin_file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) What: /sys/fs/f2fs/<disk>/feature_list/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) Date: June 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) Description: Expand /sys/fs/f2fs/<disk>/features to meet sysfs rule.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) Supported on-disk features:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) encryption, block_zoned (aka blkzoned), extra_attr,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) project_quota (aka projquota), inode_checksum,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) flexible_inline_xattr, quota_ino, inode_crtime, lost_found,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) verity, sb_checksum, casefold, readonly, compression.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) Note that, pin_file is moved into /sys/fs/f2fs/features/.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) What: /sys/fs/f2fs/features/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) Date: July 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) Description: Shows all enabled kernel features.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) Supported features:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) encryption, block_zoned, extra_attr, project_quota,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) inode_checksum, flexible_inline_xattr, quota_ino,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) inode_crtime, lost_found, verity, sb_checksum,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) casefold, readonly, compression, test_dummy_encryption_v2,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) atomic_write, pin_file, encrypted_casefold.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) What: /sys/fs/f2fs/<disk>/inject_rate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) Date: May 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) Contact: "Sheng Yong" <shengyong1@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) Description: Controls the injection rate of arbitrary faults.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) What: /sys/fs/f2fs/<disk>/inject_type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) Date: May 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) Contact: "Sheng Yong" <shengyong1@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) Description: Controls the injection type of arbitrary faults.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) What: /sys/fs/f2fs/<disk>/dirty_segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) Date: October 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) Description: Shows the number of dirty segments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) What: /sys/fs/f2fs/<disk>/reserved_blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) Date: June 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) Description: Controls target reserved blocks in system, the threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259) is soft, it could exceed current available user space.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) What: /sys/fs/f2fs/<disk>/current_reserved_blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) Date: October 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) Contact: "Yunlong Song" <yunlong.song@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) Description: Shows current reserved blocks in system, it may be temporarily
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) smaller than target_reserved_blocks, but will gradually
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) increase to target_reserved_blocks when more free blocks are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) freed by user later.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) What: /sys/fs/f2fs/<disk>/gc_urgent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) Date: August 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) Description: Do background GC agressively when set. When gc_urgent = 1,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) background thread starts to do GC by given gc_urgent_sleep_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) interval. When gc_urgent = 2, F2FS will lower the bar of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) checking idle in order to process outstanding discard commands
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) and GC a little bit aggressively. It is set to 0 by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) What: /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) Date: August 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282) Description: Controls sleep time of GC urgent mode. Set to 500ms by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) What: /sys/fs/f2fs/<disk>/readdir_ra
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) Date: November 2017
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) Contact: "Sheng Yong" <shengyong1@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) Description: Controls readahead inode block in readdir. Enabled by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) What: /sys/fs/f2fs/<disk>/gc_pin_file_thresh
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) Date: January 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) Contact: Jaegeuk Kim <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) Description: This indicates how many GC can be failed for the pinned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) file. If it exceeds this, F2FS doesn't guarantee its pinning
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) state. 2048 trials is set by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) What: /sys/fs/f2fs/<disk>/extension_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) Date: Feburary 2018
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) Description: Used to control configure extension list:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) - Query: cat /sys/fs/f2fs/<disk>/extension_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) - [h] means add/del hot file extension
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) - [c] means add/del cold file extension
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) What: /sys/fs/f2fs/<disk>/unusable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) Date April 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308) Contact: "Daniel Rosenberg" <drosen@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) Description: If checkpoint=disable, it displays the number of blocks that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) are unusable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311) If checkpoint=enable it displays the number of blocks that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) would be unusable if checkpoint=disable were to be set.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314) What: /sys/fs/f2fs/<disk>/encoding
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315) Date July 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316) Contact: "Daniel Rosenberg" <drosen@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) Description: Displays name and version of the encoding set for the filesystem.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318) If no encoding is set, displays (none)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) What: /sys/fs/f2fs/<disk>/free_segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) Description: Number of free segments in disk.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) What: /sys/fs/f2fs/<disk>/cp_foreground_calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328) Description: Number of checkpoint operations performed on demand. Available when
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329) CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331) What: /sys/fs/f2fs/<disk>/cp_background_calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334) Description: Number of checkpoint operations performed in the background to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335) free segments. Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) What: /sys/fs/f2fs/<disk>/gc_foreground_calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) Description: Number of garbage collection operations performed on demand.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341) Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) What: /sys/fs/f2fs/<disk>/gc_background_calls
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346) Description: Number of garbage collection operations triggered in background.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349) What: /sys/fs/f2fs/<disk>/moved_blocks_foreground
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 350) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 351) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 352) Description: Number of blocks moved by garbage collection in foreground.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 353) Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 354)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 355) What: /sys/fs/f2fs/<disk>/moved_blocks_background
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 356) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 357) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 358) Description: Number of blocks moved by garbage collection in background.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 359) Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 360)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 361) What: /sys/fs/f2fs/<disk>/avg_vblocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 362) Date: September 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 363) Contact: "Hridya Valsaraju" <hridya@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 364) Description: Average number of valid blocks.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 365) Available when CONFIG_F2FS_STAT_FS=y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 366)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 367) What: /sys/fs/f2fs/<disk>/mounted_time_sec
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 368) Date: February 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 369) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 370) Description: Show the mounted time in secs of this partition.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 371)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 372) What: /sys/fs/f2fs/<disk>/data_io_flag
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 373) Date: April 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 374) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 375) Description: Give a way to attach REQ_META|FUA to data writes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 376) given temperature-based bits. Now the bits indicate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 377)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 378) +-------------------+-------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 379) | REQ_META | REQ_FUA |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 380) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 381) | 5 | 4 | 3 | 2 | 1 | 0 |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 382) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 383) | Cold | Warm | Hot | Cold | Warm | Hot |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 384) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 385)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 386) What: /sys/fs/f2fs/<disk>/node_io_flag
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 387) Date: June 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 388) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 389) Description: Give a way to attach REQ_META|FUA to node writes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 390) given temperature-based bits. Now the bits indicate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 391)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 392) +-------------------+-------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 393) | REQ_META | REQ_FUA |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 394) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 395) | 5 | 4 | 3 | 2 | 1 | 0 |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 396) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 397) | Cold | Warm | Hot | Cold | Warm | Hot |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 398) +------+------+-----+------+------+-----+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 399)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 400) What: /sys/fs/f2fs/<disk>/iostat_period_ms
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 401) Date: April 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 402) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 403) Description: Give a way to change iostat_period time. 3secs by default.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 404) The new iostat trace gives stats gap given the period.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 405) What: /sys/fs/f2fs/<disk>/max_io_bytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 406) Date: December 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 407) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 408) Description: This gives a control to limit the bio size in f2fs.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 409) Default is zero, which will follow underlying block layer limit,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 410) whereas, if it has a certain bytes value, f2fs won't submit a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 411) bio larger than that size.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 412)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 413) What: /sys/fs/f2fs/<disk>/stat/sb_status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 414) Date: December 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 415) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 416) Description: Show status of f2fs superblock in real time.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 417)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 418) ====== ===================== =================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 419) value sb status macro description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 420) 0x1 SBI_IS_DIRTY dirty flag for checkpoint
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 421) 0x2 SBI_IS_CLOSE specify unmounting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 422) 0x4 SBI_NEED_FSCK need fsck.f2fs to fix
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 423) 0x8 SBI_POR_DOING recovery is doing or not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 424) 0x10 SBI_NEED_SB_WRITE need to recover superblock
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 425) 0x20 SBI_NEED_CP need to checkpoint
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 426) 0x40 SBI_IS_SHUTDOWN shutdown by ioctl
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 427) 0x80 SBI_IS_RECOVERED recovered orphan/data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 428) 0x100 SBI_CP_DISABLED CP was disabled last mount
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 429) 0x200 SBI_CP_DISABLED_QUICK CP was disabled quickly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 430) 0x400 SBI_QUOTA_NEED_FLUSH need to flush quota info in CP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 431) 0x800 SBI_QUOTA_SKIP_FLUSH skip flushing quota in current CP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 432) 0x1000 SBI_QUOTA_NEED_REPAIR quota file may be corrupted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 433) 0x2000 SBI_IS_RESIZEFS resizefs is in process
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 434) ====== ===================== =================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 435)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 436) What: /sys/fs/f2fs/<disk>/ckpt_thread_ioprio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 437) Date: January 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 438) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 439) Description: Give a way to change checkpoint merge daemon's io priority.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 440) Its default value is "be,3", which means "BE" I/O class and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 441) I/O priority "3". We can select the class between "rt" and "be",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 442) and set the I/O priority within valid range of it. "," delimiter
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 443) is necessary in between I/O class and priority number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 444)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 445) What: /sys/fs/f2fs/<disk>/ovp_segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 446) Date: March 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 447) Contact: "Jaegeuk Kim" <jaegeuk@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 448) Description: Shows the number of overprovision segments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 449)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 450) What: /sys/fs/f2fs/<disk>/compr_written_block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 451) Date: March 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 452) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 453) Description: Show the block count written after compression since mount. Note
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 454) that when the compressed blocks are deleted, this count doesn't
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 455) decrease. If you write "0" here, you can initialize
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 456) compr_written_block and compr_saved_block to "0".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 457)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 458) What: /sys/fs/f2fs/<disk>/compr_saved_block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 459) Date: March 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 460) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 461) Description: Show the saved block count with compression since mount. Note
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 462) that when the compressed blocks are deleted, this count doesn't
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 463) decrease. If you write "0" here, you can initialize
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 464) compr_written_block and compr_saved_block to "0".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 465)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 466) What: /sys/fs/f2fs/<disk>/compr_new_inode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 467) Date: March 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 468) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 469) Description: Show the count of inode newly enabled for compression since mount.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 470) Note that when the compression is disabled for the files, this count
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 471) doesn't decrease. If you write "0" here, you can initialize
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 472) compr_new_inode to "0".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 473)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 474) What: /sys/fs/f2fs/<disk>/atgc_candidate_ratio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 475) Date: May 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 476) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 477) Description: When ATGC is on, it controls candidate ratio in order to limit total
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 478) number of potential victim in all candidates, the value should be in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 479) range of [0, 100], by default it was initialized as 20(%).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 480)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 481) What: /sys/fs/f2fs/<disk>/atgc_candidate_count
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 482) Date: May 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 483) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 484) Description: When ATGC is on, it controls candidate count in order to limit total
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 485) number of potential victim in all candidates, by default it was
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 486) initialized as 10 (sections).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 487)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 488) What: /sys/fs/f2fs/<disk>/atgc_age_weight
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 489) Date: May 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 490) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 491) Description: When ATGC is on, it controls age weight to balance weight proportion
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 492) in between aging and valid blocks, the value should be in range of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 493) [0, 100], by default it was initialized as 60(%).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 494)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 495) What: /sys/fs/f2fs/<disk>/atgc_age_threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 496) Date: May 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 497) Contact: "Chao Yu" <yuchao0@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 498) Description: When ATGC is on, it controls age threshold to bypass GCing young
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 499) candidates whose age is not beyond the threshold, by default it was
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 500) initialized as 604800 seconds (equals to 7 days).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 501)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 502) What: /sys/fs/f2fs/<disk>/gc_reclaimed_segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 503) Date: July 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 504) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 505) Description: Show how many segments have been reclaimed by GC during a specific
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 506) GC mode (0: GC normal, 1: GC idle CB, 2: GC idle greedy,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 507) 3: GC idle AT, 4: GC urgent high, 5: GC urgent low)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 508) You can re-initialize this value to "0".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 509)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 510) What: /sys/fs/f2fs/<disk>/gc_segment_mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 511) Date: July 2021
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 512) Contact: "Daeho Jeong" <daehojeong@google.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 513) Description: You can control for which gc mode the "gc_reclaimed_segments" node shows.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 514) Refer to the description of the modes in "gc_reclaimed_segments".