Provided by: flexbackup_1.2.1-6.4_all 
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)
Flexbackup Oct 2003 FLEXBACKUP.CONF(5)