TUNE.SSDFS(8)

🌸 TUNE.SSDFS(8) — tune volume of SSDFS file system 🌸

okay bestie, so this is the tune.ssdfs page from section 8 of the manual (System Administration Commands), and it's literally your glow-up toolkit for SSDFS file systems 💅

✨ NAME ✨

tune.ssdfs — tune volume of SSDFS file system

🦋 SYNOPSIS 🦋

tune.ssdfs [options] folder|file

💖 DESCRIPTION 💖

tune.ssdfs adjusts tunable file system parameters on SSDFS file systems. no cap, this little icon lets you modify a whole bunch of file system settings — compression, backup options, and performance parameters. it's giving "makeover montage" for your volume 😭✨

🎀 OPTIONS 🎀

• -B, --blkbmap has_copy=(enable|disable),compression=(none|zlib|lzo) — block bitmap options, bestie. controls the backup copy and compression settings.
• -d, --debug — show debug output. very "let me see the receipts" of it.
• -h, --help — display the help message and exit. always valid, always iconic.
• -g, --get_config — get the current volume configuration and display all tunable parameters. the vibe check of your file system fr fr.
• -L, --label label — set a volume label. name it something cute 🎀
• -M, --maptbl — PEB mapping table options. configure backup copy, log pages, migration threshold, reserved PEBs per fragment (1%–80%), and compression. the parameter string goes exactly like this:

has_copy=(enable|disable),log_pages=value,migration_threshold=value,reserved_pebs_per_fragment=percentage,compression=(none|zlib|lzo)

• -O, --offsets_table has_copy=(enable|disable),compression=(none|zlib|lzo) — offsets table options. controls backup copy and compression settings.
• -S, --segbmap — segment bitmap options. configure backup copy, log pages, migration threshold, and compression. the format is:

has_copy=(enable|disable),log_pages=value,migration_threshold=value,compression=(none|zlib|lzo)

• -T, --btree — btrees' options. configure index area size and log pages for the different node types. here's the exact shape:

min_index_area_size=value,leaf_node_log_pages=value,hybrid_node_log_pages=value,index_node_log_pages=value

• -U, --user_data_segment — user data segment options. configure log pages, migration threshold, and compression. this is the format:

log_pages=value,migration_threshold=value,compression=(none|zlib|lzo)

• -V, --version — print version and exit. short and sweet 🫶

---

💜 TUNABLE PARAMETERS 💜

💾 Backup Copy Options

controls whether backup copies of the critical structures (block bitmap, segment bitmap, mapping table, offsets table) are maintained. options: enable or disable. that's your safety net, bestie — don't be skipping it 🙈

🗜️ Compression Options

sets the compression type for the various file system structures. options: none, zlib, lzo.

📄 Log Pages

configures the number of log pages for the different structures.

🔀 Migration Threshold

sets the maximum number of migration PEBs for segments.

🧩 Reserved PEBs per Fragment

configures the percentage of PEBs reserved per fragment (1%–80%).

---

⭐ EXIT STATUS ⭐

tune.ssdfs exits with status 0 on success, or with non-zero status on error. slay when it works, non-zero when it's a whole situation 😭

🔥 EXAMPLES 🔥

display current configuration:

# tune.ssdfs -g /mnt/ssdfs

set volume label:

# tune.ssdfs -L MyStorage /mnt/ssdfs

enable backup copy for block bitmap with ZLIB compression:

# tune.ssdfs -B has_copy=enable,compression=zlib /mnt/ssdfs

configure mapping table with specific settings:

# tune.ssdfs -M
has_copy=enable,log_pages=16,migration_threshold=10,reserved_pebs_per_fragment=20,compression=lzo
/mnt/ssdfs

set user data segment compression:

# tune.ssdfs -U compression=zlib /mnt/ssdfs

configure btree parameters:

# tune.ssdfs -T min_index_area_size=256,leaf_node_log_pages=8 /mnt/ssdfs

🌈 NOTES 🌈

some parameter changes may require unmounting and remounting the file system to take effect. always backup important data before making configuration changes. i'm so serious — back your data up first, no cap 💀

the reserved PEBs per fragment percentage affects space utilization and performance. higher values provide better wear leveling but reduce available space. so like, it's a trade-off, choose your fighter 🫶

🧚 SEE ALSO 🧚

mkfs.ssdfs(8), fsck.ssdfs(8), dump.ssdfs(8)

👑 AUTHORS 👑

Viacheslav Dubeyko <slava@dubeyko.com>

🍓 COPYRIGHT 🍓

Copyright (c) 2023-2026 Viacheslav Dubeyko

SPDX-License-Identifier: BSD-3-Clause-Clear

---

okay that's the whole page, bestie — go forth and tune your volume 💖✨ this was ssdfs-utils, dated 2025-08-30, and honestly? iconic of it. periodt 🎀