.gitignore

@@ -20,6 +20,8 @@ etc/cron.d/backupninja
 etc/logrotate.d/backupninja
 examples/Makefile
 handlers/Makefile
+handlers/borg
+handlers/borg.helper
 handlers/dup
 handlers/dup.helper
 handlers/ldap
@@ -33,6 +35,8 @@ handlers/pgsql
 handlers/pgsql.helper
 handlers/rdiff
 handlers/rdiff.helper
+handlers/restic
+handlers/restic.helper
 handlers/rsync
 handlers/sh
 handlers/svn
@@ -45,8 +49,10 @@ lib/Makefile
 lib/easydialog
 lib/parseini
 lib/tools
-lib/vserver
 man/Makefile
 src/Makefile
 src/backupninja
 src/ninjahelper
+.vagrant
+*.swp
+*.swo

AUTHORS

@@ -7,7 +7,7 @@ micah@riseup.net   -- debian package, vserver support, bug fixes
 stefani@riseup.net -- makecd handler, man pages
 intrigeri@boum.org -- dup handler, pgsql handler, vserver support, bug fixes
 Charles Lepple 	   -- trac handler
-Petr Klma <petr.klima@madeta-group.cz>	-- autotools, RPM support and sys checks
+Petr Kl�ma <petr.klima@madeta-group.cz>	-- autotools, RPM support and sys checks
 paulv@bikkel.org   -- rsnap handler
 Robert Napier 	   -- improved RPM build
 rhatto 		   -- rub handler and patches
@@ -59,3 +59,14 @@ Daniel Lo Nigro <daniel@dan.cx> -- Dropbox support for Duplicity
 Matthijs Wensveen <matthijs.wensveen@gmail.com> -- fix symmetric encryption in dup handler
 ulrich <ulrich@habmalnefrage.de> -- Added validation check for when
 Romain Dessort <romain@univers-libre.net> -- Fix list of devices when dumping partition tables
+Guillaume Subiron <guillaume@sysnove.fr> -- borg handler
+Jerome Charaoui <jerome@riseup.net> -- borg handler
+David Gasaway <dave@gasaway.org> -- Fixes for configuration files without suffix
+Hugh Nowlan <nosmo@nosmo.me> -- dup check for archive dir
+Lyz <lyz@riseup.net> -- sys support for LUKS in disk partitions
+Glandos <bugs-0xacab@antipoul.fr> -- sys excludes zram devices
+Nicolas Karolak <nicolas@karolak.fr> -- Add restic support
+Derek Laventure -- Add restic helper
+Colan Schwartz -- Fix restic options handler
+
+... and other contributors, thank you!

INSTALL.md

@@ -15,7 +15,7 @@ Requirements:
 
 Recommended:
 
-        rdiff-backup duplicity rsync gzip hwinfo sfdisk cryptsetup flashrom hwinfo
+        borgbackup cryptsetup duplicity flashrom gzip hwinfo rdiff-backup restic rsync sfdisk
 
 To install backupninja, simply do the following:
 

Makefile.am

 # vi: noexpandtab softtabstop=0
 ## Process this file with automake to produce Makefile.in
 
-EXTRA_DIST = FAQ.md README.md COPYING AUTHORS INSTALL.md NEWS ChangeLog \
+EXTRA_DIST = FAQ.md README.md COPYING AUTHORS INSTALL.md NEWS CHANGELOG.md \
              backupninja.spec backupninja.spec.in autogen.sh
 
 SUBDIRS = etc examples handlers lib man src

README.md

@@ -24,7 +24,6 @@ The key features of backupninja are:
  - console-based wizard (ninjahelper) makes it easy to create
    backup action configuration files
  - passwords are never sent via the command line to helper programs
- - works with [Linux-Vservers](http://linux-vserver.org/)
 
 The following backup types are supported:
 
@@ -33,7 +32,7 @@ The following backup types are supported:
    with an unpriviledged backup user
  - backup of mysql databases (via mysqlhotcopy and mysqldump)
  - basic system and hardware info
- - encrypted remote backups (via duplicity)
+ - encrypted remote backups (via duplicity or borgbackup)
  - backup of subversion repositories
 
 Installation
@@ -82,8 +81,7 @@ To add an additional 'wizard' to ninjahelper, follow these steps:
            }
 
 3. Look at the existing helpers to see how they are written. Try to re-use
-   functions, such as the dialog functions that are defined in `easydialog.sh`,
-   or the vserver functions defined in `lib/vserver`.
+   functions, such as the dialog functions that are defined in `easydialog.sh`.
 
 4. Test, re-test, and test again. Try to break the helper by going backwards,
    try to think like someone who has no idea how to configure your handler
@@ -106,7 +104,9 @@ file in `/etc/backup.d` according to the file's suffix:
 
  - `.sh`: run this file as a shell script.
  - `.rdiff`: filesystem backup (using rdiff-backup)
+ - `.restic`: filesystem backup (using restic)
  - `.dup`: filesystem backup (using duplicity)
+ - `.borg`: filesystem backup (using borg)
  - `.mysql`: backup mysql databases
  - `.pgsql`: backup PostgreSQL databases
  - `.sys`: general hardware, partition, and system reports.
@@ -214,25 +214,6 @@ Since it performs incremental backups it minimizes the number of request per
 operation therefore reducing the costs. The boto Python interface to Amazon
 Web Services is needed to use duplicity with S3 (Debian package: `python-boto`).
 
-
-Vservers
---------
-
-If you are using [Linux-Vservers](http://linux-vserver.org/) there are some
-special capabilities that different handlers have to make vserver
-backups easier.
-
-Set the variable `vservers` to be `yes` in `/etc/backupninja.conf` and see the
-example configuration files for each handler to configure the vserver specific
-variables.
-
-Additional vserver variables that can be configured in `/etc/backupninja.conf`,
-but they probably don't need to be changed:
-
- - `VSERVERINFO` (default: `/usr/sbin/vserver-info`)
- - `VSERVER` (default: `/usr/sbin/vserver`)
- - `VROOTDIR` (default: `$VSERVERINFO info SYSINFO |grep vserver-Rootdir | awk '{print $2}'`)
-
 .sh configuration files
 -----------------------
 

README_tests.md

+When developping fixes or new features for backupninja, it is highly recommended
+to run the test suite to help spot potential problems.
+
+The test suite is based on Vagrant, and is configured to rely on the VirtualBox
+provider. The required package may be installed using the following command:
+
+    apt install vagrant virtualbox
+
+On Debian 10 (buster) these packages aren't available in the default upstream
+repositories, so you will need to use an alternative such as the one provided
+by an individual Debian developper here:
+
+    https://people.debian.org/~lucas/virtualbox-buster/
+
+Once the requirements are in place, the test suite may be run in this manner:
+
+    git clone git@0xacab.org:liberate/backupninja.git
+    cd backupninja
+    vagrant up
+    vagrant ssh -c "sudo /vagrant/test/test.sh"
+
+It's possible to only test a specific handler with:
+
+    vagrant ssh -c "sudo /vagrant/test/test.sh rdiff"
+
+To synchronise changes in the source code and rebuild backupninja:
+
+    vagrant rsync local && vagrant ssh -c "build-backupninja.sh"
+
+Please report any problems with the test suite on the issue tracker at:
+
+    https://0xacab.org/liberate/backupninja/-/issues

RELEASE.md

 Upstream
 ========
 
+* run the full testsuite
+
+        vagrant rsync local && \
+        vagrant ssh -c "build-backupninja.sh && sudo /vagrant/test/test.sh"
+
 * prepare the environment:
 
         export VERSION=x.y.z
 
-* update `configure.in` and `ChangeLog`
+* update `configure.ac` and `CHANGELOG.md`
 
         perl -pi -E \
-           "s{^AC_INIT\(\[backupninja\],\[[0-9.]+\],}{AC_INIT([backupninja],[$VERSION],}" \
-           configure.in && \
-        RELEASE_DATE=$(LC_ALL=C date '+%B %d, %Y') perl -pi -E \
-           "s{^version\s+[0-9.]+\s+--\s+UNRELEASED$}{version $VERSION -- $RELEASE_DATE}" \
-           ChangeLog
+           "s{^AC_INIT\(\[backupninja\],\[[0-9.\-rc]+\],}{AC_INIT([backupninja],[$VERSION],}" \
+           configure.ac
+
+        RELEASE_DATE=$(LC_ALL=C date '+%Y-%m-%d'); perl -pi -E \
+           "s{^## \[Unreleased\].*}{## [$VERSION] - $RELEASE_DATE}" \
+           CHANGELOG.md
 
-* commit, tag and create the tarball:
+* commit and created signed tag
 
-        git commit configure.in ChangeLog \
+        git commit configure.ac CHANGELOG.md \
             -m "Releasing backupninja $VERSION" && \
-        git clean -fdx && \
+        git clean -fdx -e .vagrant && \
         git tag -s "backupninja-$VERSION" \
             -m "Releasing backupninja $VERSION" && \
         ./autogen.sh && \
@@ -28,15 +34,15 @@ Upstream
 * compare the content of the generated tarball with the content of the
   previous one
 
-* move the tarball outside of the Git working copy and clean up:
+        diffoscope --text-color=always ../tarballs/backupninja-x.y.z.tar.gz \
+            backupninja-$VERSION.tar.gz | less -R
+
+* move the tarball outside of the Git working copy and clean up
 
         mkdir -p ../tarballs && \
         mv backupninja-$VERSION.tar.gz ../tarballs/ && \
         make distclean && \
-        git clean -fdx
-
-* Install (extract tarball, `.configure && make && sudo make install`)
-  and test.
+        git clean -fdx -e .vagrant
 
 Debian
 ======
@@ -58,10 +64,8 @@ Install the `.deb` and test.
 Release
 =======
 
-* sign the release and push it to Git:
+* push the release to GitLab
 
-        gpg --armor --detach-sign \
-            ../tarballs/backupninja-$VERSION.tar.gz && \
         git checkout debian && \
         gbp buildpackage --git-tag-only --git-sign-tags && \
         git push --follow-tags origin \
@@ -70,10 +74,11 @@ Release
             pristine-tar:pristine-tar \
             upstream:upstream
 
-* upload the upstream tarball and detached signature to the GitLab
-  milestone page with *Edit* → *Attach a file*
+* create a new GitLab release
+
 * announce the release on the backupninja mailing-list,
   pointing to the milestone web page
+
 * upload to Debian or ask someone listed in the `Uploaders` control
   field to review and upload
 
@@ -81,4 +86,5 @@ Open the next development cycle
 ===============================
 
 * `git checkout master`
-* Add an empty new section in `ChangeLog`, commit and push.
+
+* Add an empty new section in `CHANGELOG.md`, commit and push.

TODO

@@ -6,15 +6,13 @@ you are working on it!
   http://bugs.debian.org/cgi-bin/pkgreport.cgi?which=pkg&data=backupninja&archive=no
 
 . Fix all bugs reported on our Gitlab instance:
-  https://0xacab.org/riseuplabs/backupninja/issues
+  https://0xacab.org/liberate/backupninja/issues
 
 . Make ninjahelper allow you to pick what type of backup you want (instead
   of just assuming you want local-to-remote, or push backups. Some people
   want local-to-local, or remote-to-local, or pull backups). This has been
   reported for the duplicity handler as Debian bug #346040.
 
-. Allow vsnames "all" in the msyql handler.
-
 . Factorize the rdiff.helper's connection-related functions into a lib, so
   that they can be used by dup.helper too. (NB: don't forget that the dup
   handler has a sshoptions configuration setting, that is often used to

Vagrantfile

+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+ENV["LC_ALL"] = "en_US.UTF-8"
+
+base_box = "debian/testing64"
+
+empty_disk = '.vagrant/tmp/empty.vdi'
+lvm_disk = '.vagrant/tmp/lvm.vdi'
+lukspart_disk = '.vagrant/tmp/lukspart.vdi'
+luksdev_disk = '.vagrant/tmp/luksdev.vdi'
+
+Vagrant.configure("2") do |config|
+
+  config.vm.define "remote" do |remote|
+    remote.vm.box = base_box
+    remote.vm.hostname = "bntest1"
+    remote.vm.network "private_network", ip: "192.168.181.5"
+    remote.vm.provision "shell", inline: <<-SHELL
+      export DEBIAN_FRONTEND=noninteractive
+      echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen
+      locale-gen
+      apt-get update
+      apt-get install -y borgbackup duplicity rdiff-backup restic rsync
+      sed -i 's/^PasswordAuthentication no/PasswordAuthentication yes/' /etc/ssh/sshd_config
+      echo "Port 22" >> /etc/ssh/sshd_config
+      echo "Port 7722" >> /etc/ssh/sshd_config
+      systemctl reload sshd
+      echo -e "vagrant\nvagrant" | passwd vagrant
+      chown vagrant: /var/backups
+      wget -q https://github.com/restic/rest-server/releases/download/v0.10.0/rest-server_0.10.0_linux_amd64.tar.gz -O - | tar -xz -C /usr/local/bin --strip-components=1
+    SHELL
+  end
+
+  config.vm.define "local", primary: true do |local|
+    local.vm.box = base_box
+    local.vm.hostname = "bntest0"
+    local.vm.network "private_network", ip: "192.168.181.4"
+    local.vm.provision "shell", inline: <<-SHELL
+      export DEBIAN_FRONTEND=noninteractive
+      echo "root: vagrant" >> /etc/aliases
+      echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen
+      locale-gen
+      apt-get update
+      apt-get install -y automake make dialog sshpass
+      BUILDSCRIPT="/usr/local/bin/build-backupninja.sh"
+      echo "#!/bin/sh" >> $BUILDSCRIPT
+      echo "cd /vagrant" >> $BUILDSCRIPT
+      echo "make clean" >> $BUILDSCRIPT
+      echo "./autogen.sh" >> $BUILDSCRIPT
+      echo "./configure --prefix=/usr --mandir=/usr/share/man --sysconfdir=/etc --localstatedir=/var --libdir=/usr/lib --libexecdir=/usr/lib" >> $BUILDSCRIPT
+      echo "make" >> $BUILDSCRIPT
+      echo "sudo make install" >> $BUILDSCRIPT
+      chmod +x $BUILDSCRIPT
+      $BUILDSCRIPT
+      mkdir -p /root/.ssh
+      yes y | ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519 -N ''
+      echo "StrictHostKeyChecking accept-new" >> /root/.ssh/config
+      echo "192.168.181.5 bntest1" >> /etc/hosts
+      sshpass -p vagrant scp /root/.ssh/id_ed25519.pub vagrant@bntest1:/tmp/bntest.pub
+      sshpass -p vagrant ssh vagrant@bntest1 "cat /tmp/bntest.pub >> /home/vagrant/.ssh/authorized_keys"
+      sshpass -p vagrant ssh vagrant@bntest1 "chmod 400 /home/vagrant/.ssh/authorized_keys"
+      ssh vagrant@bntest1 "sudo sed -i 's/^PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config"
+      ssh vagrant@bntest1 "sudo systemctl reload sshd"
+    SHELL
+
+    local.vm.provider :virtualbox do |vb|
+      unless File.exist?(empty_disk)
+        vb.customize ['createhd', '--filename', empty_disk, '--size', 100 ]
+      end
+      unless File.exist?(empty_disk)
+        vb.customize ['createhd', '--filename', lvm_disk, '--size', 100 ]
+      end
+      unless File.exist?(lukspart_disk)
+        vb.customize ['createhd', '--filename', lukspart_disk, '--size', 100 ]
+      end
+      unless File.exist?(luksdev_disk)
+        vb.customize ['createhd', '--filename', luksdev_disk, '--size', 100 ]
+      end
+      vb.customize ['storageattach', :id, '--storagectl', 'SATA Controller', '--port', 1, '--device', 0, '--type', 'hdd', '--medium', empty_disk]
+      vb.customize ['storageattach', :id, '--storagectl', 'SATA Controller', '--port', 2, '--device', 0, '--type', 'hdd', '--medium', lvm_disk]
+      vb.customize ['storageattach', :id, '--storagectl', 'SATA Controller', '--port', 3, '--device', 0, '--type', 'hdd', '--medium', lukspart_disk]
+      vb.customize ['storageattach', :id, '--storagectl', 'SATA Controller', '--port', 4, '--device', 0, '--type', 'hdd', '--medium', luksdev_disk]
+    end
+  end
+
+  config.vm.synced_folder ".", "/vagrant", type: "rsync",
+    rsync__exclude: ".git/",
+    rsync__args: ["--recursive", "--delete"]
+
+end

autogen.sh

@@ -8,10 +8,10 @@ fi
 if [ "x$1" = "x-f"  ]
 then
     autoscan
-    [ -f "configure.in" ] && cp "configure.in" "configure.in.old"
-    mv -f "configure.scan" "configure.in"
-    echo "## This is just AUTOSCAN draft of configure.in"
-    $EDITOR "configure.in"
+    [ -f "configure.ac" ] && cp "configure.ac" "configure.ac.old"
+    mv -f "configure.scan" "configure.ac"
+    echo "## This is just AUTOSCAN draft of configure.ac"
+    $EDITOR "configure.ac"
 fi
 
 ### použít jen když je třeba použít configure.h.in

backupninja.spec.in

@@ -7,11 +7,11 @@ Version:    %{version}
 Release:    1
 License:    GPL
 Group:      Applications/System
-URL:        https://0xacab.org/riseuplabs/backupninja
+URL:        https://0xacab.org/liberate/backupninja
 Source:     %{name}-%{version}.tar.gz
 Requires:   bash, gawk, rdiff-backup, gzip
 Provides:   %{name}
-Packager:   Petr Klima <Petr.Klima@madeta-group.cz>
+Packager:   Petr Klima <Petr.Klima@madeta.cz>
 BuildRoot:  %{_tmppath}/%{name}-%{version}
 Prefix:     %{_prefix}
 
@@ -50,7 +50,7 @@ rm -fr %{buildroot}
 
 %ghost %{_localstatedir}/log/backupninja.log
 
-%doc AUTHORS COPYING ChangeLog INSTALL.md NEWS README.md
+%doc AUTHORS COPYING CHANGELOG.md INSTALL.md NEWS README.md
 %{_mandir}/man1/*
 %{_mandir}/man5/*
 

configure.in → configure.ac

@@ -3,15 +3,12 @@
 
 # The maintainer mode is causing me grief with newest versions of autotools
 #AM_MAINTAINER_MODE
-AC_INIT([backupninja],[1.0.2],[backupninja@lists.riseup.net])
+AC_INIT([backupninja],[1.2.2],[backupninja@lists.riseup.net])
 AC_CONFIG_SRCDIR([src/backupninja.in])
 AM_INIT_AUTOMAKE([foreign])
 
 # Checks for programs.
 
-# BASH may already be set in the shell, if the admin then changes the
-# the /bin/sh symlink to a non-bash shell, all hell will break lose.
-unset BASH
 AC_PATH_PROGS(BASH, bash, "no", [$PATH:/bin:/usr/bin:/usr/sbin])
 if test x$BASH = "xno"; then
     AC_MSG_ERROR([bash is required])

etc/backupninja.conf.in

@@ -13,6 +13,10 @@
 # 1 -- Fatal errors           (only)
 loglevel = 4
 
+# Produce prometheus metrics of backup status (default = no).
+# Requires `prometheus-node-exporter` to be installed
+reportprom = false
+
 # send a summary of the backup status to
 # this email address:
 reportemail = root
@@ -46,6 +50,9 @@ reportuser = ninja
 # use a globally unique name, preferably the hostname
 reportdirectory = /var/lib/backupninja/reports
 
+# number of columns the report email body should wrap to
+#reportwrap = 80
+
 # set to the administration group that is allowed to
 # read/write configuration files in /etc/backup.d
 admingroup = root
@@ -72,9 +79,6 @@ usecolors = yes
 # default value for 'when'
 when = everyday at 01:00
 
-# if running vservers, set to yes
-vservers = no
-
 # programs paths
 # SLAPCAT=/usr/sbin/slapcat
 # LDAPSEARCH=/usr/bin/ldapsearch
@@ -89,6 +93,3 @@ vservers = no
 # GZIP=/bin/gzip
 # GZIP_OPTS='--rsyncable'
 # RSYNC=/usr/bin/rsync
-# VSERVERINFO=/usr/sbin/vserver-info
-# VSERVER=/usr/sbin/vserver
-# VROOTDIR=/var/lib/vservers

examples/Makefile.am

 
-EXAMPLES = example.dup example.maildir example.makecd example.mysql \
-		example.pgsql example.rdiff example.rsync example.sh  \
-		example.svn example.sys example.trac
+EXAMPLES = example.borg example.dup example.maildir example.makecd \
+		example.mysql example.pgsql example.rdiff example.rsync \
+		example.sh example.svn example.sys example.trac example.restic
 
 EXTRA_DIST = $(EXAMPLES)
 

examples/example.borg

+##
+## This is an example borgbackup configuration file.
+##
+## Here you can find all the possible borgbackup options, details of
+## what the options provide and possible settings. The defaults are set
+## as the commented out option, uncomment and change when
+## necessary. Options which are uncommented in this example do not have
+## defaults, and the settings provided are recommended.
+##
+## The defaults are useful in most cases, just make sure to configure the
+## destination host and user.
+##
+
+## passed directly to borg commands, e.g. to use a particular remote
+## borg executable (here: 'borg12'), set this to:
+## options = --remote-path=borg12
+##
+## Default:
+# options =
+
+## default is 0, but set to 19 if you want to lower the priority.
+## an example setting would be:
+## nicelevel = 19
+##
+## Default
+# nicelevel = 0
+
+## ionicelevel is optional. If it is left undefined or empty, ionice will not
+## be used at all. If it is set to to an integer value from 0 to 7, then ionice
+## will be used with the best effort class (-c2) and with the ionicelevel as
+## the class data (-n).
+##
+## See the ionice(1) man page for more details about available levels.
+##
+## Default:
+# ionicelevel =
+
+## default is yes. set to no to skip the test if the remote host is alive
+##
+## Default:
+# testconnect = yes
+
+## default is not to limit bandwidth.
+## set to a number in kiBytes/second to limit bandwidth usage.
+##
+## Default:
+# bwlimit = 0
+
+## export "borg info last_archive" to a given file
+## this is usefull for monitoring without using borg
+##
+## Example:
+# borginfo = /var/backups/borginfo.json
+## Default:
+# borginfo =
+
+## export "borg list repository" to a given file
+## this is usefull for monitoring without using borg
+##
+## Example
+# borglist = /var/backups/borglist.json
+## Default:
+# borglist =
+
+######################################################
+## source section
+## (where the files to be backed up are coming from)
+
+[source]
+
+## default is to initialize the backup repository if absent
+## set to no to skip this step
+##
+## Default:
+# init = yes
+
+## A few notes about includes and excludes:
+## 1. include paths do not support any kind of pattern matching
+## 2. exclude paths support several types of pattern matching, the default being
+##    shell-style matching, where, for example, '*' matches any number of
+##    characters. for more info, see : borg help patterns
+## 3. Symlinks are preserved (not followed).
+##
+## for more info see : borg help patterns
+##
+## files to include in the backup
+include = /opt
+include = /srv
+include = /etc
+include = /root
+include = /home
+include = /usr/local
+include = /var
+
+## files to exclude from the backup
+exclude = /var/lock
+exclude = /var/run
+exclude = /var/cache
+exclude = /var/tmp
+exclude = /var/lib/mongodb/journal
+exclude = /var/lib/clamav
+exclude = /var/lib/mlocate
+exclude = /var/lib/postgresql
+exclude = /var/lib/mysql
+
+## define extra command-line options for the "borg create" operation.
+##
+## Example:
+## create_options = --exclude-caches
+##
+## for more info see : borg help create
+##
+## Default:
+# create_options =
+
+## whether to prune (remove) older backups
+##
+## Default:
+# prune = yes
+
+## keep all backups within this time frame.
+## must be defined as a number followed by one of the
+## following characters: "H", "d", "w", "m", "y"
+##
+## this option will be ignored if set to 0
+##
+## the default is to keep all backups made within the
+## last 30 days
+##
+## Default:
+# keep = 30d
+
+## define hourly, daily, weekly and monthly retention for the "borg prune" operation.
+##
+## theses options will be ignored if set to 0
+##
+## Default:
+## keephourly = 0
+## keepdaily = 0
+## keepweekly = 0
+## keepmonthly = 0
+
+## define extra command-line options for the "borg prune" operation.
+##
+## Example:
+## prune_options = --keep-daily=7 --keep-weekly=4 --keep-monthly=6
+##
+## for more info see : borg help prune
+##
+## Default:
+# prune_options =
+
+## Path to the directory that will hold borg's cache files. By default this is
+## empty, which will let borg use its default path of "~/.cache/borg".
+##
+## Default:
+# cache_directory =
+
+## by default borg emits various warnings that are impossible to check on large
+## infrastructures.
+## - when some files/repositories included in borg create does not exists
+## - when some files have changed during the backup (happens a lot on log files)
+## This option allows to disable these warning.
+##
+## Default:
+# filter_warnings = yes
+
+## when filter_warning == yes, allows to choose to disable warning if
+## file changed during backup
+##
+## Default:
+# warning_if_file_changed_during_backup = yes
+
+## when warning_if_file_changed_during_backup == yes, allows to ignore some
+## paths or filenames.
+##
+## Default:
+# file_changes_to_ignore = /
+
+######################################################
+## destination section
+## (where the files are copied to)
+
+[dest]
+
+## put the backups under this directory, this must be set!
+## an example setting would be:
+## directory = /backups
+##
+## Default:
+# directory =
+
+## the machine which will receive the backups.
+## an example setting would be:
+## host = backuphost
+##
+## set host = localhost for local backups (no ssh)
+##
+## Default
+# host =
+
+## make the files owned by this user. you must be able to
+## `su -c "ssh backupuser@backhost"` without specifying a password.
+## an example setting would be:
+## user = backupuser
+##
+## Default:
+# user =
+
+## archive name, should be unique every day.
+## Format tags available :
+## {now}, {utcnow}, {fqdn}, {hostname}, {user}, {pid}
+##
+## for more info see : borg help create
+##
+## Default:
+# archive = {now:%Y-%m-%dT%H:%M:%S}
+
+## compression algorithm
+## can be "none", "lz4", "zstd[,L]", "zlib[,L]", "lzma[,L]", "auto,C[,L]".
+## - "none" stands for "no compression"
+## - "lz4" offers very high speed, very low compression
+## - "zstd" is a modern wide-range algorithm
+## - "zlib" offers medium speed, medium compression
+## - "lzma" offers low speed, high compression
+## - "auto,C" will use a heuristic to decide whether to compress using
+##            selected algorithm C
+##
+## for more info see : borg help compression
+##
+## Default:
+# compression = lz4
+
+## encryption mode to use for repository creation
+##
+## common options are "none", "repokey" or "keyfile"
+## - "none" = no encryption
+## - "repokey" = encryption with key stored inside the repository
+## - "keyfile" = encryption with key stored in ~/.config/borg/keys/
+##
+## for other options and more info, see : borg help init
+##
+## Default:
+# encryption = none
+
+## passphrase of the key used for repository encryptions
+##
+## must be set if encryption is not "none"
+## encryption is disabled by default
+##
+## Default:
+# passphrase =
+
+## command-line options to use with ssh
+##
+## an example setting would be:
+## sshoptions = -i /root/.ssh/id_rsa_borg
+##
+## Default:
+# sshoptions =

examples/example.dup

@@ -19,6 +19,16 @@
 ## Default:
 # nicelevel = 0
 
+## ionicelevel is optional. If it is left undefined or empty, ionice will not
+## be used at all. If it is set to to an integer value from 0 to 7, then ionice
+## will be used with the best effort class (-c2) and with the ionicelevel as
+## the class data (-n).
+##
+## See the ionice(1) man page for more details about available levels.
+##
+## Default:
+# ionicelevel =
+
 ## test the connection? set to no to skip the test if the remote host is alive.
 ## if 'desturl' is set below, 'testconnect' must be set to 'no' for now.
 ##
@@ -101,7 +111,7 @@
 [source]
 
 ## A few notes about includes and excludes:
-## 1. include, exclude and vsinclude statements support globbing with '*'
+## 1. include and exclude statements support globbing with '*'
 ## 2. Symlinks are not dereferenced. Moreover, an include line whose path
 ##    contains, at any level, a symlink to a directory, will only have the
 ##    symlink backed-up, not the target directory's content. Yes, you have to
@@ -127,21 +137,6 @@ include = /usr/local/sbin
 include = /var/lib/dpkg/status
 include = /var/lib/dpkg/status-old
 
-## If vservers = yes in /etc/backupninja.conf then the following variables can
-## be used:
-## vsnames = all | <vserver1> <vserver2> ... (default = all)
-## vsinclude = <path>
-## vsinclude = <path>
-## ...
-## Any path specified in vsinclude is added to the include list for each vserver
-## listed in vsnames (or all if vsnames = all, which is the default).
-##
-## For example, vsinclude = /home will backup the /home directory in every
-## vserver listed in vsnames. If you have 'vsnames = foo bar baz', this
-## vsinclude will add to the include list /vservers/foo/home, /vservers/bar/home
-## and /vservers/baz/home.
-## Vservers paths are derived from $VROOTDIR.
-
 # files to exclude from the backup
 exclude = /home/*/.gnupg
 exclude = /var/cache/backupninja/duplicity