1 What: /sys/fs/f2fs/<disk>/gc_max_sle 1 What: /sys/fs/f2fs/<disk>/gc_max_sleep_time 2 Date: July 2013 2 Date: July 2013 3 Contact: "Namjae Jeon" <namjae.jeon@sams 3 Contact: "Namjae Jeon" <namjae.jeon@samsung.com> 4 Description: Controls the maximum sleep tim 4 Description: Controls the maximum sleep time for gc_thread. Time 5 is in milliseconds. 5 is in milliseconds. 6 6 7 What: /sys/fs/f2fs/<disk>/gc_min_sle 7 What: /sys/fs/f2fs/<disk>/gc_min_sleep_time 8 Date: July 2013 8 Date: July 2013 9 Contact: "Namjae Jeon" <namjae.jeon@sams 9 Contact: "Namjae Jeon" <namjae.jeon@samsung.com> 10 Description: Controls the minimum sleep tim 10 Description: Controls the minimum sleep time for gc_thread. Time 11 is in milliseconds. 11 is in milliseconds. 12 12 13 What: /sys/fs/f2fs/<disk>/gc_no_gc_s 13 What: /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time 14 Date: July 2013 14 Date: July 2013 15 Contact: "Namjae Jeon" <namjae.jeon@sams 15 Contact: "Namjae Jeon" <namjae.jeon@samsung.com> 16 Description: Controls the default sleep tim 16 Description: Controls the default sleep time for gc_thread. Time 17 is in milliseconds. 17 is in milliseconds. 18 18 19 What: /sys/fs/f2fs/<disk>/gc_idle 19 What: /sys/fs/f2fs/<disk>/gc_idle 20 Date: July 2013 20 Date: July 2013 21 Contact: "Namjae Jeon" <namjae.jeon@sams 21 Contact: "Namjae Jeon" <namjae.jeon@samsung.com> 22 Description: Controls the victim selection 22 Description: Controls the victim selection policy for garbage collection. 23 Setting gc_idle = 0(default) w !! 23 Setting gc_idle = 0(default) will disable this option. Setting 24 !! 24 gc_idle = 1 will select the Cost Benefit approach & setting 25 =========== ================= !! 25 gc_idle = 2 will select the greedy approach. 26 gc_idle = 1 will select the C << 27 gc_idle = 2 will select the g << 28 gc_idle = 3 will select the a << 29 =========== ================= << 30 26 31 What: /sys/fs/f2fs/<disk>/reclaim_se 27 What: /sys/fs/f2fs/<disk>/reclaim_segments 32 Date: October 2013 28 Date: October 2013 33 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 29 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 34 Description: This parameter controls the nu 30 Description: This parameter controls the number of prefree segments to be 35 reclaimed. If the number of pr 31 reclaimed. If the number of prefree segments is larger than 36 the number of segments in the 32 the number of segments in the proportion to the percentage 37 over total volume size, f2fs t 33 over total volume size, f2fs tries to conduct checkpoint to 38 reclaim the prefree segments t 34 reclaim the prefree segments to free segments. 39 By default, 5% over total # of 35 By default, 5% over total # of segments. 40 36 41 What: /sys/fs/f2fs/<disk>/main_blkad 37 What: /sys/fs/f2fs/<disk>/main_blkaddr 42 Date: November 2019 38 Date: November 2019 43 Contact: "Ramon Pantin" <pantin@google.c 39 Contact: "Ramon Pantin" <pantin@google.com> 44 Description: Shows first block address of M !! 40 Description: >> 41 Shows first block address of MAIN area. 45 42 46 What: /sys/fs/f2fs/<disk>/ipu_policy 43 What: /sys/fs/f2fs/<disk>/ipu_policy 47 Date: November 2013 44 Date: November 2013 48 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 45 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 49 Description: Controls the in-place-update p 46 Description: Controls the in-place-update policy. 50 updates in f2fs. User can set: 47 updates in f2fs. User can set: 51 !! 48 0x01: F2FS_IPU_FORCE, 0x02: F2FS_IPU_SSR, 52 ===== =============== ======== !! 49 0x04: F2FS_IPU_UTIL, 0x08: F2FS_IPU_SSR_UTIL, 53 value policy descript !! 50 0x10: F2FS_IPU_FSYNC, 0x20: F2FS_IPU_ASYNC, 54 0x00 DISABLE disable !! 51 0x40: F2FS_IPU_NOCACHE. 55 0x01 FORCE all the << 56 0x02 SSR if SSR m << 57 0x04 UTIL if FS ut << 58 0x08 SSR_UTIL if SSR m << 59 threshol << 60 0x10 FSYNC activate << 61 flash st << 62 # of dir << 63 (=defaul << 64 0x20 ASYNC do IPU g << 65 0x40 NOCACHE disable << 66 0x80 HONOR_OPU_WRITE use OPU << 67 FI_OPU_W << 68 ===== =============== ======== << 69 << 70 Refer segment.h for details. 52 Refer segment.h for details. 71 53 72 What: /sys/fs/f2fs/<disk>/min_ipu_ut 54 What: /sys/fs/f2fs/<disk>/min_ipu_util 73 Date: November 2013 55 Date: November 2013 74 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 56 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 75 Description: Controls the FS utilization co 57 Description: Controls the FS utilization condition for the in-place-update 76 policies. It is used by F2FS_I 58 policies. It is used by F2FS_IPU_UTIL and F2FS_IPU_SSR_UTIL policies. 77 59 78 What: /sys/fs/f2fs/<disk>/min_fsync_ 60 What: /sys/fs/f2fs/<disk>/min_fsync_blocks 79 Date: September 2014 61 Date: September 2014 80 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 62 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 81 Description: Controls the dirty page count 63 Description: Controls the dirty page count condition for the in-place-update 82 policies. 64 policies. 83 65 84 What: /sys/fs/f2fs/<disk>/min_seq_bl 66 What: /sys/fs/f2fs/<disk>/min_seq_blocks 85 Date: August 2018 67 Date: August 2018 86 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 68 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 87 Description: Controls the dirty page count 69 Description: Controls the dirty page count condition for batched sequential 88 writes in writepages. 70 writes in writepages. 89 71 90 What: /sys/fs/f2fs/<disk>/min_hot_bl 72 What: /sys/fs/f2fs/<disk>/min_hot_blocks 91 Date: March 2017 73 Date: March 2017 92 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 74 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 93 Description: Controls the dirty page count 75 Description: Controls the dirty page count condition for redefining hot data. 94 76 95 What: /sys/fs/f2fs/<disk>/min_ssr_se 77 What: /sys/fs/f2fs/<disk>/min_ssr_sections 96 Date: October 2017 78 Date: October 2017 97 Contact: "Chao Yu" <yuchao0@huawei.com> 79 Contact: "Chao Yu" <yuchao0@huawei.com> 98 Description: Controls the free section thre 80 Description: Controls the free section threshold to trigger SSR allocation. 99 If this is large, SSR mode wil 81 If this is large, SSR mode will be enabled early. 100 82 101 What: /sys/fs/f2fs/<disk>/max_small_ 83 What: /sys/fs/f2fs/<disk>/max_small_discards 102 Date: November 2013 84 Date: November 2013 103 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 85 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 104 Description: Controls the issue rate of dis 86 Description: Controls the issue rate of discard commands that consist of small 105 blocks less than 2MB. The cand !! 87 blocks less than 2MB. The candidates to be discarded are cached until 106 checkpoint, and issued by issu !! 88 checkpoint is triggered, and issued during the checkpoint. 107 It is enabled by default. !! 89 By default, it is disabled with 0. 108 << 109 What: /sys/fs/f2fs/<disk>/max_ordere << 110 Date: October 2022 << 111 Contact: "Yangtao Li" <frank.li@vivo.com << 112 Description: Controls the maximum ordered d << 113 Set it to 16 by default. << 114 << 115 What: /sys/fs/f2fs/<disk>/max_discar << 116 Date: December 2021 << 117 Contact: "Konstantin Vyshetsky" <vkon@go << 118 Description: Controls the number of discard << 119 Higher number will allow the d << 120 faster, at the cost of higher << 121 << 122 What: /sys/fs/f2fs/<disk>/min_discar << 123 Date: December 2021 << 124 Contact: "Konstantin Vyshetsky" <vkon@go << 125 Description: Controls the interval the disc << 126 issuing discard requests when << 127 no I/O aware interruptions occ << 128 << 129 What: /sys/fs/f2fs/<disk>/mid_discar << 130 Date: December 2021 << 131 Contact: "Konstantin Vyshetsky" <vkon@go << 132 Description: Controls the interval the disc << 133 issuing discard requests when << 134 an I/O aware interruption occu << 135 << 136 What: /sys/fs/f2fs/<disk>/max_discar << 137 Date: December 2021 << 138 Contact: "Konstantin Vyshetsky" <vkon@go << 139 Description: Controls the interval the disc << 140 no discard operations to be is << 141 90 142 What: /sys/fs/f2fs/<disk>/discard_gr 91 What: /sys/fs/f2fs/<disk>/discard_granularity 143 Date: July 2017 92 Date: July 2017 144 Contact: "Chao Yu" <yuchao0@huawei.com> 93 Contact: "Chao Yu" <yuchao0@huawei.com> 145 Description: Controls discard granularity o 94 Description: Controls discard granularity of inner discard thread. Inner thread 146 will not issue discards with s 95 will not issue discards with size that is smaller than granularity. 147 The unit size is one block(4KB 96 The unit size is one block(4KB), now only support configuring 148 in range of [1, 512]. Default !! 97 in range of [1, 512]. Default value is 4(=16KB). 149 For small devices, default val << 150 98 151 What: /sys/fs/f2fs/<disk>/umount_dis 99 What: /sys/fs/f2fs/<disk>/umount_discard_timeout 152 Date: January 2019 100 Date: January 2019 153 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 101 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 154 Description: Set timeout to issue discard c 102 Description: Set timeout to issue discard commands during umount. 155 Default: 5 secs 103 Default: 5 secs 156 104 157 What: /sys/fs/f2fs/<disk>/pending_di << 158 Date: November 2021 << 159 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 160 Description: Shows the number of pending di << 161 << 162 What: /sys/fs/f2fs/<disk>/max_victim 105 What: /sys/fs/f2fs/<disk>/max_victim_search 163 Date: January 2014 106 Date: January 2014 164 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 107 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 165 Description: Controls the number of trials 108 Description: Controls the number of trials to find a victim segment 166 when conducting SSR and cleani 109 when conducting SSR and cleaning operations. The default value 167 is 4096 which covers 8GB block 110 is 4096 which covers 8GB block address range. 168 111 169 What: /sys/fs/f2fs/<disk>/migration_ 112 What: /sys/fs/f2fs/<disk>/migration_granularity 170 Date: October 2018 113 Date: October 2018 171 Contact: "Chao Yu" <yuchao0@huawei.com> 114 Contact: "Chao Yu" <yuchao0@huawei.com> 172 Description: Controls migration granularity 115 Description: Controls migration granularity of garbage collection on large 173 section, it can let GC move pa 116 section, it can let GC move partial segment{s} of one section 174 in one GC cycle, so that dispe 117 in one GC cycle, so that dispersing heavy overhead GC to 175 multiple lightweight one. 118 multiple lightweight one. 176 119 177 What: /sys/fs/f2fs/<disk>/dir_level 120 What: /sys/fs/f2fs/<disk>/dir_level 178 Date: March 2014 121 Date: March 2014 179 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 122 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 180 Description: Controls the directory level f 123 Description: Controls the directory level for large directory. If a 181 directory has a number of file 124 directory has a number of files, it can reduce the file lookup 182 latency by increasing this dir 125 latency by increasing this dir_level value. Otherwise, it 183 needs to decrease this value t 126 needs to decrease this value to reduce the space overhead. 184 The default value is 0. 127 The default value is 0. 185 128 186 What: /sys/fs/f2fs/<disk>/ram_thresh 129 What: /sys/fs/f2fs/<disk>/ram_thresh 187 Date: March 2014 130 Date: March 2014 188 Contact: "Jaegeuk Kim" <jaegeuk.kim@sams 131 Contact: "Jaegeuk Kim" <jaegeuk.kim@samsung.com> 189 Description: Controls the memory footprint 132 Description: Controls the memory footprint used by free nids and cached 190 nat entries. By default, 1 is 133 nat entries. By default, 1 is set, which indicates 191 10 MB / 1 GB RAM. 134 10 MB / 1 GB RAM. 192 135 >> 136 What: /sys/fs/f2fs/<disk>/batched_trim_sections >> 137 Date: February 2015 >> 138 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> >> 139 Description: Controls the trimming rate in batch mode. >> 140 <deprecated> >> 141 193 What: /sys/fs/f2fs/<disk>/cp_interva 142 What: /sys/fs/f2fs/<disk>/cp_interval 194 Date: October 2015 143 Date: October 2015 195 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 144 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 196 Description: Controls the checkpoint timing 145 Description: Controls the checkpoint timing, set to 60 seconds by default. 197 146 198 What: /sys/fs/f2fs/<disk>/idle_inter 147 What: /sys/fs/f2fs/<disk>/idle_interval 199 Date: January 2016 148 Date: January 2016 200 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 149 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 201 Description: Controls the idle timing of sy 150 Description: Controls the idle timing of system, if there is no FS operation 202 during given interval. 151 during given interval. 203 Set to 5 seconds by default. 152 Set to 5 seconds by default. 204 153 205 What: /sys/fs/f2fs/<disk>/discard_id 154 What: /sys/fs/f2fs/<disk>/discard_idle_interval 206 Date: September 2018 155 Date: September 2018 207 Contact: "Chao Yu" <yuchao0@huawei.com> 156 Contact: "Chao Yu" <yuchao0@huawei.com> 208 Contact: "Sahitya Tummala" <quic_stummal !! 157 Contact: "Sahitya Tummala" <stummala@codeaurora.org> 209 Description: Controls the idle timing of di 158 Description: Controls the idle timing of discard thread given 210 this time interval. 159 this time interval. 211 Default is 5 secs. 160 Default is 5 secs. 212 161 213 What: /sys/fs/f2fs/<disk>/gc_idle_in 162 What: /sys/fs/f2fs/<disk>/gc_idle_interval 214 Date: September 2018 163 Date: September 2018 215 Contact: "Chao Yu" <yuchao0@huawei.com> 164 Contact: "Chao Yu" <yuchao0@huawei.com> 216 Contact: "Sahitya Tummala" <quic_stummal !! 165 Contact: "Sahitya Tummala" <stummala@codeaurora.org> 217 Description: Controls the idle timing for g 166 Description: Controls the idle timing for gc path. Set to 5 seconds by default. 218 167 219 What: /sys/fs/f2fs/<disk>/iostat_ena 168 What: /sys/fs/f2fs/<disk>/iostat_enable 220 Date: August 2017 169 Date: August 2017 221 Contact: "Chao Yu" <yuchao0@huawei.com> 170 Contact: "Chao Yu" <yuchao0@huawei.com> 222 Description: Controls to enable/disable IO 171 Description: Controls to enable/disable IO stat. 223 172 224 What: /sys/fs/f2fs/<disk>/ra_nid_pag 173 What: /sys/fs/f2fs/<disk>/ra_nid_pages 225 Date: October 2015 174 Date: October 2015 226 Contact: "Chao Yu" <chao2.yu@samsung.com 175 Contact: "Chao Yu" <chao2.yu@samsung.com> 227 Description: Controls the count of nid page 176 Description: Controls the count of nid pages to be readaheaded. 228 When building free nids, F2FS 177 When building free nids, F2FS reads NAT blocks ahead for 229 speed up. Default is 0. 178 speed up. Default is 0. 230 179 231 What: /sys/fs/f2fs/<disk>/dirty_nats 180 What: /sys/fs/f2fs/<disk>/dirty_nats_ratio 232 Date: January 2016 181 Date: January 2016 233 Contact: "Chao Yu" <chao2.yu@samsung.com 182 Contact: "Chao Yu" <chao2.yu@samsung.com> 234 Description: Controls dirty nat entries rat 183 Description: Controls dirty nat entries ratio threshold, if current 235 ratio exceeds configured thres 184 ratio exceeds configured threshold, checkpoint will 236 be triggered for flushing dirt 185 be triggered for flushing dirty nat entries. 237 186 238 What: /sys/fs/f2fs/<disk>/lifetime_w 187 What: /sys/fs/f2fs/<disk>/lifetime_write_kbytes 239 Date: January 2016 188 Date: January 2016 240 Contact: "Shuoran Liu" <liushuoran@huawe 189 Contact: "Shuoran Liu" <liushuoran@huawei.com> 241 Description: Shows total written kbytes iss 190 Description: Shows total written kbytes issued to disk. 242 191 243 What: /sys/fs/f2fs/<disk>/features 192 What: /sys/fs/f2fs/<disk>/features 244 Date: July 2017 193 Date: July 2017 245 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 194 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 246 Description: <deprecated: should use /sys/f !! 195 Description: Shows all enabled features in current device. 247 Shows all enabled features in << 248 Supported features: << 249 encryption, blkzoned, extra_at << 250 flexible_inline_xattr, quota_i << 251 verity, sb_checksum, casefold, << 252 << 253 What: /sys/fs/f2fs/<disk>/feature_li << 254 Date: June 2021 << 255 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 256 Description: Expand /sys/fs/f2fs/<disk>/fea << 257 Supported on-disk features: << 258 encryption, block_zoned (aka b << 259 project_quota (aka projquota), << 260 flexible_inline_xattr, quota_i << 261 verity, sb_checksum, casefold, << 262 Note that, pin_file is moved i << 263 << 264 What: /sys/fs/f2fs/features/ << 265 Date: July 2017 << 266 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 267 Description: Shows all enabled kernel featu << 268 Supported features: << 269 encryption, block_zoned, extra << 270 inode_checksum, flexible_inlin << 271 inode_crtime, lost_found, veri << 272 casefold, readonly, compressio << 273 atomic_write, pin_file, encryp << 274 196 275 What: /sys/fs/f2fs/<disk>/inject_rat 197 What: /sys/fs/f2fs/<disk>/inject_rate 276 Date: May 2016 198 Date: May 2016 277 Contact: "Sheng Yong" <shengyong1@huawei 199 Contact: "Sheng Yong" <shengyong1@huawei.com> 278 Description: Controls the injection rate of 200 Description: Controls the injection rate of arbitrary faults. 279 201 280 What: /sys/fs/f2fs/<disk>/inject_typ 202 What: /sys/fs/f2fs/<disk>/inject_type 281 Date: May 2016 203 Date: May 2016 282 Contact: "Sheng Yong" <shengyong1@huawei 204 Contact: "Sheng Yong" <shengyong1@huawei.com> 283 Description: Controls the injection type of 205 Description: Controls the injection type of arbitrary faults. 284 206 285 What: /sys/fs/f2fs/<disk>/dirty_segm 207 What: /sys/fs/f2fs/<disk>/dirty_segments 286 Date: October 2017 208 Date: October 2017 287 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 209 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 288 Description: Shows the number of dirty segm 210 Description: Shows the number of dirty segments. 289 211 290 What: /sys/fs/f2fs/<disk>/reserved_b 212 What: /sys/fs/f2fs/<disk>/reserved_blocks 291 Date: June 2017 213 Date: June 2017 292 Contact: "Chao Yu" <yuchao0@huawei.com> 214 Contact: "Chao Yu" <yuchao0@huawei.com> 293 Description: Controls target reserved block 215 Description: Controls target reserved blocks in system, the threshold 294 is soft, it could exceed curre 216 is soft, it could exceed current available user space. 295 217 296 What: /sys/fs/f2fs/<disk>/current_re 218 What: /sys/fs/f2fs/<disk>/current_reserved_blocks 297 Date: October 2017 219 Date: October 2017 298 Contact: "Yunlong Song" <yunlong.song@hu 220 Contact: "Yunlong Song" <yunlong.song@huawei.com> 299 Contact: "Chao Yu" <yuchao0@huawei.com> 221 Contact: "Chao Yu" <yuchao0@huawei.com> 300 Description: Shows current reserved blocks 222 Description: Shows current reserved blocks in system, it may be temporarily 301 smaller than target_reserved_b 223 smaller than target_reserved_blocks, but will gradually 302 increase to target_reserved_bl 224 increase to target_reserved_blocks when more free blocks are 303 freed by user later. 225 freed by user later. 304 226 305 What: /sys/fs/f2fs/<disk>/gc_urgent 227 What: /sys/fs/f2fs/<disk>/gc_urgent 306 Date: August 2017 228 Date: August 2017 307 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 229 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 308 Description: Do background GC aggressively !! 230 Description: Do background GC agressively when set. When gc_urgent = 1, 309 gc urgent high(1): does GC for !! 231 background thread starts to do GC by given gc_urgent_sleep_time 310 gc_urgent_sleep_time and ignor !! 232 interval. It is set to 0 by default. 311 GC approach and turns SSR mode << 312 gc urgent low(2): lowers the b << 313 order to process outstanding d << 314 little bit aggressively. uses << 315 gc urgent mid(3): does GC forc << 316 gc_urgent_sleep_time and execu << 317 uses cost benefit GC approach. << 318 233 319 What: /sys/fs/f2fs/<disk>/gc_urgent_ 234 What: /sys/fs/f2fs/<disk>/gc_urgent_sleep_time 320 Date: August 2017 235 Date: August 2017 321 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 236 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 322 Description: Controls sleep time of GC urge 237 Description: Controls sleep time of GC urgent mode. Set to 500ms by default. 323 238 324 What: /sys/fs/f2fs/<disk>/readdir_ra 239 What: /sys/fs/f2fs/<disk>/readdir_ra 325 Date: November 2017 240 Date: November 2017 326 Contact: "Sheng Yong" <shengyong1@huawei 241 Contact: "Sheng Yong" <shengyong1@huawei.com> 327 Description: Controls readahead inode block 242 Description: Controls readahead inode block in readdir. Enabled by default. 328 243 329 What: /sys/fs/f2fs/<disk>/gc_pin_fil 244 What: /sys/fs/f2fs/<disk>/gc_pin_file_thresh 330 Date: January 2018 245 Date: January 2018 331 Contact: Jaegeuk Kim <jaegeuk@kernel.org 246 Contact: Jaegeuk Kim <jaegeuk@kernel.org> 332 Description: This indicates how many GC can 247 Description: This indicates how many GC can be failed for the pinned 333 file. If it exceeds this, F2FS 248 file. If it exceeds this, F2FS doesn't guarantee its pinning 334 state. 2048 trials is set by d !! 249 state. 2048 trials is set by default. 335 250 336 What: /sys/fs/f2fs/<disk>/extension_ 251 What: /sys/fs/f2fs/<disk>/extension_list 337 Date: February 2018 !! 252 Date: Feburary 2018 338 Contact: "Chao Yu" <yuchao0@huawei.com> 253 Contact: "Chao Yu" <yuchao0@huawei.com> 339 Description: Used to control configure exte 254 Description: Used to control configure extension list: 340 - Query: cat /sys/fs/f2fs/<dis 255 - Query: cat /sys/fs/f2fs/<disk>/extension_list 341 - Add: echo '[h/c]extension' > 256 - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list 342 - Del: echo '[h/c]!extension' 257 - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list 343 - [h] means add/del hot file e 258 - [h] means add/del hot file extension 344 - [c] means add/del cold file 259 - [c] means add/del cold file extension 345 260 346 What: /sys/fs/f2fs/<disk>/unusable 261 What: /sys/fs/f2fs/<disk>/unusable 347 Date April 2019 262 Date April 2019 348 Contact: "Daniel Rosenberg" <drosen@goog 263 Contact: "Daniel Rosenberg" <drosen@google.com> 349 Description: If checkpoint=disable, it disp 264 Description: If checkpoint=disable, it displays the number of blocks that 350 are unusable. 265 are unusable. 351 If checkpoint=enable it displa !! 266 If checkpoint=enable it displays the enumber of blocks that 352 would be unusable if checkpoin 267 would be unusable if checkpoint=disable were to be set. 353 268 354 What: /sys/fs/f2fs/<disk>/encoding 269 What: /sys/fs/f2fs/<disk>/encoding 355 Date July 2019 270 Date July 2019 356 Contact: "Daniel Rosenberg" <drosen@goog 271 Contact: "Daniel Rosenberg" <drosen@google.com> 357 Description: Displays name and version of t 272 Description: Displays name and version of the encoding set for the filesystem. 358 If no encoding is set, display 273 If no encoding is set, displays (none) 359 274 360 What: /sys/fs/f2fs/<disk>/free_segme 275 What: /sys/fs/f2fs/<disk>/free_segments 361 Date: September 2019 276 Date: September 2019 362 Contact: "Hridya Valsaraju" <hridya@goog 277 Contact: "Hridya Valsaraju" <hridya@google.com> 363 Description: Number of free segments in dis 278 Description: Number of free segments in disk. 364 279 365 What: /sys/fs/f2fs/<disk>/cp_foregro 280 What: /sys/fs/f2fs/<disk>/cp_foreground_calls 366 Date: September 2019 281 Date: September 2019 367 Contact: "Hridya Valsaraju" <hridya@goog 282 Contact: "Hridya Valsaraju" <hridya@google.com> 368 Description: Number of checkpoint operation 283 Description: Number of checkpoint operations performed on demand. Available when 369 CONFIG_F2FS_STAT_FS=y. 284 CONFIG_F2FS_STAT_FS=y. 370 285 371 What: /sys/fs/f2fs/<disk>/cp_backgro 286 What: /sys/fs/f2fs/<disk>/cp_background_calls 372 Date: September 2019 287 Date: September 2019 373 Contact: "Hridya Valsaraju" <hridya@goog 288 Contact: "Hridya Valsaraju" <hridya@google.com> 374 Description: Number of checkpoint operation 289 Description: Number of checkpoint operations performed in the background to 375 free segments. Available when 290 free segments. Available when CONFIG_F2FS_STAT_FS=y. 376 291 377 What: /sys/fs/f2fs/<disk>/gc_foregro 292 What: /sys/fs/f2fs/<disk>/gc_foreground_calls 378 Date: September 2019 293 Date: September 2019 379 Contact: "Hridya Valsaraju" <hridya@goog 294 Contact: "Hridya Valsaraju" <hridya@google.com> 380 Description: Number of garbage collection o 295 Description: Number of garbage collection operations performed on demand. 381 Available when CONFIG_F2FS_STA 296 Available when CONFIG_F2FS_STAT_FS=y. 382 297 383 What: /sys/fs/f2fs/<disk>/gc_backgro 298 What: /sys/fs/f2fs/<disk>/gc_background_calls 384 Date: September 2019 299 Date: September 2019 385 Contact: "Hridya Valsaraju" <hridya@goog 300 Contact: "Hridya Valsaraju" <hridya@google.com> 386 Description: Number of garbage collection o 301 Description: Number of garbage collection operations triggered in background. 387 Available when CONFIG_F2FS_STA 302 Available when CONFIG_F2FS_STAT_FS=y. 388 303 389 What: /sys/fs/f2fs/<disk>/moved_bloc 304 What: /sys/fs/f2fs/<disk>/moved_blocks_foreground 390 Date: September 2019 305 Date: September 2019 391 Contact: "Hridya Valsaraju" <hridya@goog 306 Contact: "Hridya Valsaraju" <hridya@google.com> 392 Description: Number of blocks moved by garb 307 Description: Number of blocks moved by garbage collection in foreground. 393 Available when CONFIG_F2FS_STA 308 Available when CONFIG_F2FS_STAT_FS=y. 394 309 395 What: /sys/fs/f2fs/<disk>/moved_bloc 310 What: /sys/fs/f2fs/<disk>/moved_blocks_background 396 Date: September 2019 311 Date: September 2019 397 Contact: "Hridya Valsaraju" <hridya@goog 312 Contact: "Hridya Valsaraju" <hridya@google.com> 398 Description: Number of blocks moved by garb 313 Description: Number of blocks moved by garbage collection in background. 399 Available when CONFIG_F2FS_STA 314 Available when CONFIG_F2FS_STAT_FS=y. 400 315 401 What: /sys/fs/f2fs/<disk>/avg_vblock 316 What: /sys/fs/f2fs/<disk>/avg_vblocks 402 Date: September 2019 317 Date: September 2019 403 Contact: "Hridya Valsaraju" <hridya@goog 318 Contact: "Hridya Valsaraju" <hridya@google.com> 404 Description: Average number of valid blocks 319 Description: Average number of valid blocks. 405 Available when CONFIG_F2FS_STA 320 Available when CONFIG_F2FS_STAT_FS=y. 406 321 407 What: /sys/fs/f2fs/<disk>/mounted_ti 322 What: /sys/fs/f2fs/<disk>/mounted_time_sec 408 Date: February 2020 323 Date: February 2020 409 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o 324 Contact: "Jaegeuk Kim" <jaegeuk@kernel.org> 410 Description: Show the mounted time in secs 325 Description: Show the mounted time in secs of this partition. 411 << 412 What: /sys/fs/f2fs/<disk>/data_io_fl << 413 Date: April 2020 << 414 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 415 Description: Give a way to attach REQ_META| << 416 given temperature-based bits. << 417 << 418 +-------------------+--------- << 419 | REQ_META | REQ << 420 +------+------+-----+------+-- << 421 | 5 | 4 | 3 | 2 | << 422 +------+------+-----+------+-- << 423 | Cold | Warm | Hot | Cold | W << 424 +------+------+-----+------+-- << 425 << 426 What: /sys/fs/f2fs/<disk>/node_io_fl << 427 Date: June 2020 << 428 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 429 Description: Give a way to attach REQ_META| << 430 given temperature-based bits. << 431 << 432 +-------------------+--------- << 433 | REQ_META | REQ << 434 +------+------+-----+------+-- << 435 | 5 | 4 | 3 | 2 | << 436 +------+------+-----+------+-- << 437 | Cold | Warm | Hot | Cold | W << 438 +------+------+-----+------+-- << 439 << 440 What: /sys/fs/f2fs/<disk>/iostat_per << 441 Date: April 2020 << 442 Contact: "Daeho Jeong" <daehojeong@googl << 443 Description: Give a way to change iostat_pe << 444 The new iostat trace gives sta << 445 What: /sys/fs/f2fs/<disk>/max_io_byt << 446 Date: December 2020 << 447 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 448 Description: This gives a control to limit << 449 Default is zero, which will fo << 450 whereas, if it has a certain b << 451 bio larger than that size. << 452 << 453 What: /sys/fs/f2fs/<disk>/stat/sb_st << 454 Date: December 2020 << 455 Contact: "Chao Yu" <yuchao0@huawei.com> << 456 Description: Show status of f2fs superblock << 457 << 458 ====== ===================== = << 459 value sb status macro d << 460 0x1 SBI_IS_DIRTY d << 461 0x2 SBI_IS_CLOSE s << 462 0x4 SBI_NEED_FSCK n << 463 0x8 SBI_POR_DOING r << 464 0x10 SBI_NEED_SB_WRITE n << 465 0x20 SBI_NEED_CP n << 466 0x40 SBI_IS_SHUTDOWN s << 467 0x80 SBI_IS_RECOVERED r << 468 0x100 SBI_CP_DISABLED C << 469 0x200 SBI_CP_DISABLED_QUICK C << 470 0x400 SBI_QUOTA_NEED_FLUSH n << 471 0x800 SBI_QUOTA_SKIP_FLUSH s << 472 0x1000 SBI_QUOTA_NEED_REPAIR q << 473 0x2000 SBI_IS_RESIZEFS r << 474 0x4000 SBI_IS_FREEZING f << 475 ====== ===================== = << 476 << 477 What: /sys/fs/f2fs/<disk>/stat/cp_st << 478 Date: September 2022 << 479 Contact: "Chao Yu" <chao.yu@oppo.com> << 480 Description: Show status of f2fs checkpoint << 481 << 482 ============================== << 483 cp flag << 484 CP_UMOUNT_FLAG << 485 CP_ORPHAN_PRESENT_FLAG << 486 CP_COMPACT_SUM_FLAG << 487 CP_ERROR_FLAG << 488 CP_FSCK_FLAG << 489 CP_FASTBOOT_FLAG << 490 CP_CRC_RECOVERY_FLAG << 491 CP_NAT_BITS_FLAG << 492 CP_TRIMMED_FLAG << 493 CP_NOCRC_RECOVERY_FLAG << 494 CP_LARGE_NAT_BITMAP_FLAG << 495 CP_QUOTA_NEED_FSCK_FLAG << 496 CP_DISABLED_FLAG << 497 CP_DISABLED_QUICK_FLAG << 498 CP_RESIZEFS_FLAG << 499 ============================== << 500 << 501 What: /sys/fs/f2fs/<disk>/stat/issue << 502 Date: December 2023 << 503 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc << 504 Description: Shows the number of issued dis << 505 << 506 What: /sys/fs/f2fs/<disk>/stat/queue << 507 Date: December 2023 << 508 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc << 509 Description: Shows the number of queued dis << 510 << 511 What: /sys/fs/f2fs/<disk>/stat/undis << 512 Date: December 2023 << 513 Contact: "Zhiguo Niu" <zhiguo.niu@unisoc << 514 Description: Shows the total number of undi << 515 << 516 What: /sys/fs/f2fs/<disk>/ckpt_threa << 517 Date: January 2021 << 518 Contact: "Daeho Jeong" <daehojeong@googl << 519 Description: Give a way to change checkpoin << 520 Its default value is "be,3", w << 521 I/O priority "3". We can selec << 522 and set the I/O priority withi << 523 is necessary in between I/O cl << 524 << 525 What: /sys/fs/f2fs/<disk>/ovp_segmen << 526 Date: March 2021 << 527 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 528 Description: Shows the number of overprovis << 529 << 530 What: /sys/fs/f2fs/<disk>/compr_writ << 531 Date: March 2021 << 532 Contact: "Daeho Jeong" <daehojeong@googl << 533 Description: Show the block count written a << 534 that when the compressed block << 535 decrease. If you write "0" her << 536 compr_written_block and compr_ << 537 << 538 What: /sys/fs/f2fs/<disk>/compr_save << 539 Date: March 2021 << 540 Contact: "Daeho Jeong" <daehojeong@googl << 541 Description: Show the saved block count wit << 542 that when the compressed block << 543 decrease. If you write "0" her << 544 compr_written_block and compr_ << 545 << 546 What: /sys/fs/f2fs/<disk>/compr_new_ << 547 Date: March 2021 << 548 Contact: "Daeho Jeong" <daehojeong@googl << 549 Description: Show the count of inode newly << 550 Note that when the compression << 551 doesn't decrease. If you write << 552 compr_new_inode to "0". << 553 << 554 What: /sys/fs/f2fs/<disk>/atgc_candi << 555 Date: May 2021 << 556 Contact: "Chao Yu" <yuchao0@huawei.com> << 557 Description: When ATGC is on, it controls c << 558 number of potential victim in << 559 range of [0, 100], by default << 560 << 561 What: /sys/fs/f2fs/<disk>/atgc_candi << 562 Date: May 2021 << 563 Contact: "Chao Yu" <yuchao0@huawei.com> << 564 Description: When ATGC is on, it controls c << 565 number of potential victim in << 566 initialized as 10 (sections). << 567 << 568 What: /sys/fs/f2fs/<disk>/atgc_age_w << 569 Date: May 2021 << 570 Contact: "Chao Yu" <yuchao0@huawei.com> << 571 Description: When ATGC is on, it controls a << 572 in between aging and valid blo << 573 [0, 100], by default it was in << 574 << 575 What: /sys/fs/f2fs/<disk>/atgc_age_t << 576 Date: May 2021 << 577 Contact: "Chao Yu" <yuchao0@huawei.com> << 578 Description: When ATGC is on, it controls a << 579 candidates whose age is not be << 580 initialized as 604800 seconds << 581 << 582 What: /sys/fs/f2fs/<disk>/atgc_enabl << 583 Date: Feb 2024 << 584 Contact: "Jinbao Liu" <liujinbao1@xiaomi << 585 Description: It represents whether ATGC is << 586 indicates that ATGC is on, and << 587 << 588 What: /sys/fs/f2fs/<disk>/gc_reclaim << 589 Date: July 2021 << 590 Contact: "Daeho Jeong" <daehojeong@googl << 591 Description: Show how many segments have be << 592 GC mode (0: GC normal, 1: GC i << 593 3: GC idle AT, 4: GC urgent hi << 594 You can re-initialize this val << 595 << 596 What: /sys/fs/f2fs/<disk>/gc_segment << 597 Date: July 2021 << 598 Contact: "Daeho Jeong" <daehojeong@googl << 599 Description: You can control for which gc m << 600 Refer to the description of th << 601 << 602 What: /sys/fs/f2fs/<disk>/seq_file_r << 603 Date: July 2021 << 604 Contact: "Daeho Jeong" <daehojeong@googl << 605 Description: You can control the multiplier << 606 between 2 (default) and 256 fo << 607 << 608 What: /sys/fs/f2fs/<disk>/max_fragme << 609 Date: August 2021 << 610 Contact: "Daeho Jeong" <daehojeong@googl << 611 Description: With "mode=fragment:block" mou << 612 f2fs will allocate 1..<max_fra << 613 in the length of 1..<max_fragm << 614 between 1..512 and the default << 615 << 616 What: /sys/fs/f2fs/<disk>/max_fragme << 617 Date: August 2021 << 618 Contact: "Daeho Jeong" <daehojeong@googl << 619 Description: With "mode=fragment:block" mou << 620 f2fs will allocate 1..<max_fra << 621 in the length of 1..<max_fragm << 622 between 1..512 and the default << 623 << 624 What: /sys/fs/f2fs/<disk>/gc_remaini << 625 Date: October 2022 << 626 Contact: "Yangtao Li" <frank.li@vivo.com << 627 Description: You can set the trial count li << 628 If GC thread gets to the limit << 629 By default, the value is zero, << 630 << 631 What: /sys/fs/f2fs/<disk>/max_roll_f << 632 Date: January 2022 << 633 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 634 Description: Controls max # of node block w << 635 recovery. This can limit the r << 636 << 637 What: /sys/fs/f2fs/<disk>/unusable_b << 638 Date: June 2022 << 639 Contact: "Jaegeuk Kim" <jaegeuk@kernel.o << 640 Description: Shows the number of unusable b << 641 the zone capacity reported by << 642 << 643 What: /sys/fs/f2fs/<disk>/current_at << 644 Date: July 2022 << 645 Contact: "Daeho Jeong" <daehojeong@googl << 646 Description: Show the total current atomic << 647 This is a read-only entry. << 648 << 649 What: /sys/fs/f2fs/<disk>/peak_atomi << 650 Date: July 2022 << 651 Contact: "Daeho Jeong" <daehojeong@googl << 652 Description: Show the peak value of total c << 653 If you write "0" here, you can << 654 << 655 What: /sys/fs/f2fs/<disk>/committed_ << 656 Date: July 2022 << 657 Contact: "Daeho Jeong" <daehojeong@googl << 658 Description: Show the accumulated total com << 659 If you write "0" here, you can << 660 << 661 What: /sys/fs/f2fs/<disk>/revoked_at << 662 Date: July 2022 << 663 Contact: "Daeho Jeong" <daehojeong@googl << 664 Description: Show the accumulated total rev << 665 If you write "0" here, you can << 666 << 667 What: /sys/fs/f2fs/<disk>/gc_mode << 668 Date: October 2022 << 669 Contact: "Yangtao Li" <frank.li@vivo.com << 670 Description: Show the current gc_mode as a << 671 This is a read-only entry. << 672 << 673 What: /sys/fs/f2fs/<disk>/discard_ur << 674 Date: November 2022 << 675 Contact: "Yangtao Li" <frank.li@vivo.com << 676 Description: When space utilization exceeds << 677 Does DISCARD forcibly in a per << 678 of discards is not 0 and set d << 679 Default: 80 << 680 << 681 What: /sys/fs/f2fs/<disk>/hot_data_a << 682 Date: November 2022 << 683 Contact: "Ping Xiong" <xiongping1@xiaomi << 684 Description: When DATA SEPARATION is on, it << 685 the data blocks as hot. By def << 686 (equals to 1GB). << 687 << 688 What: /sys/fs/f2fs/<disk>/warm_data_ << 689 Date: November 2022 << 690 Contact: "Ping Xiong" <xiongping1@xiaomi << 691 Description: When DATA SEPARATION is on, it << 692 the data blocks as warm. By de << 693 (equals to 10GB). << 694 << 695 What: /sys/fs/f2fs/<disk>/fault_rate << 696 Date: May 2016 << 697 Contact: "Sheng Yong" <shengyong@oppo.co << 698 Contact: "Chao Yu" <chao@kernel.org> << 699 Description: Enable fault injection in all << 700 specified injection rate. << 701 << 702 What: /sys/fs/f2fs/<disk>/fault_type << 703 Date: May 2016 << 704 Contact: "Sheng Yong" <shengyong@oppo.co << 705 Contact: "Chao Yu" <chao@kernel.org> << 706 Description: Support configuring fault inje << 707 enabled with fault_injection o << 708 is shown below, it supports si << 709 << 710 =========================== << 711 Type_Name << 712 =========================== << 713 FAULT_KMALLOC << 714 FAULT_KVMALLOC << 715 FAULT_PAGE_ALLOC << 716 FAULT_PAGE_GET << 717 FAULT_ALLOC_BIO << 718 FAULT_ALLOC_NID << 719 FAULT_ORPHAN << 720 FAULT_BLOCK << 721 FAULT_DIR_DEPTH << 722 FAULT_EVICT_INODE << 723 FAULT_TRUNCATE << 724 FAULT_READ_IO << 725 FAULT_CHECKPOINT << 726 FAULT_DISCARD << 727 FAULT_WRITE_IO << 728 FAULT_SLAB_ALLOC << 729 FAULT_DQUOT_INIT << 730 FAULT_LOCK_OP << 731 FAULT_BLKADDR_VALIDITY << 732 FAULT_BLKADDR_CONSISTENCE << 733 FAULT_NO_SEGMENT << 734 =========================== << 735 << 736 What: /sys/fs/f2fs/<disk>/discard_io << 737 Date: January 2023 << 738 Contact: "Yangtao Li" <frank.li@vivo.com << 739 Description: Controls background discard gr << 740 when is not in idle. Inner thr << 741 is smaller than granularity. T << 742 support configuring in range o << 743 Default: 512 << 744 << 745 What: /sys/fs/f2fs/<disk>/last_age_w << 746 Date: January 2023 << 747 Contact: "Ping Xiong" <xiongping1@xiaomi << 748 Description: When DATA SEPARATION is on, it << 749 << 750 What: /sys/fs/f2fs/<disk>/compress_w << 751 Date: February 2023 << 752 Contact: "Yangtao Li" <frank.li@vivo.com << 753 Description: When compress cache is on, it << 754 in order to limit caching comp << 755 than watermark, then deny cach << 756 range of (0, 100], by default << 757 << 758 What: /sys/fs/f2fs/<disk>/compress_p << 759 Date: February 2023 << 760 Contact: "Yangtao Li" <frank.li@vivo.com << 761 Description: When compress cache is on, it << 762 percent(compress pages / free_ << 763 If cached page percent exceed << 764 The value should be in range o << 765 as 20(%). << 766 << 767 What: /sys/fs/f2fs/<disk>/discard_io << 768 Date: November 2023 << 769 Contact: "Chao Yu" <chao@kernel.org> << 770 Description: It controls to enable/disable << 771 By default, the value is 1 whi << 772 << 773 What: /sys/fs/f2fs/<disk>/blkzone_al << 774 Date: July 2024 << 775 Contact: "Yuanhong Liao" <liaoyuanhong@v << 776 Description: The zone UFS we are currently << 777 conventional zones and sequent << 778 to prioritize for writes, with << 779 << 780 ======================== ==== << 781 value << 782 blkzone_alloc_policy = 0 Prio << 783 blkzone_alloc_policy = 1 Only << 784 blkzone_alloc_policy = 2 Prio << 785 ======================== ==== << 786 << 787 What: /sys/fs/f2fs/<disk>/migration_ << 788 Date: September 2024 << 789 Contact: "Daeho Jeong" <daehojeong@googl << 790 Description: Controls migration window gran << 791 section. it can control the sc << 792 in a unit of segment, while mi << 793 of segments which can be migra << 794 << 795 What: /sys/fs/f2fs/<disk>/reserved_s << 796 Date: September 2024 << 797 Contact: "Daeho Jeong" <daehojeong@googl << 798 Description: In order to fine tune GC behav << 799 reserved segments. << 800 << 801 What: /sys/fs/f2fs/<disk>/gc_no_zone << 802 Date: September 2024 << 803 Contact: "Daeho Jeong" <daehojeong@googl << 804 Description: If the percentage of free sect << 805 number, F2FS do not garbage co << 806 background GC thread. the defa << 807 << 808 What: /sys/fs/f2fs/<disk>/gc_boost_z << 809 Date: September 2024 << 810 Contact: "Daeho Jeong" <daehojeong@googl << 811 Description: If the percentage of free sect << 812 number, F2FS boosts garbage co << 813 background GC thread. the defa << 814 << 815 What: /sys/fs/f2fs/<disk>/gc_valid_t << 816 Date: September 2024 << 817 Contact: "Daeho Jeong" <daehojeong@googl << 818 Description: It controls the valid block ra << 819 for zoned deivces. The initial << 820 background GC thread from inti << 821 exceeding the ratio. <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.