cd-cat v0.1
Copyright (c) 2001 Dominic Anello
This program is distributed under the GNU GPL v2 please see the file LICENSE

Description:
	Based on an initialization file, creates a catalog file that can be used
to back up a set of files to removable media.

Usage:
cd-cat mode [options] catalog
mode
  -a    Create an archive from the catalog.  Must also specify -n.
  -c    Create a catalog from ini file.  Must also specify -i.

options
  -i inifile    Specifies the configuration file used to generate a catalog.
  -n disk-id    Specifies what disk ID to create an archive for.

catalog - The catalog file to operate on.

Initialization file:
	The ini file is similar to the samba smb.conf layout.  There is a [GLOBAL]
section and a series of [<directory>] sections that allow you to specify
options for each directory to be backed up.
	Please see the ini-samples directory for some example ini files.
	
    For example if you had an ini called mp3.ini you would do the following:
cd-cat -c -i mp3.ini mp3.cat

    This will create a file called mp3.cat that is a catalog of all files
in the directories specified in mp3.ini.  Then to create the archive of the
first volume do:
cd-cat -a -n 1 mp3-cat

    This will create a file called /home/tmp/mp3-archive-1.tar  That contains
the first volumes worth of files.

Directives:
archive_name
	valid in:	GLOBAL
	default:	cd-archive-[n].tar
	freetext
		Specifies the naming convention for archives produced by cd-cat.  If 
	present, [n] will be replaced by the disc number of the archive being 
	generated.

base_dir
	valid in:	GLOBAL
	default:	/
	file path
		Indicates the base directory for archiving purposes. All relative
	directory paths are treated as relative to this directory.

file_spec
	valid in:	GLOBAL, directory
	default:	
	perl regex
		Only files matching this regexp will be included in the archive.

media_size
	valid in:	GLOBAL
	default:	676331520
	integer
		The size of the backup media being used in bytes.  Default is 645MB.

recurse
	valid in:	GLOBAL, directory
	default:	1
	boolean
		Determines whether subdirectories of specified directories should be 
	processed as well.

tar_opts UNIMPLEMENTED
	valid in:	GLOBAL
	default:	p
	see man tar(1)
		Options to be passed to tar.

temp_dir
	valid in:	GLOBAL
	default:	/tmp
	file path
		Directory for building archive.  Must have at least (media_size x 2)
	free space.  The archive itself will also be output here.

ignore
	valid in:	GLOBAL, directory
	default:	
	perl regex
		A regular expression that determines which files to NOT include in the
	archive.

TODO:
	* implement tar_opts
	* ability to freshen catalog
	* Doesn't compress archive, bascily only useful for mp3 and other compressed
		media
