SAUNAFS(1)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

💖 SAUNAFS(1) 💖

okay bestie, so like — saunafs is the open prompt to perform SaunaFS-specific operations. That's the whole vibe. It's your little command hub for all the SaunaFS-flavored stuff (goals, quotas, trash time, attrs, snapshots, the whole ✨menu✨) that regular Unix tools just don't know about. Periodt.

✨ SYNOPSIS ✨

like, here's the full menu of what you can order, no cap:

saunafs getgoal [-r] [-n|-h|-H] OBJECT...

saunafs setgoal [-r] [-n|-h|-H] NAME OBJECT...

saunafs setquota (-u UID | -g GID) SOFT-LIMIT-SIZE HARD-LIMIT-SIZE
              SOFT-LIMIT-INODES HARD-LIMIT-INODES MOUNTPOINT-ROOT-PATH

saunafs repquota [-nhH] (-u UID | -g GID)+ MOUNTPOINT-ROOT-PATH
saunafs repquota [-nhH] -a MOUNTPOINT-ROOT-PATH

saunafs gettrashtime [-r] [-n|-h|-H] OBJECT...

saunafs settrashtime [-r] [-n|-h|-H] [+|-]SECONDS OBJECT...

saunafs geteattr [-r] [-n|-h|-H] OBJECT...

saunafs seteattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

saunafs deleattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

saunafs checkfile FILE...

saunafs fileinfo FILE...

saunafs dirinfo [-n|-h|-H] OBJECT...

saunafs filerepair [-n|-h|-H] FILE...

saunafs appendchunks SNAPSHOT_FILE OBJECT...

saunafs makesnapshot [-o] SOURCE... DESTINATION

saunafs rremove [-l] OBJECT...

🌸 DESCRIPTION 🌸

See respective documents. 🫶

(yes bestie, that's literally it — each subcommand has its own page, the crew split them up so nobody's reading a novel. check SEE ALSO at the bottom, iykyk.)

🎀 GENERAL OPTIONS 🎀

so most saunafs operations let you pick how numbers get printed, and these three cuties are the pickers:

  • -n — print exact numbers, like 1024. no frills, just the raw truth 💅
  • -h — print numbers with binary prefixes (Ki, Mi, Gi — that's 2^10, 2^20 etc.)
  • -H — print numbers with SI prefixes (k, M, G — that's 10^3, 10^6 etc.)

you can get the exact same result by setting the SFSHRFORMAT environment variable to:

  • 0 — exact numbers
  • 1 or h — binary prefixes
  • 2 or H — SI prefixes
  • 3 or h+ — exact numbers and binary prefixes
  • 4 or H+ — exact numbers and SI prefixes

and the default, btw, is just printing exact numbers. no cap.

other options (the rest of the squad):

  • -r — this one enables recursive mode. it goes all the way down 🦋
  • -v, --version — print the version and exit, bye ✌️

🧚 INHERITANCE 🧚

okay this part is lowkey important so listen up. when a new object gets created in SaunaFS, attributes like goal, trashtime and extra attributes are inherited from the parent directory. so if you set, like, the "noowner" attribute and goal to 3 in a directory, then every new object created in that directory comes out with goal set to 3 and the "noowner" flag set. it's giving ✨generational wealth✨ but for metadata.

a newly created object always inherits the current set of its parent's attributes.

⚠️ and here's the catch, bestie: changing a directory attribute does NOT affect children that already exist. those are grown and gone. 🙈

so if you want to change an attribute for a directory and all of its children, you gotta use the -r option. that's the only way to reach them all. periodt.

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, report it to the GitHub repository https://github.com/leil-io/saunafs as an issue. the devs want to know fr fr.

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

SaunaFS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

SaunaFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SaunaFS. If not, see http://www.gnu.org/licenses/.

💜 SEE ALSO 💜

the whole friend group, go say hi:

sfsmount(1), saunafs-appendchunks(1), saunafs-checkfile(1), saunafs-deleattr(1), saunafs-dirinfo(1), saunafs-fileinfo(1), saunafs-filerepair(1), saunafs-geteattr(1), saunafs-getgoal(1), saunafs-gettrashtime(1), saunafs-makesnapshot(1), saunafs-seteattr(1), saunafs-setgoal(1), saunafs-settrashtime(1), saunafs-rremove(1), saunafs-repquota(1), saunafs-setquota(1), sfs(7)

and that's the page bestie!! 🌈 this one's from the SaunaFS crew, dated 2026-07-29, and it lives in section 1 of the manual — so go forth, run saunafs, and slay your filesystem 💅✨

📦 where this page comes from