FLEXBACKUP(1)						      General Commands Manual						     FLEXBACKUP(1)

NAME

       flexbackup - a flexible backup/archiving tool

SYNOPSIS

       flexbackup [OPTION]

DESCRIPTION

       Flexbackup is a perl script front-end to various low-level archiving utilities such as tar, dump/restore, cpio, and others.

BACKUP OPTIONS

       flexbackup -dir <dir>
	      Backup a directory tree starting from path "path" using level 0 (full).

       flexbackup -set all
	      Backup all sets defined in flexbackup.conf(5) using level 0 (full).

       flexbackup -set <tag>
	      Backup a set named "tag" using level 0 (full). The set name is defined in flexbackup.conf(5).

       flexbackup [...] -level <0-9 | full | differential | incremental>
	      Change backup level to a number "0-9", or one of the symbolic names: "full" (level 0); "differential" (level 1); "incremental" (pre-
	      vious backup level + 1).

       flexbackup [...] -pkgdelta <rpm | freebsd>
	      Prune backup to files not part of a package or changed from distributed version.

       flexbackup [...] -wday <0-7>
	      Backup only if the week day matches the input number. Sunday is 0 or 7.

       flexbackup [...] -pipe
	      Write backup data to stdout rather than file/device.

       flexbackup [...] -ignore-errors
	      Continue backups even if commands return error status

RESTORE OPTIONS

       flexbackup -list
	      List files in archive.

       flexbackup -extract
	      Extract (restore) all files from archive into your current working directory.

       flexbackup -extract -flist <filelist>
	      Extract (restore) the files listed in text file "filelist" into your current working directory.

       flexbackup -extract -onefile <filename>
	      Extract (restore) the single file named "filename" into your current working directory.

       flexbackup -compare
	      Compare the archive with the files in your current working directory.

       flexbackup -restore
	      Interactive restore (dump type only for now).

       flexbackup [...] -num <n>
	      Read file number "n" from tape. If not given uses current tape position.

       flexbackup [...] <archive>
	      If archiving to files rather than a device, use file named "archive" for the list/extract/compare/restore operations.

       flexbackup [...] -pipe
	      Read backup data from stdin rather than file/device.

INDEXING OPTIONS

       flexbackup -toc
	      List current device's table of contents.

       flexbackup -toc all
	      List all known table of contents.

       flexbackup -toc <key>
	      List table of contents for specific database index key named "key".

       flexbackup -rmindex all
	      Force delete all database index info.

       flexbackup -rmindex <key>
	      Force delete specified database tape/dir index key named "key".

       flexbackup -rmindex <key:file>
	      Force delete specified database tape/dir index key named "key", file number "file".

MISCELLANEOUS OPTIONS

       flexbackup -newtape
	      Erase and create new index key (but don't do any backups).

       flexbackup -rmfile all
	      If archiving to files rather than device, remove all files and index information.

       flexbackup -rmfile <file>
	      If archiving to files rather than device, remove the file named "file" and its index information.

       flexbackup [...] -c <file.conf>
	      Use file named "file.conf" for configuration information instead of /etc/flexbackup.conf(5).

       flexbackup [...] -type <type>
	      Override $type setting from config file with "type".

       flexbackup [...] -compress <type>
	      Override $compress setting from config file with "type".

       flexbackup [...] -device <device>
	      Override $device setting from config file with "device".

       flexbackup [...] -d <'setting=value'>
	      Override $setting setting from config file with "value".

       flexbackup -dir <dir> -erase
	      Force a rewind/erase before backup of directory named "dir".

       flexbackup -dir <dir> -norewind
	      Do not rewind tape after a single backup of directory named "dir".

       flexbackup -set <tag> -noreten
	      Do not retension tape for level 0 (full) backups of set named "tag".

       flexbackup -set <tag> -noerase
	      Do not rewind/erase tape for level 0 (full) backups of set named "tag".

       flexbackup [...] -reten
	      Force a retension of tape before reading.

       flexbackup [...] -defaults
	      Do not use any default values for config variables.

       flexbackup -version
	      Display version and exit.

TESTING
/DEBUGGING OPTIONS
       flexbackup -test-tape-drive
	      Tries writing/reading files to make sure you have tape driver and parameters set up correctly in flexbackup.conf(5).

       flexbackup [...] -n
	      Don't run actual dump or mt commands, just print the steps that would be taken (dry run).

       flexbackup [...] -type filelist
	      Run a special backup type that just saves a list of files that would have been archived.

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.conf(5) afio(1) mt(1) tar(1) star(1) cpio(1) dump(1) restore(1) buffer(1) mbuffer(1)

Flexbackup							     Oct 2003							     FLEXBACKUP(1)