Provided by: flexbackup_1.2.1-6.5_all bug

NAME

       /etc/flexbackup.conf - a flexible backup/archiving tool configuration file

DESCRIPTION

       Flexbackup  configuration  file.  Check  flexbackup(1)  or  "flexbackup  -help"  for usage
       information.

SETTINGS

       General Configuration Settings

              $type = 'afio';
                     Which archive type to use.  Supported types are: afio(1),  dump(1),  tar(1),
                     cpio(1),  star(1), pax(1), zip(1), lha(1), ar(1), shar(1). 'copy' is another
                     option if running in archive-to-disk mode.  Use 'filelist' to dump a list of
                     files in your cwd - for debugging setup/exclusion.

              $set{'tag'} = '/dir';
                     Configure  backup  "sets".  Not needed if "-dir <dir>" is used to backup one
                     tree  at  a  time.   Each  set  is  a   simple   space-separated   list   of
                     filesystems/directories.   Remote   filesystems   should   be   denoted   as
                     "host:directory".  You can use anything (other than  'all')  as  set  names.
                     Using  "-set  all"  will  back  up all defined sets. If you are doing a full
                     backup using tapes, each "set" will go onto a different tape and you will be
                     prompted for tape change in between. Examples:

                     $set{'set1'} = '/home /usr';
                     $set{'set2'} = '/dir3 machine2:/dir4 machine3:/dir5';

              $prune{'/'} = 'tmp proc';
                     Configure  subtree  pruning.  A space-separated list of directories to prune
                     from each backup. Key is a filesystem/directory or "host:directory" spec  as
                     outlined above regular expressions allowed (not shell-type wildcards!).

              $compress = 'false|gzip|bzip2|lzop|zip|compress|hardware|lzma';
              $compr_level = '4';
                     Configure compression. Choose a type of compression to use and configure the
                     level.   The  compression  level   only   applies   to   gzip/bzip2/lzop/zip
                     compression types.

              $buffer = 'false|buffer|mbuffer';
              $buffer_megs = '10';
              $buffer_fill_pct = '75';
              $buffer_pause_usec = '100';
                     Configure  buffering  program to help streaming to tapes. Specify the buffer
                     memory size in $buffer_megs, how full buffer needs to be to start writing in
                     $buffer_fill_pct,  and  how  long  to  sleep  after every write (which helps
                     sustain stream bursts) in $buffer_pause_usec.

              $device = '/dev/tape';
                     Configure device to backup to. Non-rewinding version, please!. If the target
                     is  a  directory,  flexbackup will archive to files in that directory rather
                     than to a device.  If configured as "host:/dev/tapedevice", will use  remote
                     tape drive via rsh/ssha.  Examples:

                     ─────────────────────────────────────────────
                      Linux SCSI w/devfs:    /dev/tapes/tape0/mtn
                      Linux SCSI:            /dev/nst0
                      Linux IDE:             /dev/nht0
                      Linux ftape:           /dev/nqft0
                      FreeBSD SCSI:          /dev/nrsa0
                     ─────────────────────────────────────────────

              $blksize = '10';
                     Configure the block size (in kilobytes!) to use for archive programs and dd.
                     Default is IfB10 for most things. Some tape drives need 32 or  64.   Set  to
                     '0' to disable all blocking.

              $mt_blksize = '0';
                     Configure  the  block  size (in bytes!) to use for the tape device, with "mt
                     setblk" or equivalent. If set to '0', will use "variable" block size for the
                     tape  device (which is recommended). Comment out or set to "$blksize * 1024"
                     to have it be the same as the archiver block size above.

              $pad_blocks = 'true|false';
                     Configure block padding.  True to pad blocks to blocksize (devices only, not
                     used when archiving to files).

              $mt{'command'} = 'other';
                     Configure  mt  operation overrides. Set these if flexbackup doesn't know the
                     right mt command(s) for your OS/tape device, or you want to override things.
                     Example:

                     Use "mt status" instead of "mt tell"
                            $mt{'tell'} = 'status';

       Other Global Settings

              $remoteshell = 'rsh|ssh|ssh2';
                     Configure the command to use for remote shell.

              $remoteuser = '';
                     If not empty (or not set), the secondary username for remote shells.

              $label = 'true|false';
                     Somehow store identifying label in archive?

              $verbose = 'true|false';
                     Print each file?

              $sparse = 'true|false';
                     Handle sparse files?

              $indexes = 'true|false';
                     Set to 'false' to turn off all table-of-contents support.

              $staticfiles = 'true|false';
                     If  backing  up  to  files, use static filenames - no date stamp (same level
                     backup of same directory will overwrite old backups).

              $atime_preserve = 'true|false';
                     Set to true to try and preserve file access  times  during  backup,  if  the
                     selected  archive  program  can  do  so.  Note that if this is true, -cnewer
                     checks (file permission/status changes only, not  content)  are  turned  off
                     when deciding which files to archive on the local system.

              $traverse_fs = 'false|local|all';
                     Span  across  filesytems?  (backups of type 'dump' will ignore this option).
                     Set to 'false' (don't), 'local' (all but nfs/smbfs), or 'all' (everything)

              $exclude_expr[0] = '.*';
                     Exclude files that match these regular  expressions  (not  shell  wildcards)
                     from  the  backups (backups of type 'dump' will ignore this option). You can
                     list more than one, just keep incrementing the index  in  the  brackets  for
                     each. Also, strip off leading directories (the filesystem specs above or the
                     "-dir" flag).  Matches paths, not filenames, so put .* on the front/back  as
                     needed. Examples:

                     $exclude_expr[0] = '.*/[Cc]ache/.*';
                     $exclude_expr[1] = '.*~$';

              $erase_tape_set_level_zero = 'true|false';
                     If  set  to  true  (default),  and using a tape device, level 0 (full) "set"
                     backup types assume you want to erase and use a new tape for  each  set.  If
                     set to false, level 0 (full) "set" backup types append to tapes. To force an
                     erase for any backup, use "-erase" on the command-line.

              $erase_rewind_only = 'true|false';
                     Set this to 'true' to make erase operations just call "mt rewind" - not  "mt
                     rewind"  followed  by  "mt erase".  (For some tape drives, erase takes hours
                     rather than seconds or is otherwise undesirable).

       Log, Stamps, and Binary Location Settings

              $logdir = '/var/log/flexbackup';
                     Directory for log files.

              $comp_log = 'false|gzip|bzip2|lzop|compress|zip';
                     Compress log?

              $staticlogs = 'true|false';
                     Use static log filenames with no date stamp?

              $prefix = '';
                     Log filenames will start with this prefix.

              $tmpdir = '/tmp';
                     Used for temporary refdate files, etc.

              $stampdir = '/var/lib/flexbackup';
                     Directory for backup timestamp files.

              $index = '/var/lib/flexbackup/index';
                     Full path (without the .db extension) to  the  database  filename  for  tape
                     indexes.

              $keyfile = '00-index-key';
                     Filename for keyfile if archiving to dir.

              $sprefix = '';
                     Stamp filenames will start with this prefix.

              $path{'program'} = '/path/to/program';
                     Override  paths  to  commands.  By  default flexbackup will look for them in
                     $PATH. Use this if you want to set commands explicitly.  You  can  use  full
                     paths or just change command names. Examples:

                     If GNU tar is called "gtar" on your system:
                            $path{'tar'} = 'gtar';

                     Or it can be used to "sudo" certain commands:
                            $path{'find'} = 'sudo find';
                            $path{'dump'} = 'sudo dump';
                            $path{'afio'} = 'sudo -u nonrootuser afio';

       Specific Command Settings

              $afio_nocompress_types = 'ext1 ext2 ...';
              $afio_echo_block = 'true|false';
              $afio_compress_threshold = '3';
              $afio_compress_cache_size = '2';
                     These  settings  apply  to  the 'afio' backup types only. In addition to the
                     afio defaults, files with  extensions  specified  in  $afio_nocompress_types
                     will  not  be  compressed.   Define  whether  or  not  echo block numbers in
                     $afio_echo_block. Configure the minimum file size  (in  kilobytes)  required
                     for   compression  in  $afio_compress_threshold.   $afio_compress_cache_size
                     setting is used to specify the maximum amount of memory (megabytes)  to  use
                     for temporary storage of compression results. If a compressed file is bigger
                     than this, compression will have to run twice on the file. See  the  afio(1)
                     manpage for more information.

              $tar_echo_record_num = 'true|false';
                     These  settings  apply to the 'tar' backup types only. Define whether or not
                     echo record numbers in $tar_echo_record_num.

              $cpio_format = 'newc';
                     These settings apply to the 'cpio' backup types only. Configure  the  format
                     of the archive in $cpio_format. See the cpio(1) manpage for allowed formats.

              $dump_length = '0';
              $dump_use_dumpdates = 'true|false';
                     These  settings  apply  to  the  'dump'  backup  types  only.  Configure the
                     estimated tape size (in kilobytes)  using  the  $dump_length  setting.  This
                     number  doesn't really do much but help dump get size estimates if set to 0,
                     flexbackup uses 'dump -a' to determine this. Set $dump_use_dumpdates setting
                     to   'true  to  use  /etc/dumpdates  (could  mess  things  up  if  you  dump
                     subdirectories of mount points). Set  it  to  'false'  to  use  flexbackup's
                     internal timestamps.

              $star_fifo = 'true|false';
              $star_acl = 'true|false';
              $star_echo_block_num = 'true|false';
              $star_format = 'exustar';
                     These  settings apply to the 'star' backup types only. Define whether or not
                     use fifo (buffering) in $star_fifo.  If you set this to 'true' you  probably
                     want  to  set  $buffer  =  'false' (see above).  Configure whether or not to
                     handle ACLs in $star_acl.  Define whether or  not  echo  record  numbers  in
                     $star_echo_block_num.  Configure  the format of the archive in $star_format.
                     See the star(1) manpage for allowed formats.

              $pax_format = 'ustar';
                     These settings apply to the 'pax' backup types only. Configure the format of
                     the archive in $pax_format. See the pax(1) manpage for allowed formats.

              $zip_nocompress_types = 'ext1 ext2 ...';
                     These  settings  apply to the 'zip' backup types only. Files with extensions
                     specified in $zip_nocompress_types will not be compressed.

              $pkgdelta_archive_list = 'true|false|rootonly';
              $pkgdelta_archive_unowned = 'true|false';
              $pkgdelta_archive_changed = 'true|false';
                     These settings apply to the 'pkgdelta' backup types only.  Configure whether
                     to  archive a list of all installed packages in the top level of each backup
                     in $pkgdelta_archive_list. Can be 'false' (don't), 'true' (save it  for  any
                     backup),  or  'rootonly'  (saves list only if the filesystem is '/'). Define
                     whether  or  not  to  archive  files  not  "owned"   by   any   package   in
                     $pkgdelta_archive_unowned.  Specify  whether  or not to archive any package-
                     owned files which have been modified in $pkgdelta_archive_changed.

FILES

       /etc/flexbackup.conf - configuration settings

REPORTING BUGS

       Report bugs to (flexbackup-help@lists.sourceforge.net)

AUTHOR

       Written by Edwin Huffstutler (edwinh@computer.org)

SEE ALSO

       flexbackup(1)