FLEXBACKUP.CONF(5)						File Formats Manual						FLEXBACKUP.CONF(5)

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-sepa-
		     rated 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  back-
		     ups).

	      $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  ar-
		     chive 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  explic-
		     itly. 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 deter-
		     mine 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)  man-
		     page 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)