This is a complete backup/restore system, particularly designed for soundfiles.
To use you need a directory called "catalogs" in your home directory.

==========================================================================
1) When using a new tape, you need to initialize it with the program
called "writelabel".  You say "writelabel <somenumber>" and it will
write that number plus an optional comment on the header of the tape.
The backup and restore programs will always check for that label
and refuse to go on if you have mounted the wrong tape.

2) To backup files the command is
sfbackup -l <tapenum> file1 file2... filen

This will automatically append these files to the end (past the last
previously written file)  of your tape, each in a separate file.

If you want to start writing at a specific file number say
sfbackup -l <tapenum> -s <num to skip over> file1, file2, etc.

You can backup a complete directory by saying

sfbackup -l <tapenum>   somedir/*

You can backup aiff, NeXT, BSD, and arbitrary data and text files.
The catalog will save the type.

A sample catalog file will then look like this:


TAPE NUMBER: 1001               Owner: geersde
Initialization date: Thu Feb 29 13:42:55 1996
Comment: This tape belongs to Jonathan Kramer. Discovery Channel project, Jan.-Feb. 1996.

file# dur       chans  type   nbytes      creation date     name
  1   -------    <DATA FILE>     4112   13:57:02  2/02/96  13-9-6-4.data
  2   -------    <DATA FILE>     4136   13:50:34  2/02/96  3-4-7-11.data
  3   -------    <DATA FILE>     4217   13:43:09  2/02/96  4-5-7-10.data
  4   -------    <DATA FILE>     4357   13:26:55  2/02/96  5-4.data
  5   -------    <DATA FILE>     4602   13:36:19  2/02/96  6-7.data
  6   -------    <DATA FILE>     4179   13:08:16  2/02/96  7-4.data
  7   -------    <DATA FILE>     8201   13:23:25  2/05/96  CATHEDRAL.data
  8   -------    <DATA FILE>     8059   13:23:41  2/05/96  EARLY-MUSIC.data
  9   -------    <DATA FILE>     8040   13:23:56  2/05/96  EVEN-NOTES.data
 10   -------    <DATA FILE>     8144   13:24:10  2/05/96  SLURRED.data
 11   34.8781     1    AIFF   3076246   15:07:46  2/05/96  cathedral.aif
 12   36.0714     1    AIFF   3181498   11:49:50  2/05/96  early-music.aif
 13   33.3514     1    AIFF   2941594   11:53:54  2/05/96  even-notes.aif
 14   66.6607     2    AIFF  11758948   17:08:21  2/02/96  snd/kramer-1-1-240.aif
 15   74.4907     2    AIFF  13140160   17:24:39  2/02/96  snd/kramer-13-9-6-4-27.aif
 16   58.1207     2    AIFF  10252492   17:37:30  2/02/96  snd/kramer-3-4-7-11-43.aif
 17   60.4507     2    AIFF  10663504   17:52:36  2/02/96  snd/kramer-4-5-7-10-40.aif
 18   67.7607     2    AIFF  11952988   18:06:39  2/02/96  snd/kramer-5-4-200.aif
 19   53.9207     2    AIFF   9511612   18:21:26  2/02/96  snd/kramer-6-7-220.aif
 20   64.5007     2    AIFF  11377924   15:30:13  2/02/96  snd/kramer-7-4-120.aif
 21   61.5342     2    NBfl  10854628   16:26:24  2/25/96  vschiff.aif
 22   36.4514     1    AIFF   3215014   11:51:56  2/05/96  snd/slurred.aif
Total bytes used on this tape: 101984655

========================================================================
to restore you say

sfrestore -l <tapenum> -n filenum1 filenum2 filenum3... filenumn

where filenum is the number of the file in the catalog.  This will
restore the file with its original file name, date and time.  The filenums need not
be adjacent or in order.  sfrestore will take care of forward and backward
spacing to find the appropriate files.

if you use a -N flag it will restore the file with its full path name.
It will restore the file with its original date and time. In this case
make sure that this directory exists, relative to your current working
directory.

If you want to restore a range of files use the -r flag, thus:

sfrestore -l 300 -r 20 30

will restore files 20 through 30 from tape number 300.

There are some more ancient commands, which are still available

sfrestore -l <tapenum> -s <num> file1 file2

will skip over num files, and the restore the next two files and call them
"file1" and "file2"

=======================================================================
sfrestore_gui is a frontend to sfrestore.  You need the inclosed
version of sfrestore,

To use all you need to do is the following:
1) In a shell window, go to the directory in which
   you want to restore files from tape
2) launch sfrestore_gui
   If you do not launch it from a shell window you will
   see the output in the Console window instead.
3) in sfrestore_gui open a catalog file for the tape you
   want to restore
4) put a * to the right of any file you want to restore
   or
   make a selection of files consecutive files (make sure
   that you don't include any extraneous line. Also make sure
   that you include the line-feed on the last file in the 
   selection.)
5) in the do_restore menu, call setup, and it will list the
   files and a command string to double check
6) in the do_restore menu, call go, and it will do it.
   It will restore the files with the file name shown in the catalog

If you want to terminate prematurely use the kill menu item in the
do_restore menu

You need to edit the resource file Sfrestore_gui
and set the sfrestorepath value to the location of the
sfrestore binary.  The default is /musr/bin/sfrestore

This program assumes that the version of sfrestore is the
one hacked by brad garton, where file 1 is the first stored
file (unlike earlier versions which start with file 2, and
call the label file 1.)

I've also included sfbackup, and writelabel here, which are the
only other files needed for a complete backup/restore cycle.

====================================================================
Warnings:  Don't lose your catalog files.  It's good to back them up.  There
is no catalog stored on the tape (although you can do that).  If you lose your
catalog files, the tape files can be restore simply using dd.  Use a blocksize
bs=256k.  Thus to restore the 10th file on a tape you would have to say

mt -f /dev/nrtape fsf 10
dd if=/dev/tape of=somefilename bs=256k

(The label is stored as a 512k file).

Sometimes a tape may not rewind fully.  In this case a second attempt to backup
or restore may not scan the tape label properly.
In this case simply say

mt rewind

and try again

pl 1/30/98
