share/man/man4/snd_gusc.4

   1 .\"
   2 .\" Copyright (c) 1999 Seigo Tanimura
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD: src/share/man/man4/snd_gusc.4,v 1.14 2006/06/18 17:53:04 brueffer Exp $
  27 .\" $DragonFly: src/share/man/man4/snd_gusc.4,v 1.1 2007/01/04 21:47:00 corecode Exp $
  28 .\"
  29 .Dd December 15, 2005
  30 .Dt SND_GUSC 4
  31 .Os
  32 .Sh NAME
  33 .Nm snd_gusc
  34 .Nd Gravis UltraSound ISA bridge device driver
  35 .Sh SYNOPSIS
  36 To compile this driver into the kernel, place the following lines in your
  37 kernel configuration file:
  38 .Bd -ragged -offset indent
  39 .Cd "device pcm"
  40 .Cd "device snd_gusc"
  41 .Ed
  42 .Pp
  43 Non-PnP cards require a setting in the kernel config file:
  44 .Bd -literal -offset indent
  45 .Cd "device pcm0 at isa? port? irq 5 drq 1 flags 0x15"
  46 .Ed
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 bridge driver allows the generic audio driver
  51 .Xr sound 4
  52 to attach to Gravis UltraSound sound cards.
  53 .Pp
  54 The value of flags specifies the secondary DMA channel.
  55 If the secondary
  56 DMA channel is C, set the flags to (C | 0x10).
  57 For a sound card without the
  58 secondary DMA channel, the flags should be set to zero.
  59 .Sh HARDWARE
  60 The
  61 .Nm
  62 driver supports the following sound cards:
  63 .Pp
  64 .Bl -bullet -compact
  65 .It
  66 Gravis UltraSound MAX
  67 .It
  68 Gravis UltraSound PnP
  69 .El
  70 .Sh DIAGNOSTICS
  71 .Bl -diag
  72 .It xxx: gus pcm not attached, out of memory
  73 There are not enough memory to drive the device.
  74 .El
  75 .Sh SEE ALSO
  76 .Xr sound 4
  77 .Sh HISTORY
  78 The
  79 .Nm
  80 device driver first appeared in
  81 .Fx 4.0 .
  82 .Sh AUTHORS
  83 .An Ville-Pertti Keinonen Aq will@iki.fi
  84 .An Seigo Tanimura Aq tanimura@r.dl.itc.u-tokyo.ac.jp
  85 .Sh BUGS
  86 Recording pcm sound data is not supported yet.