.TH "CSOUND" 1csound CARL
.SH NAME
csound 
- sound file management system.
.SH SYNOPSIS
.LP
.nf
burpsf 	- free space compaction for csound file system
catsf 	- concatenate sound files
cdsf 	- change csound file directory
chmodsf - change mode of a sound file
chownsf	- change owner of a sound file
closesf	- command level program to close a sound file
cpsf	- copy a sound file
dumpsf 	- dump sound files to tape
grepsf	- look for sample pattern in a sound file
holdsf	- set status of sound file to HOLD
keepsf	- set status of sound file to KEEP
locksf, unlocksf - lock/unlock a sound file system
lsf 	- list sound files, sound file directories
mixsnd	- mix sound files
mksfdir - make a sound file directory
mountsf - mount a csound volume
mvsf - move sound file
newsfsys - make new sound file system
opensf - closesf - user-level commands to open/close sound files.
play 	- play sound file(s) through DACs
purgesf	- list files that can be reaped
pwsf 	- print working sound file directory
reapsf	- reap (remove) old, unreferenced sound files
record - record sound file through ADCs
restorsf - restore sound files from magtape
retrosf	- output the retrograde of a sound file
rmsf 	- remove sound file(s)
scratchsf - set status of sound file to SCRATCH
sdc	- print usage statistics of a sound file system
sfck 	- check sound file system for soundness
sfdt 	- print csound dump statistics
sfnorm 	- write normalized samples on the standard output
sndcmp - compare two sound files.
sndhist  - produce histogram of sound file
sndin - read csound files onto standard output
sndout - write sound files.
umountsf - unmount a csound volume
visf - edit sound file parameters
.NH 1
.SH DESCRIPTION
The 
.B csound
file system was developed to address 
three distinct weaknesses which UNIX has in
recording, storing, manipulating and playing back high 
quality digital sound. 
The problems are data volume, data bandwidth and bookkeeping.
Each of these problems goes beyond
what can be handled conveniently by the regular 
.UX
file system, 
so a special file system just for sound has been constructed,
called the 
.B csound
file system.
.PP
The commands which make up the system are described above in the
Synopsis.  Manual pages exist for them all.  There is
a tutorial as well.  
A common library for all these programs enforces a common
management discipline on a raw partition of a UNIX file system which
is used for sample storage.  Regular UNIX files in a small partition
on the same physical medium contain text descriptions of the sample
data.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
"Managing Bad Blocks On A Csound File System", 
"CARL Real Time Sound File System",
"Managing A Csound Tape Dump Regimen",
"Introduction to the Csound File System", 
"Csound File System User Program Example", Gareth Loy.
.SH BUGS
The 
.B csound
file system emulates the structure and behavior of the UNIX file
system to a certain degree.  Differences are necessary both to
disambiguate the two file systems, and also because of the different
requirements of the data.  Some differences are due to the nature
of the environment of the shell: the 
.B csound
file system has no access to such things as "*" and other regular
expression syntax.
The handling of directories is not a full emulation of UNIX.
For instance, there is no notion of ".." although "." is supported
by most programs.  The weak implementation of directories in past
versions has been improved substantially.
