SYSTRAQ(8)

💖 SYSTRAQ 💖

okay bestie, so this is systraq from the systraq User Manual, and it lives in section 8 of the manual (that's the sysadmin-commands zone, very grown-up, very demure) 👑

---

✨ NAME ✨

systraq — monitors your system and warns you when files change 🔍💅

---

🌸 SYNOPSIS 🌸

systraq

---

🦋 DESCRIPTION 🦋

So systraq is part of the systraq package, which is a whole set of scripts that monitors your system for file changes. And no, you don't just run it by hand like some kind of gremlin — it's meant to be run by a cronjob, not directly. periodt.

Here's the vibe: systraq runs a bunch of system commands to inspect the state of your system. Like — what is it doing right now? what has it been doing recently? are we running into hardware limitations?? 👀 On top of that, it runs commands to inspect some files in users' homedirectories, plus some system files, looking for the flaws that show up the most often. All these commands are maintained in little scripts in /etc/systraq/systraq.d.

And here's the iconic little detail: the first two characters of a script's name are what determines the execution-order. Slay. 🎀

Also important: the names of executable files in systraq.d/ (or symlinks pointing at such files) must consist entirely of upper and lower case letters, digits, underscores, and hyphens. Files that don't follow the rules? They get silently ignored. No warning, no drama, just nothing. 💀

The systraq script supplies some environment variables to the scripts in systraq.d/, and ngl those might be super helpful when you're adding your own scripts. For the details, go read the (very small!) systraq code itself. iykyk 📖

Okay now let's elaborate on some of the shipped systraq.d/ scripts, bestie:

• AA-shellrc — checks for unsafe umask setting in shell startup scripts, or unsafe PATH in these scripts. 🐚
• AA-debsums — runs debsums, to check md5sums as stated in packaging files against the sums of the actual files running the system. (NB: debsums has support for md5 checksums only, and most Debian packages ship md5 checksums only. Therefore, we can't use sha256sum. See also the discussion on proposed release goal: DEBIAN/md5sums for all packages[1] at the Debian release mailinglist in August 2007, as well as Debian Bug #268658[2] for some considerations on this.) 🧾
• AA-localdigest — runs sha256sum (or whatever command you set in the ST_SUM environment variable) to check message digests as locally maintained in a file named in the ST_LDIGESTS environment variable. Typically, this is set to /var/lib/systraq/systraq.sums. If this environment variable is unset, this check is silently skipped. 🙈

And of course — you can add your own scripts! 💖 If you name them AA-local, they'll never get overwritten by any version of this software. And if you don't like one of these scripts, you can disable it by removing the symlink, and creating a new symlink with the same name pointing to /bin/true. That's the whole trick, no cap. 🧚

---

🌈 SEE ALSO 🌈

The systraq Manual, installed in /usr/share/doc/systraq. 📚

---

⭐ VERSION ⭐

20201231

---

👑 AUTHORS 👑

• Joost van Baal-Ilić <joostvb-systraq-20151105@mdcc.cx>
  • Author.
• Laurent Fousse <laurent@komite.net>
  • Author.

---

💜 COPYRIGHT 💜

Copyright © 2001-2020 Joost van Baal-Ilić

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

This document is based upon a manual page written by Laurent Fousse for the Debian project. 🫶

---

📝 NOTES 📝

1. proposed release goal: DEBIAN/md5sums for all packages http://lists.debian.org/debian-release/2007/08/threads.html#00086
2. Debian Bug #268658 http://bugs.debian.org/268658

---

and that's the whole page, bestie 💖 go forth and let cron run systraq for you

systraq — Uku 31 2020 — SYSTRAQ(8) 🌸✨🎀