What is this about ?
********************

This is a batch script to write a backup to a tape.
One of a great family of these things.

Installation
************

Copy the file TapeBackup.sh to /usr/local/bin and make it executable.
Note that this script used the Korn Shell (ksh), you may need to install
this on your machine.


Logging
*******

A log is written in /var/log/tapebackups/.

Options
*******


    -C dev
    	tape Control device, default /dev/st0

    -d dirs
	space separated list of directories to back up

    -I
	Incrememtal backup since last complete tape backup.

	The file /arch/<MachineName>/FullTapeBackup is touched with the time
	of the file RsyncBackupSuccessTime. The file RsyncBackupSuccessTime is touched
	by RsyncBackup with the start time of it's backup.
	An incremental backup is for files newer than FullTapeBackup.

    -L
	Show the tape tabel that would be written to the tape, that is all.

    -l dir
	root Local directory, default is '/arch'.
	This is the directory under which machine specific backup directories will
	be found.

    -o
	Copy output to the current stderr as well as something in /var/log/tapebackups/.

    -m mach
	A space separated list of machines for which to write the Rsync backup to tape.
	Directories for these backups will be found under /arch.

    -M MailAddresses
    	Mail addresses to where an indication of success/failure will be sent, appended
	by the contents of the log file.
	If there is more than one address, separate by commas, surround the whole lot in
	quotes if they contain spaces.

    -N dev
    	tape device (no rewind on close), default /dev/nst0

    -T dev
    	tape device (rewind on close), default /dev/st0

    -U
	don't Unload (eject) the tape at end (default is to do so)

    -v
	Tar verbose option

    -x
	eXplain -- give a help message.


License
*******

This software is copyright (c) Alain Williams <addw@phcomp.co.uk>, 2006.
This software is released under the GPLv3, see:

	http://www.gnu.org/licenses/gpl-3.0.html


Contributing
************

TapeBackup is free software (see the license). Free software grows and becomes more
powerful and useful as those who gain by using it contribute their changes back
to the original author.

Contributions to this software are welcome. Please email the author the following:

* your name & email address
* your affiliation (company/institute/...) if any
* the code
* documentation
* a statement that you are legally able to release the code and documentation
* a statement transfering copyright to the Author below giving permission that it
  may be redistributed as part of UserAdmin under an appropriate license

Contributions will be acknowledged in the Contributors file that accompanies this
software. If you do not want to be acknowledged please make that clear.




SCCS: @(#)README	1.2 07/13/08 18:20:11