st_snapshot.hourly(1)
NAME
st_snapshot.hourly - wrapper for st_snapshot
SYNOPSIS
st_snapshot.hourly
DESCRIPTION
st_snapshot.hourly is a wrapper for st_snapshot. st_snapshot.hourly is
to be run from cron.
It checks existence of the files /etc/systraq/i_want_a_broken_systraq
and /etc/systraq/systraq_is_unconfigured . The file
i_want_a_broken_systraq typically is empty; if it exists,
st_snapshot.hourly exits immediately. Existence of this file "breaks"
systraq: systraq will no longer warn when system configuration files
changes, but will remain silent. If systraq_is_unconfigured exists, its
contents are displayed and st_snapshot.hourly exits. The file
systraq_is_unconfigured typically holds instructions on how to
configure systraq, an example systraq_is_unconfigured file is shipped
with the systraq tarball. If both files are missing, st_snapshot is
called with appropriate arguments, either in "root" or in
"public"-mode, depending on the ST_MODE environment variable.
Since the systraq tarball behaves sanely on a fresh default install,
systraq_is_unconfigured is not installed by default. However, people
preparing systraq binary packages typically can make good use of this
file.
When systraq is installed from tarball the systraq cronjobs are not
enabled. One typically enables them after having configured systraq,
especially after the st_snapshot listfiles snapshot_pub.list,
snapshot_pub.homelist, snapshot_root.list and snapshot_root.homelist in
/etc/systraq are created. However, binary systraq packages typically
enable the cronjobs without enforcing one-fits-all listfiles on the
user.
ENVIRONMENT
- ST_MODE
- If set to "root", run st_snapshot in root-mode.
FILES
/etc/systraq/i_want_a_broken_systraq, /etc/systraq/systraq_is_unconfigured.
SEE ALSO
st_snapshot (1), The systraq Manual.
VERSION
$Id: st_snapshot.hourly.dbx 317 2007-03-01 10:02:21Z joostvb $
AUTHOR
- Joost van Baal <joostvb-systraq-20041015@mdcc.cx>
- Author.
COPYRIGHT
Copyright © 2001-2007 Joost van Baal
- 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.