1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef _BCACHEFS_OPTS_H 3 #define _BCACHEFS_OPTS_H 4 5 #include <linux/bug.h> 6 #include <linux/log2.h> 7 #include <linux/string.h> 8 #include <linux/sysfs.h> 9 #include "bcachefs_format.h" 10 11 struct bch_fs; 12 13 extern const char * const bch2_error_actions[]; 14 extern const char * const bch2_fsck_fix_opts[]; 15 extern const char * const bch2_version_upgrade_opts[]; 16 extern const char * const bch2_sb_features[]; 17 extern const char * const bch2_sb_compat[]; 18 extern const char * const __bch2_btree_ids[]; 19 extern const char * const bch2_csum_opts[]; 20 extern const char * const bch2_compression_opts[]; 21 extern const char * const bch2_str_hash_types[]; 22 extern const char * const bch2_str_hash_opts[]; 23 extern const char * const __bch2_data_types[]; 24 extern const char * const bch2_member_states[]; 25 extern const char * const bch2_d_types[]; 26 27 void bch2_prt_jset_entry_type(struct printbuf *, enum bch_jset_entry_type); 28 void bch2_prt_fs_usage_type(struct printbuf *, enum bch_fs_usage_type); 29 void bch2_prt_data_type(struct printbuf *, enum bch_data_type); 30 void bch2_prt_csum_type(struct printbuf *, enum bch_csum_type); 31 void bch2_prt_compression_type(struct printbuf *, enum bch_compression_type); 32 33 static inline const char *bch2_d_type_str(unsigned d_type) 34 { 35 return (d_type < BCH_DT_MAX ? bch2_d_types[d_type] : NULL) ?: "(bad d_type)"; 36 } 37 38 /* 39 * Mount options; we also store defaults in the superblock. 40 * 41 * Also exposed via sysfs: if an option is writeable, and it's also stored in 42 * the superblock, changing it via sysfs (currently? might change this) also 43 * updates the superblock. 44 * 45 * We store options as signed integers, where -1 means undefined. This means we 46 * can pass the mount options to bch2_fs_alloc() as a whole struct, and then only 47 * apply the options from that struct that are defined. 48 */ 49 50 /* dummy option, for options that aren't stored in the superblock */ 51 u64 BCH2_NO_SB_OPT(const struct bch_sb *); 52 void SET_BCH2_NO_SB_OPT(struct bch_sb *, u64); 53 54 /* When can be set: */ 55 enum opt_flags { 56 OPT_FS = BIT(0), /* Filesystem option */ 57 OPT_DEVICE = BIT(1), /* Device option */ 58 OPT_INODE = BIT(2), /* Inode option */ 59 OPT_FORMAT = BIT(3), /* May be specified at format time */ 60 OPT_MOUNT = BIT(4), /* May be specified at mount time */ 61 OPT_RUNTIME = BIT(5), /* May be specified at runtime */ 62 OPT_HUMAN_READABLE = BIT(6), 63 OPT_MUST_BE_POW_2 = BIT(7), /* Must be power of 2 */ 64 OPT_SB_FIELD_SECTORS = BIT(8), /* Superblock field is >> 9 of actual value */ 65 OPT_SB_FIELD_ILOG2 = BIT(9), /* Superblock field is ilog2 of actual value */ 66 OPT_SB_FIELD_ONE_BIAS = BIT(10), /* 0 means default value */ 67 OPT_HIDDEN = BIT(11), 68 }; 69 70 enum opt_type { 71 BCH_OPT_BOOL, 72 BCH_OPT_UINT, 73 BCH_OPT_STR, 74 BCH_OPT_BITFIELD, 75 BCH_OPT_FN, 76 }; 77 78 struct bch_opt_fn { 79 int (*parse)(struct bch_fs *, const char *, u64 *, struct printbuf *); 80 void (*to_text)(struct printbuf *, struct bch_fs *, struct bch_sb *, u64); 81 int (*validate)(u64, struct printbuf *); 82 }; 83 84 /** 85 * x(name, shortopt, type, in mem type, mode, sb_opt) 86 * 87 * @name - name of mount option, sysfs attribute, and struct bch_opts 88 * member 89 * 90 * @mode - when opt may be set 91 * 92 * @sb_option - name of corresponding superblock option 93 * 94 * @type - one of OPT_BOOL, OPT_UINT, OPT_STR 95 */ 96 97 /* 98 * XXX: add fields for 99 * - default value 100 * - helptext 101 */ 102 103 #ifdef __KERNEL__ 104 #define RATELIMIT_ERRORS_DEFAULT true 105 #else 106 #define RATELIMIT_ERRORS_DEFAULT false 107 #endif 108 109 #ifdef CONFIG_BCACHEFS_DEBUG 110 #define BCACHEFS_VERBOSE_DEFAULT true 111 #else 112 #define BCACHEFS_VERBOSE_DEFAULT false 113 #endif 114 115 #define BCH_FIX_ERRORS_OPTS() \ 116 x(exit, 0) \ 117 x(yes, 1) \ 118 x(no, 2) \ 119 x(ask, 3) 120 121 enum fsck_err_opts { 122 #define x(t, n) FSCK_FIX_##t, 123 BCH_FIX_ERRORS_OPTS() 124 #undef x 125 }; 126 127 #define BCH_OPTS() \ 128 x(block_size, u16, \ 129 OPT_FS|OPT_FORMAT| \ 130 OPT_HUMAN_READABLE|OPT_MUST_BE_POW_2|OPT_SB_FIELD_SECTORS, \ 131 OPT_UINT(512, 1U << 16), \ 132 BCH_SB_BLOCK_SIZE, 8, \ 133 "size", NULL) \ 134 x(btree_node_size, u32, \ 135 OPT_FS|OPT_FORMAT| \ 136 OPT_HUMAN_READABLE|OPT_MUST_BE_POW_2|OPT_SB_FIELD_SECTORS, \ 137 OPT_UINT(512, 1U << 20), \ 138 BCH_SB_BTREE_NODE_SIZE, 512, \ 139 "size", "Btree node size, default 256k") \ 140 x(errors, u8, \ 141 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 142 OPT_STR(bch2_error_actions), \ 143 BCH_SB_ERROR_ACTION, BCH_ON_ERROR_fix_safe, \ 144 NULL, "Action to take on filesystem error") \ 145 x(metadata_replicas, u8, \ 146 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 147 OPT_UINT(1, BCH_REPLICAS_MAX), \ 148 BCH_SB_META_REPLICAS_WANT, 1, \ 149 "#", "Number of metadata replicas") \ 150 x(data_replicas, u8, \ 151 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 152 OPT_UINT(1, BCH_REPLICAS_MAX), \ 153 BCH_SB_DATA_REPLICAS_WANT, 1, \ 154 "#", "Number of data replicas") \ 155 x(metadata_replicas_required, u8, \ 156 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 157 OPT_UINT(1, BCH_REPLICAS_MAX), \ 158 BCH_SB_META_REPLICAS_REQ, 1, \ 159 "#", NULL) \ 160 x(data_replicas_required, u8, \ 161 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 162 OPT_UINT(1, BCH_REPLICAS_MAX), \ 163 BCH_SB_DATA_REPLICAS_REQ, 1, \ 164 "#", NULL) \ 165 x(encoded_extent_max, u32, \ 166 OPT_FS|OPT_FORMAT| \ 167 OPT_HUMAN_READABLE|OPT_MUST_BE_POW_2|OPT_SB_FIELD_SECTORS|OPT_SB_FIELD_ILOG2,\ 168 OPT_UINT(4096, 2U << 20), \ 169 BCH_SB_ENCODED_EXTENT_MAX_BITS, 64 << 10, \ 170 "size", "Maximum size of checksummed/compressed extents")\ 171 x(metadata_checksum, u8, \ 172 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 173 OPT_STR(bch2_csum_opts), \ 174 BCH_SB_META_CSUM_TYPE, BCH_CSUM_OPT_crc32c, \ 175 NULL, NULL) \ 176 x(data_checksum, u8, \ 177 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 178 OPT_STR(bch2_csum_opts), \ 179 BCH_SB_DATA_CSUM_TYPE, BCH_CSUM_OPT_crc32c, \ 180 NULL, NULL) \ 181 x(compression, u8, \ 182 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 183 OPT_FN(bch2_opt_compression), \ 184 BCH_SB_COMPRESSION_TYPE, BCH_COMPRESSION_OPT_none, \ 185 NULL, NULL) \ 186 x(background_compression, u8, \ 187 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 188 OPT_FN(bch2_opt_compression), \ 189 BCH_SB_BACKGROUND_COMPRESSION_TYPE,BCH_COMPRESSION_OPT_none, \ 190 NULL, NULL) \ 191 x(str_hash, u8, \ 192 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 193 OPT_STR(bch2_str_hash_opts), \ 194 BCH_SB_STR_HASH_TYPE, BCH_STR_HASH_OPT_siphash, \ 195 NULL, "Hash function for directory entries and xattrs")\ 196 x(metadata_target, u16, \ 197 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 198 OPT_FN(bch2_opt_target), \ 199 BCH_SB_METADATA_TARGET, 0, \ 200 "(target)", "Device or label for metadata writes") \ 201 x(foreground_target, u16, \ 202 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 203 OPT_FN(bch2_opt_target), \ 204 BCH_SB_FOREGROUND_TARGET, 0, \ 205 "(target)", "Device or label for foreground writes") \ 206 x(background_target, u16, \ 207 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 208 OPT_FN(bch2_opt_target), \ 209 BCH_SB_BACKGROUND_TARGET, 0, \ 210 "(target)", "Device or label to move data to in the background")\ 211 x(promote_target, u16, \ 212 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 213 OPT_FN(bch2_opt_target), \ 214 BCH_SB_PROMOTE_TARGET, 0, \ 215 "(target)", "Device or label to promote data to on read") \ 216 x(erasure_code, u16, \ 217 OPT_FS|OPT_INODE|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 218 OPT_BOOL(), \ 219 BCH_SB_ERASURE_CODE, false, \ 220 NULL, "Enable erasure coding (DO NOT USE YET)") \ 221 x(inodes_32bit, u8, \ 222 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 223 OPT_BOOL(), \ 224 BCH_SB_INODE_32BIT, true, \ 225 NULL, "Constrain inode numbers to 32 bits") \ 226 x(shard_inode_numbers, u8, \ 227 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 228 OPT_BOOL(), \ 229 BCH_SB_SHARD_INUMS, true, \ 230 NULL, "Shard new inode numbers by CPU id") \ 231 x(inodes_use_key_cache, u8, \ 232 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 233 OPT_BOOL(), \ 234 BCH_SB_INODES_USE_KEY_CACHE, true, \ 235 NULL, "Use the btree key cache for the inodes btree") \ 236 x(btree_node_mem_ptr_optimization, u8, \ 237 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 238 OPT_BOOL(), \ 239 BCH2_NO_SB_OPT, true, \ 240 NULL, "Stash pointer to in memory btree node in btree ptr")\ 241 x(gc_reserve_percent, u8, \ 242 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 243 OPT_UINT(5, 21), \ 244 BCH_SB_GC_RESERVE, 8, \ 245 "%", "Percentage of disk space to reserve for copygc")\ 246 x(gc_reserve_bytes, u64, \ 247 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME| \ 248 OPT_HUMAN_READABLE|OPT_SB_FIELD_SECTORS, \ 249 OPT_UINT(0, U64_MAX), \ 250 BCH_SB_GC_RESERVE_BYTES, 0, \ 251 "%", "Amount of disk space to reserve for copygc\n" \ 252 "Takes precedence over gc_reserve_percent if set")\ 253 x(root_reserve_percent, u8, \ 254 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 255 OPT_UINT(0, 100), \ 256 BCH_SB_ROOT_RESERVE, 0, \ 257 "%", "Percentage of disk space to reserve for superuser")\ 258 x(wide_macs, u8, \ 259 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 260 OPT_BOOL(), \ 261 BCH_SB_128_BIT_MACS, false, \ 262 NULL, "Store full 128 bits of cryptographic MACs, instead of 80")\ 263 x(inline_data, u8, \ 264 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 265 OPT_BOOL(), \ 266 BCH2_NO_SB_OPT, true, \ 267 NULL, "Enable inline data extents") \ 268 x(promote_whole_extents, u8, \ 269 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 270 OPT_BOOL(), \ 271 BCH_SB_PROMOTE_WHOLE_EXTENTS, true, \ 272 NULL, "Promote whole extents, instead of just part being read")\ 273 x(acl, u8, \ 274 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 275 OPT_BOOL(), \ 276 BCH_SB_POSIX_ACL, true, \ 277 NULL, "Enable POSIX acls") \ 278 x(usrquota, u8, \ 279 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 280 OPT_BOOL(), \ 281 BCH_SB_USRQUOTA, false, \ 282 NULL, "Enable user quotas") \ 283 x(grpquota, u8, \ 284 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 285 OPT_BOOL(), \ 286 BCH_SB_GRPQUOTA, false, \ 287 NULL, "Enable group quotas") \ 288 x(prjquota, u8, \ 289 OPT_FS|OPT_FORMAT|OPT_MOUNT, \ 290 OPT_BOOL(), \ 291 BCH_SB_PRJQUOTA, false, \ 292 NULL, "Enable project quotas") \ 293 x(degraded, u8, \ 294 OPT_FS|OPT_MOUNT, \ 295 OPT_BOOL(), \ 296 BCH2_NO_SB_OPT, false, \ 297 NULL, "Allow mounting in degraded mode") \ 298 x(very_degraded, u8, \ 299 OPT_FS|OPT_MOUNT, \ 300 OPT_BOOL(), \ 301 BCH2_NO_SB_OPT, false, \ 302 NULL, "Allow mounting in when data will be missing") \ 303 x(no_splitbrain_check, u8, \ 304 OPT_FS|OPT_MOUNT, \ 305 OPT_BOOL(), \ 306 BCH2_NO_SB_OPT, false, \ 307 NULL, "Don't kick drives out when splitbrain detected")\ 308 x(discard, u8, \ 309 OPT_FS|OPT_MOUNT|OPT_DEVICE, \ 310 OPT_BOOL(), \ 311 BCH2_NO_SB_OPT, true, \ 312 NULL, "Enable discard/TRIM support") \ 313 x(verbose, u8, \ 314 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 315 OPT_BOOL(), \ 316 BCH2_NO_SB_OPT, BCACHEFS_VERBOSE_DEFAULT, \ 317 NULL, "Extra debugging information during mount/recovery")\ 318 x(journal_flush_delay, u32, \ 319 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 320 OPT_UINT(1, U32_MAX), \ 321 BCH_SB_JOURNAL_FLUSH_DELAY, 1000, \ 322 NULL, "Delay in milliseconds before automatic journal commits")\ 323 x(journal_flush_disabled, u8, \ 324 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 325 OPT_BOOL(), \ 326 BCH_SB_JOURNAL_FLUSH_DISABLED,false, \ 327 NULL, "Disable journal flush on sync/fsync\n" \ 328 "If enabled, writes can be lost, but only since the\n"\ 329 "last journal write (default 1 second)") \ 330 x(journal_reclaim_delay, u32, \ 331 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 332 OPT_UINT(0, U32_MAX), \ 333 BCH_SB_JOURNAL_RECLAIM_DELAY, 100, \ 334 NULL, "Delay in milliseconds before automatic journal reclaim")\ 335 x(move_bytes_in_flight, u32, \ 336 OPT_HUMAN_READABLE|OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 337 OPT_UINT(1024, U32_MAX), \ 338 BCH2_NO_SB_OPT, 1U << 20, \ 339 NULL, "Maximum Amount of IO to keep in flight by the move path")\ 340 x(move_ios_in_flight, u32, \ 341 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 342 OPT_UINT(1, 1024), \ 343 BCH2_NO_SB_OPT, 32, \ 344 NULL, "Maximum number of IOs to keep in flight by the move path")\ 345 x(fsck, u8, \ 346 OPT_FS|OPT_MOUNT, \ 347 OPT_BOOL(), \ 348 BCH2_NO_SB_OPT, false, \ 349 NULL, "Run fsck on mount") \ 350 x(fsck_memory_usage_percent, u8, \ 351 OPT_FS|OPT_MOUNT, \ 352 OPT_UINT(20, 70), \ 353 BCH2_NO_SB_OPT, 50, \ 354 NULL, "Maximum percentage of system ram fsck is allowed to pin")\ 355 x(fix_errors, u8, \ 356 OPT_FS|OPT_MOUNT, \ 357 OPT_FN(bch2_opt_fix_errors), \ 358 BCH2_NO_SB_OPT, FSCK_FIX_exit, \ 359 NULL, "Fix errors during fsck without asking") \ 360 x(ratelimit_errors, u8, \ 361 OPT_FS|OPT_MOUNT, \ 362 OPT_BOOL(), \ 363 BCH2_NO_SB_OPT, RATELIMIT_ERRORS_DEFAULT, \ 364 NULL, "Ratelimit error messages during fsck") \ 365 x(nochanges, u8, \ 366 OPT_FS|OPT_MOUNT, \ 367 OPT_BOOL(), \ 368 BCH2_NO_SB_OPT, false, \ 369 NULL, "Super read only mode - no writes at all will be issued,\n"\ 370 "even if we have to replay the journal") \ 371 x(norecovery, u8, \ 372 OPT_FS|OPT_MOUNT, \ 373 OPT_BOOL(), \ 374 BCH2_NO_SB_OPT, false, \ 375 NULL, "Exit recovery immediately prior to journal replay")\ 376 x(recovery_passes, u64, \ 377 OPT_FS|OPT_MOUNT, \ 378 OPT_BITFIELD(bch2_recovery_passes), \ 379 BCH2_NO_SB_OPT, 0, \ 380 NULL, "Recovery passes to run explicitly") \ 381 x(recovery_passes_exclude, u64, \ 382 OPT_FS|OPT_MOUNT, \ 383 OPT_BITFIELD(bch2_recovery_passes), \ 384 BCH2_NO_SB_OPT, 0, \ 385 NULL, "Recovery passes to exclude") \ 386 x(recovery_pass_last, u8, \ 387 OPT_FS|OPT_MOUNT, \ 388 OPT_STR_NOLIMIT(bch2_recovery_passes), \ 389 BCH2_NO_SB_OPT, 0, \ 390 NULL, "Exit recovery after specified pass") \ 391 x(retain_recovery_info, u8, \ 392 0, \ 393 OPT_BOOL(), \ 394 BCH2_NO_SB_OPT, false, \ 395 NULL, "Don't free journal entries/keys, scanned btree nodes after startup")\ 396 x(read_entire_journal, u8, \ 397 0, \ 398 OPT_BOOL(), \ 399 BCH2_NO_SB_OPT, false, \ 400 NULL, "Read all journal entries, not just dirty ones")\ 401 x(read_journal_only, u8, \ 402 0, \ 403 OPT_BOOL(), \ 404 BCH2_NO_SB_OPT, false, \ 405 NULL, "Only read the journal, skip the rest of recovery")\ 406 x(journal_transaction_names, u8, \ 407 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 408 OPT_BOOL(), \ 409 BCH_SB_JOURNAL_TRANSACTION_NAMES, true, \ 410 NULL, "Log transaction function names in journal") \ 411 x(allocator_stuck_timeout, u16, \ 412 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME, \ 413 OPT_UINT(0, U16_MAX), \ 414 BCH_SB_ALLOCATOR_STUCK_TIMEOUT, 30, \ 415 NULL, "Default timeout in seconds for stuck allocator messages")\ 416 x(noexcl, u8, \ 417 OPT_FS|OPT_MOUNT, \ 418 OPT_BOOL(), \ 419 BCH2_NO_SB_OPT, false, \ 420 NULL, "Don't open device in exclusive mode") \ 421 x(direct_io, u8, \ 422 OPT_FS|OPT_MOUNT, \ 423 OPT_BOOL(), \ 424 BCH2_NO_SB_OPT, true, \ 425 NULL, "Use O_DIRECT (userspace only)") \ 426 x(sb, u64, \ 427 OPT_MOUNT, \ 428 OPT_UINT(0, S64_MAX), \ 429 BCH2_NO_SB_OPT, BCH_SB_SECTOR, \ 430 "offset", "Sector offset of superblock") \ 431 x(read_only, u8, \ 432 OPT_FS|OPT_MOUNT|OPT_HIDDEN, \ 433 OPT_BOOL(), \ 434 BCH2_NO_SB_OPT, false, \ 435 NULL, NULL) \ 436 x(nostart, u8, \ 437 0, \ 438 OPT_BOOL(), \ 439 BCH2_NO_SB_OPT, false, \ 440 NULL, "Don\'t start filesystem, only open devices") \ 441 x(reconstruct_alloc, u8, \ 442 OPT_FS|OPT_MOUNT, \ 443 OPT_BOOL(), \ 444 BCH2_NO_SB_OPT, false, \ 445 NULL, "Reconstruct alloc btree") \ 446 x(version_upgrade, u8, \ 447 OPT_FS|OPT_MOUNT, \ 448 OPT_STR(bch2_version_upgrade_opts), \ 449 BCH_SB_VERSION_UPGRADE, BCH_VERSION_UPGRADE_compatible, \ 450 NULL, "Set superblock to latest version,\n" \ 451 "allowing any new features to be used") \ 452 x(stdio, u64, \ 453 0, \ 454 OPT_UINT(0, S64_MAX), \ 455 BCH2_NO_SB_OPT, false, \ 456 NULL, "Pointer to a struct stdio_redirect") \ 457 x(project, u8, \ 458 OPT_INODE, \ 459 OPT_BOOL(), \ 460 BCH2_NO_SB_OPT, false, \ 461 NULL, NULL) \ 462 x(nocow, u8, \ 463 OPT_FS|OPT_FORMAT|OPT_MOUNT|OPT_RUNTIME|OPT_INODE, \ 464 OPT_BOOL(), \ 465 BCH_SB_NOCOW, false, \ 466 NULL, "Nocow mode: Writes will be done in place when possible.\n"\ 467 "Snapshots and reflink will still caused writes to be COW\n"\ 468 "Implicitly disables data checksumming, compression and encryption")\ 469 x(nocow_enabled, u8, \ 470 OPT_FS|OPT_MOUNT, \ 471 OPT_BOOL(), \ 472 BCH2_NO_SB_OPT, true, \ 473 NULL, "Enable nocow mode: enables runtime locking in\n"\ 474 "data move path needed if nocow will ever be in use\n")\ 475 x(no_data_io, u8, \ 476 OPT_MOUNT, \ 477 OPT_BOOL(), \ 478 BCH2_NO_SB_OPT, false, \ 479 NULL, "Skip submit_bio() for data reads and writes, " \ 480 "for performance testing purposes") \ 481 x(fs_size, u64, \ 482 OPT_DEVICE, \ 483 OPT_UINT(0, S64_MAX), \ 484 BCH2_NO_SB_OPT, 0, \ 485 "size", "Size of filesystem on device") \ 486 x(bucket, u32, \ 487 OPT_DEVICE, \ 488 OPT_UINT(0, S64_MAX), \ 489 BCH2_NO_SB_OPT, 0, \ 490 "size", "Size of filesystem on device") \ 491 x(durability, u8, \ 492 OPT_DEVICE|OPT_SB_FIELD_ONE_BIAS, \ 493 OPT_UINT(0, BCH_REPLICAS_MAX), \ 494 BCH2_NO_SB_OPT, 1, \ 495 "n", "Data written to this device will be considered\n"\ 496 "to have already been replicated n times") \ 497 x(data_allowed, u8, \ 498 OPT_DEVICE, \ 499 OPT_BITFIELD(__bch2_data_types), \ 500 BCH2_NO_SB_OPT, BIT(BCH_DATA_journal)|BIT(BCH_DATA_btree)|BIT(BCH_DATA_user),\ 501 "types", "Allowed data types for this device: journal, btree, and/or user")\ 502 x(btree_node_prefetch, u8, \ 503 OPT_FS|OPT_MOUNT|OPT_RUNTIME, \ 504 OPT_BOOL(), \ 505 BCH2_NO_SB_OPT, true, \ 506 NULL, "BTREE_ITER_prefetch casuse btree nodes to be\n"\ 507 " prefetched sequentially") 508 509 #define BCH_DEV_OPT_SETTERS() \ 510 x(discard, BCH_MEMBER_DISCARD) \ 511 x(durability, BCH_MEMBER_DURABILITY) \ 512 x(data_allowed, BCH_MEMBER_DATA_ALLOWED) 513 514 struct bch_opts { 515 #define x(_name, _bits, ...) unsigned _name##_defined:1; 516 BCH_OPTS() 517 #undef x 518 519 #define x(_name, _bits, ...) _bits _name; 520 BCH_OPTS() 521 #undef x 522 }; 523 524 struct bch2_opts_parse { 525 struct bch_opts opts; 526 527 /* to save opts that can't be parsed before the FS is opened: */ 528 struct printbuf parse_later; 529 }; 530 531 static const __maybe_unused struct bch_opts bch2_opts_default = { 532 #define x(_name, _bits, _mode, _type, _sb_opt, _default, ...) \ 533 ._name##_defined = true, \ 534 ._name = _default, \ 535 536 BCH_OPTS() 537 #undef x 538 }; 539 540 #define opt_defined(_opts, _name) ((_opts)._name##_defined) 541 542 #define opt_get(_opts, _name) \ 543 (opt_defined(_opts, _name) ? (_opts)._name : bch2_opts_default._name) 544 545 #define opt_set(_opts, _name, _v) \ 546 do { \ 547 (_opts)._name##_defined = true; \ 548 (_opts)._name = _v; \ 549 } while (0) 550 551 static inline struct bch_opts bch2_opts_empty(void) 552 { 553 return (struct bch_opts) { 0 }; 554 } 555 556 void bch2_opts_apply(struct bch_opts *, struct bch_opts); 557 558 enum bch_opt_id { 559 #define x(_name, ...) Opt_##_name, 560 BCH_OPTS() 561 #undef x 562 bch2_opts_nr 563 }; 564 565 struct bch_fs; 566 struct printbuf; 567 568 struct bch_option { 569 struct attribute attr; 570 u64 (*get_sb)(const struct bch_sb *); 571 void (*set_sb)(struct bch_sb *, u64); 572 enum opt_type type; 573 enum opt_flags flags; 574 u64 min, max; 575 576 const char * const *choices; 577 578 struct bch_opt_fn fn; 579 580 const char *hint; 581 const char *help; 582 583 }; 584 585 extern const struct bch_option bch2_opt_table[]; 586 587 bool bch2_opt_defined_by_id(const struct bch_opts *, enum bch_opt_id); 588 u64 bch2_opt_get_by_id(const struct bch_opts *, enum bch_opt_id); 589 void bch2_opt_set_by_id(struct bch_opts *, enum bch_opt_id, u64); 590 591 u64 bch2_opt_from_sb(struct bch_sb *, enum bch_opt_id); 592 int bch2_opts_from_sb(struct bch_opts *, struct bch_sb *); 593 void __bch2_opt_set_sb(struct bch_sb *, int, const struct bch_option *, u64); 594 595 struct bch_dev; 596 void bch2_opt_set_sb(struct bch_fs *, struct bch_dev *, const struct bch_option *, u64); 597 598 int bch2_opt_lookup(const char *); 599 int bch2_opt_validate(const struct bch_option *, u64, struct printbuf *); 600 int bch2_opt_parse(struct bch_fs *, const struct bch_option *, 601 const char *, u64 *, struct printbuf *); 602 603 #define OPT_SHOW_FULL_LIST (1 << 0) 604 #define OPT_SHOW_MOUNT_STYLE (1 << 1) 605 606 void bch2_opt_to_text(struct printbuf *, struct bch_fs *, struct bch_sb *, 607 const struct bch_option *, u64, unsigned); 608 void bch2_opts_to_text(struct printbuf *, 609 struct bch_opts, 610 struct bch_fs *, struct bch_sb *, 611 unsigned, unsigned, unsigned); 612 613 int bch2_opt_check_may_set(struct bch_fs *, int, u64); 614 int bch2_opts_check_may_set(struct bch_fs *); 615 int bch2_parse_one_mount_opt(struct bch_fs *, struct bch_opts *, 616 struct printbuf *, const char *, const char *); 617 int bch2_parse_mount_opts(struct bch_fs *, struct bch_opts *, struct printbuf *, 618 char *); 619 620 /* inode opts: */ 621 622 struct bch_io_opts { 623 #define x(_name, _bits) u##_bits _name; 624 BCH_INODE_OPTS() 625 #undef x 626 }; 627 628 static inline unsigned background_compression(struct bch_io_opts opts) 629 { 630 return opts.background_compression ?: opts.compression; 631 } 632 633 struct bch_io_opts bch2_opts_to_inode_opts(struct bch_opts); 634 bool bch2_opt_is_inode_opt(enum bch_opt_id); 635 636 #endif /* _BCACHEFS_OPTS_H */ 637