Documentation/ABI/testing/sysfs-fs-f2fs

   1 What:           /sys/fs/f2fs/<disk>/gc_max_sleep_time
   2 Date:           July 2013
   3 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
   4 Description:
   5                  Controls the maximun sleep time for gc_thread. Time
   6                  is in milliseconds.
   7
   8 What:           /sys/fs/f2fs/<disk>/gc_min_sleep_time
   9 Date:           July 2013
  10 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
  11 Description:
  12                  Controls the minimum sleep time for gc_thread. Time
  13                  is in milliseconds.
  14
  15 What:           /sys/fs/f2fs/<disk>/gc_no_gc_sleep_time
  16 Date:           July 2013
  17 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
  18 Description:
  19                  Controls the default sleep time for gc_thread. Time
  20                  is in milliseconds.
  21
  22 What:           /sys/fs/f2fs/<disk>/gc_idle
  23 Date:           July 2013
  24 Contact:        "Namjae Jeon" <namjae.jeon@samsung.com>
  25 Description:
  26                  Controls the victim selection policy for garbage collection.
  27
  28 What:           /sys/fs/f2fs/<disk>/reclaim_segments
  29 Date:           October 2013
  30 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
  31 Description:
  32                  Controls the issue rate of segment discard commands.
  33
  34 What:           /sys/fs/f2fs/<disk>/ipu_policy
  35 Date:           November 2013
  36 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
  37 Description:
  38                  Controls the in-place-update policy.
  39
  40 What:           /sys/fs/f2fs/<disk>/min_ipu_util
  41 Date:           November 2013
  42 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
  43 Description:
  44                  Controls the FS utilization condition for the in-place-update
  45                  policies.
  46
  47 What:           /sys/fs/f2fs/<disk>/min_fsync_blocks
  48 Date:           September 2014
  49 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
  50 Description:
  51                  Controls the dirty page count condition for the in-place-update
  52                  policies.
  53
  54 What:           /sys/fs/f2fs/<disk>/min_seq_blocks
  55 Date:           August 2018
  56 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
  57 Description:
  58                  Controls the dirty page count condition for batched sequential
  59                  writes in ->writepages.
  60
  61
  62 What:           /sys/fs/f2fs/<disk>/min_hot_blocks
  63 Date:           March 2017
  64 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
  65 Description:
  66                  Controls the dirty page count condition for redefining hot data.
  67
  68 What:           /sys/fs/f2fs/<disk>/min_ssr_sections
  69 Date:           October 2017
  70 Contact:        "Chao Yu" <yuchao0@huawei.com>
  71 Description:
  72                  Controls the fee section threshold to trigger SSR allocation.
  73
  74 What:           /sys/fs/f2fs/<disk>/max_small_discards
  75 Date:           November 2013
  76 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
  77 Description:
  78                  Controls the issue rate of small discard commands.
  79
  80 What:          /sys/fs/f2fs/<disk>/discard_granularity
  81 Date:          July 2017
  82 Contact:       "Chao Yu" <yuchao0@huawei.com>
  83 Description:
  84                 Controls discard granularity of inner discard thread, inner thread
  85                 will not issue discards with size that is smaller than granularity.
  86                 The unit size is one block, now only support configuring in range
  87                 of [1, 512].
  88
  89 What:          /sys/fs/f2fs/<disk>/umount_discard_timeout
  90 Date:          January 2019
  91 Contact:       "Jaegeuk Kim" <jaegeuk@kernel.org>
  92 Description:
  93                 Set timeout to issue discard commands during umount.
  94                 Default: 5 secs
  95
  96 What:           /sys/fs/f2fs/<disk>/max_victim_search
  97 Date:           January 2014
  98 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
  99 Description:
 100                  Controls the number of trials to find a victim segment.
 101
 102 What:           /sys/fs/f2fs/<disk>/migration_granularity
 103 Date:           October 2018
 104 Contact:        "Chao Yu" <yuchao0@huawei.com>
 105 Description:
 106                  Controls migration granularity of garbage collection on large
 107                  section, it can let GC move partial segment{s} of one section
 108                  in one GC cycle, so that dispersing heavy overhead GC to
 109                  multiple lightweight one.
 110
 111 What:           /sys/fs/f2fs/<disk>/dir_level
 112 Date:           March 2014
 113 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
 114 Description:
 115                  Controls the directory level for large directory.
 116
 117 What:           /sys/fs/f2fs/<disk>/ram_thresh
 118 Date:           March 2014
 119 Contact:        "Jaegeuk Kim" <jaegeuk.kim@samsung.com>
 120 Description:
 121                  Controls the memory footprint used by f2fs.
 122
 123 What:           /sys/fs/f2fs/<disk>/batched_trim_sections
 124 Date:           February 2015
 125 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 126 Description:
 127                  Controls the trimming rate in batch mode.
 128                  <deprecated>
 129
 130 What:           /sys/fs/f2fs/<disk>/cp_interval
 131 Date:           October 2015
 132 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 133 Description:
 134                  Controls the checkpoint timing.
 135
 136 What:           /sys/fs/f2fs/<disk>/idle_interval
 137 Date:           January 2016
 138 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 139 Description:
 140                  Controls the idle timing for all paths other than
 141                  discard and gc path.
 142
 143 What:           /sys/fs/f2fs/<disk>/discard_idle_interval
 144 Date:           September 2018
 145 Contact:        "Chao Yu" <yuchao0@huawei.com>
 146 Contact:        "Sahitya Tummala" <stummala@codeaurora.org>
 147 Description:
 148                  Controls the idle timing for discard path.
 149
 150 What:           /sys/fs/f2fs/<disk>/gc_idle_interval
 151 Date:           September 2018
 152 Contact:        "Chao Yu" <yuchao0@huawei.com>
 153 Contact:        "Sahitya Tummala" <stummala@codeaurora.org>
 154 Description:
 155                  Controls the idle timing for gc path.
 156
 157 What:           /sys/fs/f2fs/<disk>/iostat_enable
 158 Date:           August 2017
 159 Contact:        "Chao Yu" <yuchao0@huawei.com>
 160 Description:
 161                  Controls to enable/disable IO stat.
 162
 163 What:           /sys/fs/f2fs/<disk>/ra_nid_pages
 164 Date:           October 2015
 165 Contact:        "Chao Yu" <chao2.yu@samsung.com>
 166 Description:
 167                  Controls the count of nid pages to be readaheaded.
 168
 169 What:           /sys/fs/f2fs/<disk>/dirty_nats_ratio
 170 Date:           January 2016
 171 Contact:        "Chao Yu" <chao2.yu@samsung.com>
 172 Description:
 173                  Controls dirty nat entries ratio threshold, if current
 174                  ratio exceeds configured threshold, checkpoint will
 175                  be triggered for flushing dirty nat entries.
 176
 177 What:           /sys/fs/f2fs/<disk>/lifetime_write_kbytes
 178 Date:           January 2016
 179 Contact:        "Shuoran Liu" <liushuoran@huawei.com>
 180 Description:
 181                  Shows total written kbytes issued to disk.
 182
 183 What:           /sys/fs/f2fs/<disk>/features
 184 Date:           July 2017
 185 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 186 Description:
 187                  Shows all enabled features in current device.
 188
 189 What:           /sys/fs/f2fs/<disk>/inject_rate
 190 Date:           May 2016
 191 Contact:        "Sheng Yong" <shengyong1@huawei.com>
 192 Description:
 193                  Controls the injection rate.
 194
 195 What:           /sys/fs/f2fs/<disk>/inject_type
 196 Date:           May 2016
 197 Contact:        "Sheng Yong" <shengyong1@huawei.com>
 198 Description:
 199                  Controls the injection type.
 200
 201 What:           /sys/fs/f2fs/<disk>/reserved_blocks
 202 Date:           June 2017
 203 Contact:        "Chao Yu" <yuchao0@huawei.com>
 204 Description:
 205                  Controls target reserved blocks in system, the threshold
 206                  is soft, it could exceed current available user space.
 207
 208 What:           /sys/fs/f2fs/<disk>/current_reserved_blocks
 209 Date:           October 2017
 210 Contact:        "Yunlong Song" <yunlong.song@huawei.com>
 211 Contact:        "Chao Yu" <yuchao0@huawei.com>
 212 Description:
 213                  Shows current reserved blocks in system, it may be temporarily
 214                  smaller than target_reserved_blocks, but will gradually
 215                  increase to target_reserved_blocks when more free blocks are
 216                  freed by user later.
 217
 218 What:           /sys/fs/f2fs/<disk>/gc_urgent
 219 Date:           August 2017
 220 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 221 Description:
 222                  Do background GC agressively
 223
 224 What:           /sys/fs/f2fs/<disk>/gc_urgent_sleep_time
 225 Date:           August 2017
 226 Contact:        "Jaegeuk Kim" <jaegeuk@kernel.org>
 227 Description:
 228                  Controls sleep time of GC urgent mode
 229
 230 What:           /sys/fs/f2fs/<disk>/readdir_ra
 231 Date:           November 2017
 232 Contact:        "Sheng Yong" <shengyong1@huawei.com>
 233 Description:
 234                  Controls readahead inode block in readdir.
 235
 236 What:           /sys/fs/f2fs/<disk>/extension_list
 237 Date:           Feburary 2018
 238 Contact:        "Chao Yu" <yuchao0@huawei.com>
 239 Description:
 240                  Used to control configure extension list:
 241                  - Query: cat /sys/fs/f2fs/<disk>/extension_list
 242                  - Add: echo '[h/c]extension' > /sys/fs/f2fs/<disk>/extension_list
 243                  - Del: echo '[h/c]!extension' > /sys/fs/f2fs/<disk>/extension_list
 244                  - [h] means add/del hot file extension
 245                  - [c] means add/del cold file extension