.TH DBCAT 1 "August 6, 2002"
.SH NAME
dbin \- Connect sound card input to DB Fourier Synthesis daemon
.SH SYNOPSIS
.B dbin
.RI [ options ]
.br
.SH DESCRIPTION
The \fBdbin\fP tool allows to connect a sound card's input channel to
\fBdbfsd\fP.  Both \fBdbin\fP and \fBdbfsd\fP are part of the DBMix project,
a digital audio mixing system.  \fBdbin\fP is needed to mix in data from a
microphone, or from an external audio device plugged into the line-in jack.
.PP
The audio device used by \fBdbin\fP must support full-duplex operation.
Also, this device must not be used for the master or cue output of
\fBdbfsd\fP.  Otherwise, \fBdbin\fP will output but an empty audio stream.
.SH OPTIONS
.TP
.B \-8
Input data comprises of PCM-coded 8bit unsigned samples.
(Default: 16bit signed samples.)
.TP
.BI \-a " dev"
Connect to audio device \fIdev\fP.  (Default: /dev/dsp.)
.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 \-l
Audio input is a line-in source.  (Default: input is a microphone source.)
source.)
.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 \-s
Send output data to stdout.  (Default: Send output to \fBdbfsd\fP.)
\fIdbfsd\fP.
.SH SEE ALSO
.BR dbcat (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.