NAME

       dbackup — AWIT-DBackup is a powerful per-directory backup utility.

SYNOPSIS

       dbackup [GENERAL_OPTIONS]  [--backup BACKUP_OPTIONS  | --restore RESTORE_OPTIONS ]  [SRC]  [DST]

DESCRIPTION

       This  is  a  backup  software  package  which  creates  one archive per directory it backs up. This makes
       searching through the backup much easier as you can look for which files you're after  in  the  directory
       hierarchy. It will only backup directories which have changed, which makes it rsync friendly.

GENERAL OPTIONS

       --config FILE
                 Configuration file to use.

       --log-level
                 5 = debug, 4 = info, 3 = notice, 2 = warning, 1 = error

       --backup  Perform a backup operation.

       --restore Perform a restore operation.

       --tar     Path  to  tar  binary.  This  should almost never need to be specified, it is used to specify a
                 different tar binary to use other than the default system binary. Some versions of tar used  to
                 have  bugs preventing correct operation, this allowed specification of an alternative binary to
                 use.

       --manifest-format
                 Manifest format to use, currently the two supported formats is "null" for \0 (null) termination
                 of  entries  or  "newline"  for \n (newline) termination of entries. This should not need to be
                 overridden.

       --help    Display commandline help.

BACKUP OPTIONS

       --backup-upgrade
                 Upgrade backup to new dbackup version. This will cause all archives to  be  refreshed  if  they
                 were generated with an older version of AWIT DBackup.

       --compress <gzip|bzip2|xz|lz|none>
                 Compression  method  to  use.  Defaults  to  using  xz, or bzip2 if xz is unavailable. Parallel
                 versions of these Compression  programs  will  be  used  if  they  exist.  Here  is  the  order
                 compression  programs are looked for: gzip = pigz > gzip, bzip2 = pbzip2 > lbzip2 > bzip2, xz =
                 pxz > pixz > xz, lz = plzip > pdlzip > clzip.

       --exclude-data
                 Exclude the most common data directories which contain temporary or state information or  which
                 is not useful, a list of these is displayed by running dbackup --help.

       --exclude-system
                 Exclude the most common system directories including /dev, /proc/, /sys, /run, for the complete
                 list see dbackup --help.

       --exclude-path PCRE
                 Exclude a path based on a Perl regular expression, this should include separators  and  can  be
                 specified multiple times.  eg. --exclude-path=',/old$,'

       --exclude-file PCRE
                 Exclude  files  based  on  a  regular  expression,  this  should  include separators and can be
                 specified multiple times.  eg. --exclude-file='/.bak$/'

       --exclude-fs FSTYPE
                 Exclude filesystem types from being transversed for backup.  This  can  be  specified  multiple
                 times. eg. --exclude-fs=shm

       --system-dir PATH
                 Add  an additional system directory to exclude. The system defaults already include /dev, /run,
                 /tmp... etc. This can be specified multiple times.

       --data-dir PATH
                 Add an additional data directory to  exclude.  The  data  directory  defaults  already  include
                 /var/lib/mysql,    /var/lib/pgsql,    /var/amavis/tmp/,    /var/spool/squid,    /var/cache/yum,
                 /var/cache/apt/archives ... etc. This can be specified multiple times.

       --system-base PATH
                 System base to apply the exclusions to. This can be specified multiple times.

       --tar-ignore-failed-read
                 This is passed to tar only. It will not cause errors if files that cannot be read.

RESTORE OPTIONS

       --tar-keep-newer
                 Pass --keep-newer to tar. Don't replace existing  files  that  are  newer  than  their  archive
                 copies.

       --tar-keep-old-files
                 Pass  --keep-old-files  to  tar.  Don't replace existing files when extracting, rather throw an
                 error.

SEE ALSO

       tar(1).

AUTHOR

       This manual page was written  by  Nigel  Kukard  <nkukard@lbsd.net>.   Permission  is  granted  to  copy,
       distribute  and/or  modify this document under the terms of the GNU General Public License, Version 3 any
       later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-
       licenses/GPL-3.

                                                                                                 AWIT-DBACKUP(8)