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