.TH SFTAR CCSS-1 "Soundfile Edition"
.SH NAME
sftar \- tape archiver for the CARL/CCSS files
.SH SYNOPSIS
.B Sftar (CCSS)
[-rxtc108vwap] [-sbdf argument] [files ...]
.br
.B Tarsf (CARL)
[-rxtc108vwa] [-sbdf argument] [files ...]
.SH DESCRIPTION
.I Sftar
(or 
.IR Tarsf )
is a tape archiver for storing soundfiles in digital format.
Tapes produced by
.I sftar
are compatible with UNIX 
.I tar
format, although some information
(sampling rate, number of channels, etc.) will not be recovered
by extraction using UNIX 
.I tar.
This information is however on the tape in the
format described below (FORMAT). 
.I Sftar
can read a normal UNIX 
.I tar
tape and will ask the user for the sound file specification for
sampling rate, number of channels, size of the samples, and
and optional orchestra name which produced the sound file.
.I Sftar 
is different from
.I tar
in that it will read and write files across tapes.
A file then may exist as sections broken up by the amount of tape left
on a reel. 
.I Sftar 
will always ask if it is ok to split up files. Split up files when extracted 
from the tape will be put back together. 
.I Sftar 
will also check the sequence of sections to make sure that files
get put back in their correct order. When
.I sftar 
is interrupted it will finish writing a file to the tape and
on extraction it will write an incomplete file to the disk.
The commands for 
.I sftar
are those for
.I tar
with a few exceptions.
The options and commands are:
.sp
.RS
r - The named sound files  are written on              
.br
    the end of the tape.
.sp
x - The named files are extracted from the tape.
.br
    For CCSS files the deletion date of the soundfile
.br
    is the extraction time. If no files are specified
.br
    then the entire tape will be extracted. Multiple
.br
    tape entries will write over the previously 
.br
    extracted files.
.sp
t - The names of the specified files are listed each
.br
    time that they occur on the tape. If no files are
.br
    specified then the contents of the entire tape are
.br
    listed.
.sp
c - Create a new tape and write the specified file.
.bp
.sp
0 - The last letter of the tape file (/dev/mt? or
.br
    /dev/rmt? will be this character).
.sp
1 - The last letter of the tape file (/dev/mt? or
.br
    /dev/rmt? will be this character).
.sp
8 - The last letter of the tape file (/dev/mt? or
.br
    /dev/rmt? will be this character).
.sp
v - Normally 
.I sftar
does its work silently. This option 
.br
    will  cause
.I sftar
to type out more information           
.br
    about the files specified.
.br
    When used with the 
.B -t
option then all
.br
    information about a file on tape will be listed.
.sp
w - This causes 
.I sftar
to print the action to
.br
    be taken followed by the filename and then
.br
    waits for a confirmation. If a word starting
.br
    with a 'y' is given then the action is done.
.br
    Any other input causes tar to go on to the
.br   
    next filename.
.sp
a - This option will prompt the user to add         
.br
    a line of comment decribing the file. This
.br
    is useful if you're not going to see the
.br
    file for a long time.
.sp
s - The next argument will specify the size       
.br
    of the tape in feet. The default is
.br
    2300.
.sp
b - The next argument will specify the
.br
    blocking factor for raw magtape. The
.br
    range is 1 - 20.
.sp
d - The next argument will specify the
.br
    density of the tape. The
.br
    default is 1600. Others are 800 and 6250.
.sp
p - This flag is used to change the ownership of the
.br 
    extracted soundfile to the owner that is stored 
.br
    on the tape. This is only available to the 
.br
    superuser.
.sp
f - The next argument will be the name of
.br
    the archive device. For raw magtape
.br
    one would use /dev/rmt0 or /dev/rmt1.
.br
    The 
.I tar
option of using the standard input and
.br
    output can not be used with 
.I sftar 
(yet).
.RE
.sp
.bp
.SH FORMAT
A       
.I sftar 
tape contains a directory block which precedes each files
data blocks. The block size is 512 bytes. The record size
for raw magtapes is determined by the  
.B -b
option (number of blocks per record).
The contents
of the directory block are:
.sp
.RS
.nf
struct header {                 /* Directory structure */
	char name[NAMSIZ];
	char tpmode[8];
	char uid[8];
	char gid[8];
	char tpsize[12];
	char mtime[12];
	char chksum[8];
	char linkflag;
	char linkname[NAMSIZ];
	char tp_srate[12];
	char tp_chans[8];
	char tp_class[8];
	char tp_type[8];
	char tp_orchestra[16];
	char tp_sftarinfo[8];  	  /* For I/O across tapes */
	char comment[NAMSIZ];     /* Added line of english */
};
.fill
.RE
.sp
The tp_sftarinfo field contains
flags to tell about the splitting up of soundfiles. The
upper 8 bits are the virtual volume number of this tape.
Bit 0 is on if this file is only part of the total file
and bit 1 is on if this is the final section of a split
up file.
.SH SEE ALSO
tar(1), sfstat(CCSS-2)
.SH COMMENTS
There is a compile time switch that allows updating of 
raw magtape if the tape driver uses Berkeley's VAX UNIX tape
driver and ioctl commands.
If this option is used then the default blocking factor is
20 (10kb blocks).
