Add a manual page describing the LSI Fusion family of devices with a
[dragonfly.git] / share / man / man4 / 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/gusc.4,v 1.3.2.3 2001/08/17 13:08:37 ru Exp $
27 .\" $DragonFly: src/share/man/man4/gusc.4,v 1.2 2003/06/17 04:36:59 dillon Exp $
28 .\"
29 .Dd December 18, 1999
30 .Dt GUSC 4
31 .Os
32 .Sh NAME
33 .Nm gusc
34 .Nd Gravis UltraSound ISA bridge device driver
35 .Sh SYNOPSIS
36 For PnP cards:
37 .Cd "device gusc"
38 .Pp
39 For non-PnP cards:
40 .Cd "device gusc0 at isa? port 0x220 irq 5 drq 1 flags 0x13"
41 .Sh DESCRIPTION
42 The
43 .Nm
44 bridge driver allows the generic audio drivers including
45 .Xr pcm 4
46 to attach to the following ISA sound cards:
47 .Bl -bullet -width 2m
48 .It
49 Gravis UltraSound PnP
50 .It
51 Gravis UltraSound MAX
52 .El
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). For a sound card without the
57 secondary DMA channel, the flags should be set to zero.
58 .Sh DIAGNOSTICS
59 .Bl -diag
60 .It xxx: gus pcm not attached, out of memory
61 There are not enough memory to drive the device.
62 .El
63 .Sh HISTORY
64 The
65 .Nm
66 device driver first appeared in
67 .Fx 4.0 .
68 .Sh SEE ALSO
69 .Xr pcm 4
70 .Sh AUTHORS
71 .An Ville-Pertti Keinonen Aq will@iki.fi
72 .An Seigo Tanimura Aq tanimura@r.dl.itc.u-tokyo.ac.jp
73 .Sh BUGS
74 Recording pcm sound data is not supported yet.