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.12.2.2 2006/06/21 04:28:05 brueffer Exp $
  27 .\" $DragonFly: src/share/man/man4/snd_gusc.4,v 1.2 2007/06/16 17:44:33 hasso 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 Alternatively, to load the driver as a module at boot time, place the
  44 following line in
  45 .Xr loader.conf 5 :
  46 .Bd -literal -offset indent
  47 snd_gusc_load="YES"
  48 .Ed
  49 .Pp
  50 Non-PnP cards require a setting in the kernel config file:
  51 .Bd -literal -offset indent
  52 .Cd "device pcm0 at isa? port? irq 5 drq 1 flags 0x13"
  53 .Ed
  54 .Sh DESCRIPTION
  55 The
  56 .Nm
  57 bridge driver allows the generic audio driver
  58 .Xr sound 4
  59 to attach to Gravis UltraSound sound cards.
  60 .Pp
  61 The value of flags specifies the secondary DMA channel.
  62 If the secondary
  63 DMA channel is C, set the flags to (C | 0x10).
  64 For a sound card without the
  65 secondary DMA channel, the flags should be set to zero.
  66 .Sh HARDWARE
  67 The
  68 .Nm
  69 driver supports the following sound cards:
  70 .Pp
  71 .Bl -bullet -compact
  72 .It
  73 Gravis UltraSound MAX
  74 .It
  75 Gravis UltraSound PnP
  76 .El
  77 .Sh DIAGNOSTICS
  78 .Bl -diag
  79 .It xxx: gus pcm not attached, out of memory
  80 There are not enough memory to drive the device.
  81 .El
  82 .Sh SEE ALSO
  83 .Xr sound 4
  84 .Sh HISTORY
  85 The
  86 .Nm
  87 device driver first appeared in
  88 .Fx 4.0 .
  89 .Sh AUTHORS
  90 .An Ville-Pertti Keinonen Aq will@iki.fi
  91 .An Seigo Tanimura Aq tanimura@r.dl.itc.u-tokyo.ac.jp
  92 .Sh BUGS
  93 Recording pcm sound data is not supported yet.