[BACK]Return to ossaudio.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libossaudio

Annotation of src/lib/libossaudio/ossaudio.3, Revision 1.20

1.20    ! joerg       1: .\"    $NetBSD: ossaudio.3,v 1.19 2009/02/03 12:48:00 jmcneill Exp $
1.1       augustss    2: .\"
                      3: .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
                      4: .\" All rights reserved.
                      5: .\"
1.9       augustss    6: .\" This code is derived from software contributed to The NetBSD Foundation
                      7: .\" by Lennart Augustsson,
                      8: .\"
1.1       augustss    9: .\" Redistribution and use in source and binary forms, with or without
                     10: .\" modification, are permitted provided that the following conditions
                     11: .\" are met:
                     12: .\" 1. Redistributions of source code must retain the above copyright
                     13: .\"    notice, this list of conditions and the following disclaimer.
                     14: .\" 2. Redistributions in binary form must reproduce the above copyright
                     15: .\"    notice, this list of conditions and the following disclaimer in the
                     16: .\"    documentation and/or other materials provided with the distribution.
                     17: .\"
                     18: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
                     19: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
                     20: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
1.9       augustss   21: .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
1.1       augustss   22: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
                     23: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
                     24: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                     25: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                     26: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
                     27: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
                     28: .\" POSSIBILITY OF SUCH DAMAGE.
                     29: .\"
1.19      jmcneill   30: .Dd February 3, 2009
1.1       augustss   31: .Dt OSSAUDIO 3
1.8       garbled    32: .Os
1.1       augustss   33: .Sh NAME
                     34: .Nm ossaudio
                     35: .Nd OSS audio emulation
1.6       perry      36: .Sh LIBRARY
                     37: .Lb libossaudio
1.1       augustss   38: .Sh SYNOPSIS
1.16      wiz        39: .In soundcard.h
1.1       augustss   40: .Sh DESCRIPTION
                     41: The
                     42: .Nm
                     43: library provides an emulation of the OSS (Linux) audio
                     44: interface.
                     45: .Pp
                     46: Use the native interface for new programs and the emulation
                     47: library only for porting programs.
1.18      jmcneill   48: .Ss Mixer Control Map
                     49: The following table summarizes the mappings from native interface
                     50: device names to OSS mixer controls.
                     51: .Pp
1.20    ! joerg      52: .Bl -column ".Sy Native Device Name" "SOUND_MIXER_SPEAKER"
        !            53: .It Sy "Native Device Name" Ta Sy "OSS Mixer Control"
        !            54: .It *.mic Ta SOUND_MIXER_MIC
        !            55: .It *.line Ta SOUND_MIXER_LINE
        !            56: .It *.cd Ta SOUND_MIXER_CD
        !            57: .It *.dac Ta SOUND_MIXER_PCM
        !            58: .It *.aux Ta SOUND_MIXER_LINE1
        !            59: .It *.record Ta SOUND_MIXER_IMIX
        !            60: .It *.master Ta SOUND_MIXER_VOLUME
        !            61: .It *.treble Ta SOUND_MIXER_TREBLE
        !            62: .It *.bass Ta SOUND_MIXER_BASS
        !            63: .It *.speaker Ta SOUND_MIXER_SPEAKER
        !            64: .It *.output Ta SOUND_MIXER_OGAIN
        !            65: .It *.input Ta SOUND_MIXER_IGAIN
        !            66: .It *.fmsynth Ta SOUND_MIXER_SYNTH
        !            67: .It *.midi Ta SOUND_MIXER_SYNTH
        !            68: .El
1.1       augustss   69: .Sh SEE ALSO
1.7       augustss   70: .Xr audio 4 ,
1.11      msaitoh    71: .Xr midi 4
1.14      wiz        72: .Sh HISTORY
                     73: The
                     74: .Nm
                     75: library first appeared in
                     76: .Nx 1.3 .
1.2       augustss   77: .Sh BUGS
1.14      wiz        78: The emulation uses a #define for
                     79: .Fn ioctl
1.5       augustss   80: so some obscure programs
1.2       augustss   81: can fail to compile.
                     82: .Pp
                     83: The emulation is incomplete.
1.5       augustss   84: .Pp
1.10      simonb     85: The emulation only covers
1.14      wiz        86: .Fn ioctl ,
1.15      wiz        87: there are other differences as well.
                     88: E.g., on a write
1.5       augustss   89: that would block in non-blocking mode Linux returns
                     90: .Dv EINTR
                     91: whereas
                     92: .Nx 1.3
                     93: returns
1.12      jdolecek   94: .Dv EAGAIN .

CVSweb <webmaster@jp.NetBSD.org>