summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore3
-rw-r--r--Makefile45
-rwxr-xr-xbackup.in (renamed from backup)12
-rw-r--r--hardlinkedbackups.8.in57
-rwxr-xr-xlastBackups.in (renamed from lastBackups)4
5 files changed, 115 insertions, 6 deletions
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3ca840a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+backup
+hardlinkedbackups.8
+lastBackups
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..bc36af5
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,45 @@
+#
+# hardlinkedbackups - generates hardlinked incremental backups via rsync (and possibly through a SOCKS-tunnel via ssh)
+#
+# Copyright (c) 2013-2016 Erich Eckner <opensource at eckner dot net>
+#
+# This program 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 2 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 should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
+# USA.
+#
+
+DESTDIR =
+ETCDIR = /etc
+BINDIR = /usr/bin
+MANDIR = /usr/share/man
+
+VERSION = 1.0.2
+
+all: hardlinkedbackups.8 backup lastBackups
+
+%: %.in
+ sed "s/#VERSION#/$(VERSION)/; s@#BINDIR#@$(BINDIR)@; s@#ETCDIR#@$(ETCDIR)@" $< > $@
+
+.PHONY: install dist clean
+
+install: all
+ install -D -m0755 -t $(DESTDIR)$(BINDIR) backup lastBackups
+ install -D -m0644 -t $(DESTDIR)$(MANDIR)/man8 hardlinkedbackups.8
+ ln -S $(DESTDIR)$(MANDIR)/man8/{hardlinkedbackups,backups,lastBackups}.8
+ install -D -m0644 -t $(DESTDIR)$(ETCDIR)/backup.conf
+
+clean:
+ rm -f backup lastBackups hardlinkedbackups.8
+
+# End of file
diff --git a/backup b/backup.in
index f6501dc..fdc467e 100755
--- a/backup
+++ b/backup.in
@@ -1,13 +1,15 @@
#!/bin/bash
-. /etc/backup.conf
+. #ETCDIR#/backup.conf
usage()
{
- echo 'usage:'
- echo ' backup /tmp/pidFile /path/to/destination/ user@source:path'
- echo ' backup /tmp/pidFile /path/to/destination/ user@source:path proxy_user@ssh_host'
- echo 'or as a symlink (e.g. in /etc/cron/daily) named after a key of $backups in /etc/backup.conf without arguments'
+ >&2 echo 'This is backup version #VERSION#'
+ >&2 echo ''
+ >&2 echo 'usage:'
+ >&2 echo ' backup /tmp/pidFile /path/to/destination/ user@source:path'
+ >&2 echo ' backup /tmp/pidFile /path/to/destination/ user@source:path proxy_user@ssh_host'
+ >&2 echo 'or as a symlink (e.g. in /etc/cron/daily) named after a key of $backups in #ETCDIR#/backup.conf without arguments'
exit 1
}
diff --git a/hardlinkedbackups.8.in b/hardlinkedbackups.8.in
new file mode 100644
index 0000000..c634fd9
--- /dev/null
+++ b/hardlinkedbackups.8.in
@@ -0,0 +1,57 @@
+.TH hardlinkedbackups 8 "" "hardlinkedbackups #VERSION#" ""
+.SH NAME
+hardlinkedbackups \- hardlinked incremental backups via rsync (and possibly through a SOCKS\-tunnel via ssh)
+.SH SYNOPSIS
+.TP
+\fBbackup /tmp/pidFile /path/to/destination/ user@source:path [proxy_user@ssh_host]\fP
+.TP
+\fBlastBackups\fP
+.SH DESCRIPTION
+\fBbackup\fP generates incremental backups (by hardlinking old unchanged files) via rsync and possibly a SOCKS\-tunnel.
+\fBlastBackups\fP shows date of backups and warns about outdated ones.
+.SH USAGE
+.TP
+.B "backup /tmp/pidFile /path/to/destination/ user@source:path"
+Creates incremental backup in \fB/path/to/destination/\fP from \fBuser@source:path\fP, saving its PID in \fB/tmp/pidFile\fP.
+.TP
+.B "backup /tmp/pidFile /path/to/destination/ user@source:path proxy_user@ssh_host"
+Same as above, but tunneling via SSH through \fBproxy_user@ssh_host\fP.
+.TP
+.B "symLinkName -> #BINDIR#/backup"
+Same as one of the above.
+Command line parameters are filled from variable \fB$backups["symLinkName"]\fP in \fB#ETCDIR#/backup.conf\fP.
+This is designed to be called from a cron daemon for daily backups.
+.TP
+.B "lastBackups"
+reports about actuality of backups defined in \fB#ETCDIR#/backup.conf\fP
+.SH CONFIGURATION
+The configfile \fB#ETCDIR/backup.conf\fP is a bash script, which defines the following variables:
+.TP
+.B "excludes"
+array of paths to exclude from backup
+.TP
+.B "backups"
+array with command line arguments for predefined backups
+.TP
+.B "maxWait"
+maximum time to wait for destination directories to appear in lastBackups [seconds]
+.TP
+.B "outdatedLimit"
+time before backups are considered outdated [seconds]
+.TP
+.B "recognSubdirRegex"
+regular expression of subdirectories which should be appended to the parent directory in the report
+.SH FILES
+.TP
+.B "#BINDIR#/backup"
+program for creation of backups
+.TP
+.B "#BINDIR#/lastBackups"
+program for check of backups
+.TP
+.B "#ETCDIR#/backup.conf"
+configuration of backups
+.SH AUTHOR
+.nf
+Erich Eckner <opensource at eckner dot net>
+.fi
diff --git a/lastBackups b/lastBackups.in
index 83fcbed..ea6040a 100755
--- a/lastBackups
+++ b/lastBackups.in
@@ -1,6 +1,8 @@
#!/bin/bash
-. /etc/backup.conf
+# lastBackups version #VERSION#
+
+. #ETCDIR#/backup.conf
unset namen
unset veraltet