.TH DUMPSF 1csound CARL 
.SH NAME
dumpsf 
- dump sound files to tape
.SH SYNOPSIS
.B dumpsf 
[flags] < files 
.br
Flags:
.RS .5i
.nf
-v  verbose, tells what files it is opening, 
	and on what tape they will go
-f  output file, if other than /dev/nrmt12;
-d  density to use in calculating the length of the dump 
	if other than 1600 bpi.
-i  source of filenames instead of standard input;
-s  tape size, in feet;
-n  notify operators when dump needs servicing.
-0-9  dump level, default: 9;
-u  suppress update of sfdumpinfo file
-l  lock the sound file system while the dump is in progress.
-e  estimate the amount of tape the dump will require, no dump.
.RE
.fi
.SH DESCRIPTION
.B dumpsf 
reads a list of sound file names off the standard input 
to be dumped to tape.  Filenames must be separated by newlines.
The tape must be mounted before running the
program.  After checking the files for readability and protection,
they are dumped.  If the dump requires more than one tape, you are
told how many will be needed.  You are also given the date, level of dump
and a unique tape id number to write on each tape of the dump.
The tape id is unique within each filesystem.
.PP
If the dump requires more than one tape, 
.B dumpsf 
rewinds the tape,
and tells you to mount the next tape.  It then waits until you have
done so, asking "Is the next tape mounted and ready to go?"  Type
"y" and press [RETURN] when ready and it will continue.
.PP
.PP
The format that 
.B dumpsf 
writes is as follows: 
On the first tape, a text file containing a
directory of all files on the dump is made, followed by EOF.  
The directory is preceeded by a text header indicating the nature of
the dump.  After this, and on each
subsequent tape in the dump, a directory of all files on this tape is
made, followed by EOF.  From there to the end of the tape (signified
by two EOFs), the sound files are written.  In writing a sound file,
first the sound descriptor file is written, then EOF, 
then the binary samples and another EOF.
.SH FILES
One file in each mounted filesystem named
/<device>/sfdumpinfo
contains the records of when various level dumps have been done.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
restorsf(1csound), sfdt(1csound).
"Managing a Csound Dump Regimen".
.SH DIAGNOSTICS
A notice of the dumpdate, level and unique tape id is given.
Files that cannot be dumped are noted.  Errors in writing the magtape
or reading the sound file system are noted and halt execution.
It prints "The dump is done" when finished.
.SH BUGS
There may be problems related to restoring a list of files that spread
across more than one tape at a time.  The symptom is a read error when
the second tape is mounted.  To get around this, run 
.B restorsf 
for each batch of files on each separate tape.
.B restorsf
knows how to start up on other than the first tape of a dump series.
