SAUNAFS-GETTRASHTIME(1)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

💖 SAUNAFS-GETTRASHTIME — bestie edition 💖

okay so this is the manual page for SAUNAFS-GETTRASHTIME(1), and honestly? it's giving utility. two little commands that read and write the trashtime of your objects, and if you don't know what trashtime is, don't panic, we're getting there. 🎀

✨ NAME ✨

saunafs-gettrashtime, saunafs-settrashtime — get or set trash time 🗑️⏰

🌸 SYNOPSIS 🌸

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

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

yes bestie, that's the whole shape of it. short. iconic. no notes. 💅

🦋 DESCRIPTION 🦋

so gettrashtime and settrashtime both operate on an object's trashtime value. and what is trashtime, you ask? it's literally the number of seconds the file is preserved in the special trash directory before it gets finally removed from the filesystem. a little grace period. a lil goodbye hug before the file is gone gone. 😭🫶

trashtime must be a non-negative integer value. no negatives, no vibes-based decimals, just a whole number that is zero or more. periodt.

gettrashtime prints the current trashtime value of the object(s) you gave it. that's it. that's the job. and it ate. 💖

👑 OPTIONS 👑

  • -r — turns on recursive mode, which works as usual for every given file, but for every given directory it additionally prints the current trashtime value of all contained objects (files and directories). so it's not just the directory itself, it's everybody inside too. the whole fam. 🌈
  • N[+|-] — okay this one is lowkey the smartest part. if the new value is written in the N+ form, the trashtime value is increased to N for objects with a lower trashtime value, and left unchanged for the rest. similarly, if the new value is written as N-, the trashtime value is decreased to N for objects with a higher trashtime value, and left unchanged for the rest. so it only touches the ones that need touching. respectful. we love a boundary. ✨
these tools can be used on any file, directory, or deleted (trash) file. yes, even the trash files. they're still valid. 🗑️💅
  • -n, -h, -H — these options are described in saunafs(1). go check the main character (the parent manpage) for the lore. 👑 iykyk.

🙈 REPORTING BUGS 🙈

found a bug? not me manifesting that but okay. report bugs to the GitHub repository at:

https://github.com/leil-io/saunafs

as an issue. that's the move. fr fr. 🐛

this is the part where we give credit, and we give it generously, because that's what queens do:

  • 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. (translation: it's free, but if it breaks, that's a you thing, bestie. no cap. 💀)

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 🌟

and that's the whole page!! go forth and set your trashtimes responsibly, bestie. 💖

this lil masterpiece is from the SaunaFS manual, dated 2026-07-29 — slay, stay iconic, and remember: trashtime is forever (until it isn't). 🎀✨💅

📦 where this page comes from