NAME

       systraq - monitors your system and warns you when files change

SYNOPSIS

       systraq

DESCRIPTION

       systraq is part of the systraq package, a set of scripts that monitors your system for
       file changes. It is meant to be run by a cronjob, not directly.

       systraq runs various system commands, to inspect the state of the system: what is it doing
       now?, what has it been doing recently?, are we running to hardware limitations?.
       Furthermore, it runs commands to inspect some files in users' homedirectories, as well as
       some system files, for frequently seen flaws. All these commands are maintained in little
       scripts in /etc/systraq/systraq.d. The first two characters of the script's name are used
       for the execution-order. The names of executable files in systraq.d/ (or symlinks to such
       files) must consist entirely of upper and lower case letters, digits, underscores, and
       hyphens. Files which not adhere will be silently ignored. The systraq script supplies some
       environment variables to the scripts in systraq.d/, these might be helpful when adding
       your own scripts. Refer to the (very small) systraq code itself for the details.

       We'll elaborate on some of the shipped systraq.d/ scripts.

       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 with the sums of
       the actual files running the system. (NB: debsums has support for md5 checksums only, 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 the command 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 silenty skipped.

       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. 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.

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