~ubuntu-branches/ubuntu/wily/oss4/wily

« back to all changes in this revision

Viewing changes to misc/man7/dsp.man

  • Committer: Bazaar Package Importer
  • Author(s): Romain Beauxis, Samuel Thibault, Romain Beauxis, Sebastien NOEL
  • Date: 2011-06-14 10:06:56 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20110614100656-cx4oc7u426zn812z
Tags: 4.2-build2004-1
[ Samuel Thibault ]
* debian/control: Add liboss4-salsa2, liboss4-salsa-dev and
  liboss4-salsa-asound2 packages, equivalent to (and will replace) those from
  the oss-libsalsa package (Closes: #589127).
* debian/patches/liboss4-salsa.patch: New patch to rename libsalsa into
  liboss4-salsa to avoid conflicts in the archive for no good reason.
* debian/rules: Make in libOSSlib and libsalsa.
* debian/liboss4-salsa-dev.install, debian/liboss4-salsa2.install,
  debian/liboss4-salsa-asound2.links, debian/liboss4-salsa-dev.links:
  Install liboss4-salsa libraries like was done in the oss-libsalsa package.
* include-alsa: Add a copy of ALSA 1.0.5 headers: Cf ALSA_1.0.* symbols in
  libsalsa, this is the roughly supported version.
* debian/copyright: Update for new include-alsa files.
* alsa.pc: New file for compatibility with libasound-dev.
* debian/control:
  - Add Vcs-Browser and Vcs-Svn fields.
  - Use linux-any instead of the list of Linux archs (Closes: #604679).
  - Make dkms dependency linux-any only.
* debian/patches/hurd_iot.patch: New patch to fix soundcard.h usage in
  libsalsa on hurd-i386.
* debian/patches/libsalsa_fixes.patch: New patch to fix some printf usages
  and ioctl declaration in libsalsa.
* debian/patches/no_EBADE.patch: New patch to cope with hurd-i386 not having
  EBADE.
* debian/patches/CFLAGS.patch: New patch to make oss4 take debian/rules
  CFLAGS into account.
* debian/patches/snd_asoundlib_version.patch: New patch to add
  snd_asoundlib_version().
* debian/patches/generic_srccconf.patch: New patch to fix source
  configuration on unknown archs.

[ Romain Beauxis ]
* Fixed README.Debian to only mention dkms' modules.
* Switch to dpkg-source 3.0 (quilt) format
* Added DM-Upload-Allowed: yes

[ Sebastien NOEL ]
* New upstream release (Closes: #595298, #619272).
* Fix typo in initscript (Closes: #627149).
* debian/control: adjust linux-headers dependencies (Closes: #628879).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
NAME
 
2
dsp - Open Sound System audio devices
 
3
 
 
4
DESCRIPTION
 
5
/dev/dsp is the default audio device in the system. It's connected to the
 
6
main speakers and the primary recording source (such as microphone). The system
 
7
administrator can set /dev/dsp to be a symbolic link to the desired default
 
8
device. The ossinfo utility can be used to list the available audio devices
 
9
in the system.
 
10
 
 
11
/dev/dsp_mmap, /dev/dsp_ac3, /dev/dsp_multich and /dev/dsp_spdifout are
 
12
default audio devices for specific applications such as games or media (DVD)
 
13
players.
 
14
 
 
15
DIRECT ACCESS AUDIO DEVICE FILES
 
16
OSS 4.0 (and later) will create audio devices under /dev/oss/<device> directory.
 
17
For example /dev/oss/sblive0/pcm0 is the first audio device that belongs to the
 
18
first Sound Blaster Live! or Audigy card in the system. These direct devices
 
19
are used when an application needs to access specific audio device (instead of
 
20
the default one).
 
21
 
 
22
You can use the ossinfo(1) utility with the -a option to get a list of the
 
23
available audio devices in the system.
 
24
 
 
25
LEGACY AUDIO DEVICE FILES
 
26
Traditionally OSS has created device files like /dev/dsp0 to /dev/dspN for
 
27
each audio device in the system. OSS 4.0 still supports this legacy naming.
 
28
These files are symbolic links to the actual device files located under
 
29
/dev/oss. The ossdevlinks(8) utility is used to manage these links and it
 
30
will be automatically invoked when OSS is started.
 
31
 
 
32
COMPATIBILITY
 
33
o The /dev/dsp (default() audio device file will be supported by all OSS
 
34
implementations and versions.
 
35
o The special purpose audio default devices (such as /dev/dsp_mmap) are only
 
36
supported by OSS 4.0 and later.
 
37
o The legacy audio device files (such as /dev/dsp1) are supported by all OSS
 
38
versions and implementations.
 
39
o New style audio device files (under /dev/oss) are only supported by OSS 4.0
 
40
and later. However some independent OSS implementations may only support
 
41
the legacy naming even they are otherwise OSS 4.0 compatible.
 
42
o /dev/dsp0 doesn't exist in all Linux systems which use /dev/dsp for the same
 
43
purpose. In such systems /dev/dsp points to the first audio device and 
 
44
/dev/dsp1 to the second.
 
45
 
 
46
PROGRAMMING INFORMATION
 
47
See the Audio Programming section of the OSS Programmer's Guide (DSP(2)) for
 
48
more info.
 
49
 
 
50
OPTIONS
 
51
None
 
52
 
 
53
FILES
 
54
o /dev/dsp              Default audio device
 
55
o /dev/dsp_mmap                 Default audio device for applications using mmap(2)
 
56
o /dev/dsp_ac3          Default audio device for applications sending Dolby
 
57
                        Digital (AC3) audio to an external receiver.
 
58
o /dev/dsp_multich      Default multichannel (4.0-7.1) audio output device
 
59
o /dev/dsp_spdifout     Default digital audio (S/PDIF) output device
 
60
o /dev/oss/<driver>/pcmN        Direct access device files for individual audio
 
61
                        devices.
 
62
o /dev/dsp0 to /dev/dspN        Legacy style direct access audio device files.
 
63
 
 
64
AUTHOR
 
65
4Front Technologies
 
66