.TH DBCAT 1 "August 6, 2002"
.SH NAME
dbcat \- Send audio data to DB Fourier Synthesis daemon
.SH SYNOPSIS
.B dbcat
.RI [ options ]
.br
.SH DESCRIPTION
The \fBdbcat\fP tool provides a simple means to feed \fBdbfsd\fP with
audio data.  Both programs are part of the DBMix project, a digital audio
mixing system.  \fBdbcat\fP takes input data from its standard input only,
and is therefore usually used in a pipe with some other sound generating
program.
.SH OPTIONS
.TP
.B \-8
Input data comprises of PCM-coded 8bit unsigned samples.
(Default: 16bit signed samples.)
.TP
.BI \-c " n"
Connect to channel \fIn\fP of \fBdbfsd\fP.  (Default: first channel
available.)
.TP
.B \-d
Print out debug messages to console.  (Default: debugging disabled.)
.TP
.B \-h
Print summary of available options.
.TP
.B \-m
Input data is a mono stream.  (Default: interleaved stereo stream.)
.TP
.BI \-r " rate"
Input data is sampled at \fIrate\fP Hertz.  (Default: 44100Hz.)
.TP
.B \-v
Print version information.  (Default: no version information.)
.TP
.B \-S
Produce an endless stream of blank audio data (silence).  Any input data is
dropped.  This mode provides a dummy source useful for testing and
debugging.  (Default: pass on input data.)
.SH EXAMPLES
.TP
.I mpg321 -s test.mp3 | dbcat
Sends a 16bit/44.1kHz stereo audio stream decoded from test.mp3 off to
\fIdbfsd\fP.
.SH SEE ALSO
.BR dbin (1),
.BR dbfsd (1),
.BR dbmixer (1),
.BR dbmix (7).
.SH AUTHOR
This manual page was written by Daniel Kobras <kobras@debian.org>,
for the Debian GNU/Linux system (but may be used by others).  It is heavily
based on DBMix's README file written by Robert Michael S Dean.