S3QLSTAT(1)

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

💖 s3qlstat(1) — bestie edition 💖

okay so this is s3qlstat, straight out of the S3QL manual, and it's about to give you the tea on your file system's stats. pull up a chair 🫶

✨ NAME ✨

s3qlstat — gather S3QL file system statistics 📊

🌸 SYNOPSIS 🌸

s3qlstat [options] <mountpoint>

🦋 DESCRIPTION 🦋

S3QL is a file system for online data storage. and before you go anywhere near it, bestie, please consult the full documentation — not just the man pages, because these man pages are literally just a quick lil' skim of the userspace commands that are available. fr fr, the real lore lives elsewhere.

The s3qlstat command prints statistics about the S3QL file system mounted at mountpoint. that's the whole vibe. you point it at your mount, it spills the numbers. 💅

okay but here's the important bit, and it's giving access control energy: s3qlstat can only be called by the user that mounted the file system — and, if the file system was mounted with --allow-other or --allow-root, the root user. that's it. that's the guest list. no plus-ones. 🙈

💅 OPTIONS 💅

The s3qlstat command accepts the following options:

  • --log <target> — where your log messages go, bestie. Specify none for standard output, or syslog for the system logging daemon. Anything else will be 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 specified modules. use commas to separate multiple modules, or all for everything. debug messages will be written to the target specified by the --log option. 🐛
  • --debug — activate debugging output from all S3QL modules. debug messages will be written to the target specified by the --log option. full main-character debugging energy, no cap. 🔥
  • --quiet — be really quiet 🤫
  • --version — just print program version and exit, that's the entire personality 🎀
  • --raw — do not pretty-print numbers. raw numbers only, no glow-up. ⭐

💀 EXIT CODES 💀

s3qlstat may terminate with the following exit codes:

  • 0 — everything went well. slay. 👑
  • 1 — an unexpected error occurred. This may indicate a bug in the program. 😭
  • 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>

okay that's the whole page, you're officially educated 💖 now go forth and stat responsibly, bestie 🧚

this was s3qlstat from S3QL version 5.2.3, dated Nov 02, 2024 — mwah, love you, bye 🫶✨

📦 where this page comes from