Provided by: awit-dbackup_0.0.22-1_all bug

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)