'\" t
.\"     Title: SYSTRAQ
.\"    Author: Joost van Baal-Ilić <joostvb-systraq-20151105@mdcc.cx>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: Uku 31 2020
.\"    Manual: systraq User Manual
.\"    Source: systraq
.\"  Language: English
.\"
.TH "SYSTRAQ" "8" "Uku 31 2020" "systraq" "systraq User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systraq \- monitors your system and warns you when files change
.SH "SYNOPSIS"
.HP \w'\fBsystraq\fR\ 'u
\fBsystraq\fR
.SH "DESCRIPTION"
.PP
\fBsystraq\fR
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\&.
.PP
\fBsystraq\fR
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\*(Aq 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\*(Aqs 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)
\fBsystraq\fR
code itself for the details\&.
.PP
We\*(Aqll elaborate on some of the shipped
systraq\&.d/
scripts\&.
.PP
\fB\fIAA\fR\fR\fB\-shellrc\fR
checks for unsafe umask setting in shell startup scripts, or unsafe PATH in these scripts\&.
.PP
\fB\fIAA\fR\fR\fB\-debsums\fR
runs
\fBdebsums\fR, 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\*(Aqt use sha256sum\&. See also the discussion on
\m[blue]\fBproposed release goal: DEBIAN/md5sums for all packages\fR\m[]\&\s-2\u[1]\d\s+2
at the Debian release mailinglist in August 2007 as well as
\m[blue]\fBDebian Bug #268658\fR\m[]\&\s-2\u[2]\d\s+2
for some considerations on this\&.)
.PP
\fB\fIAA\fR\fR\fB\-localdigest\fR
runs
\fBsha256sum\fR
(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\&.
.PP
Of course, you can add your own scripts\&. If you name them
\fB\fIAA\fR\fR\fB\-local\fR, they\*(Aqll never get overwritten by any version of this software\&. If you don\*(Aqt like one of these scripts, you can disable it by removing the symlink, and creating a new symlink with the same name pointing to
\fB/bin/true\fR\&.
.SH "SEE ALSO"
.PP
The systraq Manual, installed in
/usr/share/doc/systraq\&.
.SH "VERSION"
.PP
20201231
.SH "AUTHORS"
.PP
\fBJoost van Baal\-Ilić\fR <\&joostvb\-systraq\-20151105@mdcc\&.cx\&>
.RS 4
Author.
.RE
.PP
\fBLaurent Fousse\fR <\&laurent@komite\&.net\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2001-2020 Joost van Baal-Ilić
.br
.PP
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\&.
.PP
This document is based upon a manual page written by Laurent Fousse for the Debian project\&.
.sp
.SH "NOTES"
.IP " 1." 4

proposed release goal: DEBIAN/md5sums for all
packages
.RS 4
\%http://lists.debian.org/debian-release/2007/08/threads.html#00086
.RE
.IP " 2." 4
Debian Bug
#268658
.RS 4
\%http://bugs.debian.org/268658
.RE