UMOUNT.S3QL(1)

📦 version 5.2.3, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💫 UMOUNT.S3QL(1) 💫

okay bestie, welcome to the umount.s3ql manual page, part of the S3QL manual set 🦋 this is the little command that says "bye babe" to your mounted S3QL file system, and she does it properly, which is more than some other tools can say 👑

✨ NAME ✨

umount.s3ql — unmount an S3QL file system 💅

🌸 SYNOPSIS 🌸

umount.s3ql [options] <mount point>

🎀 DESCRIPTION 🎀

so, S3QL is a file system for online data storage ⭐ and like, before you go using S3QL at all, please please please consult the full documentation, not just the man pages — the man pages are giving "brief summary of the userspace commands" energy and nothing more, ok? 💖

the umount.s3ql command unmounts the S3QL file system that's mounted in the directory mount point, and then it blocks until every last bit of data has been uploaded to the storage backend. no rushing her. she waits. patiently. periodt 🌈

also, important: only the user who mounted the file system with mount.s3ql is able to unmount it with umount.s3ql 🔒 that's the vibe. if you're root and you wanna unmount an S3QL file system that an ordinary user mounted, you have to use the fusermount -u or umount command instead.

🚨 but bestie listen — those commands do not block until all data has been uploaded. so if you use them instead of umount.s3ql, you should manually wait for the mount.s3ql process to terminate before shutting down the system. like, actually wait. don't just yank the power. 💀

👑 OPTIONS 👑

the umount.s3ql command accepts the following options 🫶

  • --log <target> — where your log messages go 💌 specify none for standard output, or syslog for the system logging daemon. anything else gets interpreted as a file name. log files get rotated when they hit 1 MiB, and at most 5 old log files will be kept. Default: None
  • --debug-modules <modules> — activate debugging output from the modules you name 📢 (use commas to separate multiple modules, or all for everything). debug messages get written to whatever target you gave --log.
  • --debug — activate debugging output from all S3QL modules 🔥 debug messages get written to whatever target you gave --log.
  • --quiet — be really quiet 🤫
  • --version — just print program version and exit ✌️
  • --lazy, -z — lazy umount 🦋 detaches the file system immediately, even if there are still open files. the data will be uploaded in the background once all open files have been closed.

💀 EXIT CODES 💀

umount.s3ql may terminate with the following exit codes:

  1. 0 — everything went well 🌟 slay.
  2. 1 — an unexpected error occurred. this may indicate a bug in the program 😭
  3. 2 — invalid command line argument or configuration file key 🙈

🌈 SEE ALSO 🌈

the S3QL homepage is at https://github.com/s3ql/s3ql/ ⭐

the full S3QL documentation should also be installed somewhere on your system — common locations are /usr/share/doc/s3ql or /usr/local/doc/s3ql 🎀

© 2008 Nikolaus Rath <Nikolaus@rath.org>

and that's the whole page, bestie!! this was S3QL version 5.2.3, dated Nov 02, 2024, from the UMOUNT.S3QL(1) manual — go forth and unmount responsibly 💅✨🫶

📦 where this page comes from