SNAPSHOTFS.SSDFS(8)

💅 snapshotfs.ssdfs(8) 💅

okay bestie, pull up a chair — this is snapshotfs.ssdfs from section 8, System Administration Commands, and she is the main character of SSDFS snapshot management. ✨

🦋 SYNOPSIS 🦋

snapshotfs.ssdfs [options] folder|file

🌸 DESCRIPTION 🌸

snapshotfs.ssdfs handles snapshots for the SSDFS file system. Like, the whole job. This utility lets you create, modify, list, and delete file system snapshots — all for backup and versioning purposes. That's it, that's the vibe. 🎀

✨ OPTIONS ✨

• -c, --create — create a snapshot, babe. Feed her this parameter string:

name=value,mode=value,type=value,expiration=value,frequency=value,snapshots-threshold=value

and here's what each one means:

• name — the snapshot name
• mode — READ_ONLY or READ_WRITE
• type — PERIODIC or ONE_TIME
• expiration — WEEK, MONTH, YEAR, or NEVER
• frequency — SYNCFS, HOUR, DAY, WEEK, or MONTH
• snapshots-threshold — the maximum number of snapshots

• -d, --debug — show debug output. for when you need to see what's going on 👀
• -h, --help — display the help message and exit. classic.
• -l, --list — show the list of snapshots, with optional filtering by time, mode, type, and maximum number. takes:

minute=value,hour=value,day=value,month=value,year=value,mode=value,type=value,max-number=value

• -m, --modify — change a snapshot's properties. specify the snapshot by name or id, along with timestamp and the new properties:

minute=value,hour=value,day=value,month=value,year=value,name=value,id=value,mode=value,type=value,expiration=value,frequency=value,snapshots-threshold=value

• -r, --remove name=value,id=value — delete a snapshot by name or id. bye bestie 🫶
• -R, --remove-range — delete a whole range of snapshots by timestamp:

minute=value,hour=value,day=value,month=value,year=value

• -s, --show-details name=value,id=value — show a snapshot's details by name or id.
• -V, --version — print the version and exit.

---

👑 SNAPSHOT MODES 👑

• READ_ONLY — the snapshot is read-only and literally cannot be modified.
• READ_WRITE — the snapshot allows read and write operations. go off.

💜 SNAPSHOT TYPES 💜

• ONE_TIME — a single snapshot, created manually.
• PERIODIC — automatic snapshots, created based on frequency.

🎀 EXPIRATION PERIODS 🎀

• WEEK — snapshot expires after one week.
• MONTH — snapshot expires after one month.
• YEAR — snapshot expires after one year.
• NEVER — snapshot never expires automatically. immortal queen behavior ⭐

💀 FREQUENCIES 💀

• SYNCFS — create a snapshot on each sync operation.
• HOUR — create a snapshot every hour.
• DAY — create a snapshot daily.
• WEEK — create a snapshot weekly.
• MONTH — create a snapshot monthly.

🌈 EXIT STATUS 🌈

snapshotfs.ssdfs exits with status 0 on success, or with non-zero status on error. no cap. 🍓

🔥 EXAMPLES 🔥

Create a read-only periodic snapshot:

# snapshotfs.ssdfs -c name=backup1,mode=READ_ONLY,type=PERIODIC,expiration=MONTH,frequency=DAY,snapshots-threshold=30 /mnt/ssdfs

List all snapshots:

# snapshotfs.ssdfs -l max-number=100 /mnt/ssdfs

Show details of a specific snapshot:

# snapshotfs.ssdfs -s name=backup1 /mnt/ssdfs

Remove a snapshot by name:

# snapshotfs.ssdfs -r name=backup1 /mnt/ssdfs

Remove snapshots from a specific date range:

# snapshotfs.ssdfs -R minute=0,hour=0,day=1,month=7,year=2025 /mnt/ssdfs

Modify snapshot properties:

# snapshotfs.ssdfs -m name=backup1,expiration=YEAR,frequency=WEEK /mnt/ssdfs

🧚 SEE ALSO 🧚

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

---

🦋 AUTHORS 🦋

Viacheslav Dubeyko <slava@dubeyko.com> — icon behavior, honestly.

💖 COPYRIGHT 💖

Copyright (c) 2021-2026 Viacheslav Dubeyko
SPDX-License-Identifier: BSD-3-Clause-Clear

---

okay that's the whole page, bestie, you ate that 💅 this little beauty ships as part of ssdfs-utils, dated 2025-08-30, and she's filed under SNAPSHOTFS.SSDFS(8) — go snapshot something iconic. 🎀✨