= smarbs

* http://smarbs.sourceforge.net

== DESCRIPTION:

smarbs is a backup script written in ruby capable of doing intelligent and
automated backups using rsync.

== FEATURES/PROBLEMS:

Smarbs was designed to be

* fast
* incremental
* able to take full snapshots
* space managing
* able to handle several sources
* automated

== SYNOPSIS:

Run smarbs --help to see what options you have. The configfiles are stored
in the directory /etc/smarbs or ~/.smarbs, if not executed as root.

= Syslog

Smarbs can log to syslog instead of directly to file. Note, you
should only enable this feature if you know what you are doing, and
have root access.

Example configuration for syslog-ng, this will log everything "smarbs"
into separate file.

destination smarbs { file("/var/log/smarbs.log"
template("$FULLDATE [$LEVEL] $MSG\n")
template_escape(no) );
};
filter f_smarbs { program(smarbs); };
log { source(src); filter(f_smarbs); destination(smarbs); };

To filter out some less important information, try:

filter f_smarbs { program(smarbs) and level(notice..err); };

Also, if you put $ISODATE there instead of $FULLDATE, you will get
date in ISO-standard format.

== REQUIREMENTS:

* Ruby 1.9.1
* rsync
* standard unix tools (du, df, ...)
* optional: ruby-gtk2: For status icon while backupping
* optional: syslog-ng: For syslog functionality


== INSTALL:

* sudo gem install

== DEVELOPERS:

After checking out the source, run:

$ rake newb

This task will install any missing dependencies, run the tests/specs,
and generate the RDoc.

== LICENSE:

(GPL)

Copyright (c) 2009 Jan Rüegg <[email protected]>

Smarbs is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You can find a copy of the GNU General Public License under
http://www.gnu.org/licenses/