renaming shbackup to sitarba

[sitarba.git] / sitarba.1

diff --git a/sitarba.1 b/sitarba.1
new file mode 100644 (file)
index 0000000..07139cb
--- /dev/null
+++ b/sitarba.1
@@ -0,0 +1,73 @@
+'\" -*- coding: us-ascii -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH sitarba 1 2012-05-13 "" ""
+.SH NAME
+sitarba \- a simple backup solution
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+\fBsitarba\fR \kx
+.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
+'in \n(.iu+\nxu
+[options] {\fIcommand\fR}
+'in \n(.iu-\nxu
+.ad b
+'hy
+.SH DESCRIPTION
+\fBsitarba\fR is a simple backup solution
+which packs user-defined file sets with tar. Each
+backup belongs to an epoch, which is 'sporadic' or one
+of the user-defined epochs. Standard epochs are year,
+month, week, day, or hour. The backup can be made
+either full, differential or incremental.
+\fBsitarba\fR takes care for pruning old
+backups. The user defines for every epoch the number of
+backups to keep, except for 'sporadic'. Sporadic
+backups need to be removed manually.
+.SH COMMANDS
+.TP 
+\*(T<\fBbackup\fR\*(T>
+Make a backup
+.TP 
+\*(T<\fBlist\fR\*(T>
+List all backups
+.TP 
+\*(T<\fBprune\fR\*(T>
+Prune outdated/stale backups
+.SH OPTIONS
+.TP 
+\*(T<\fB\-h, \-\-help\fR\*(T>
+Print out a help summary.
+.TP 
+\*(T<\fB\-c, \-\-conf FILE\fR\*(T>
+Use given configuration file instead of
+/etc/sitarba.conf.
+.TP 
+\*(T<\fB\-e, \-\-epoch EPOCH\fR\*(T>
+Do not determine epoch automatically, but
+use EPOCH, which can be sporadic or one
+of the epochs defined in the
+configuration file.
+.TP 
+\*(T<\fB\-m, \-\-mode MODE\fR\*(T>
+Instead of configured mode use MODE,
+which can be full, diff or incr.
+.TP 
+\*(T<\fB\-v, \-\-verbose\fR\*(T>
+Be more verbose and interact with user.
+Equal to --verbosity info.
+.TP 
+\*(T<\fB\-\-verbosity LEVEL\fR\*(T>
+Set verbosity to LEVEL, which can be
+error, warning, info, debug.
+.TP 
+\*(T<\fB\-V, \-\-version\fR\*(T>
+Print version info.
+.SH AUTHOR
+Stefan HUBER