Blame doc/README-pcm-oss

Packit Service cd2a00
OSS <--> ALSA PCM plugin
Packit Service cd2a00
========================
Packit Service cd2a00
Packit Service cd2a00
This plugin converts the ALSA API over OSS API.  With this plugin,
Packit Service cd2a00
ALSA native apps can run on OSS drivers.
Packit Service cd2a00
Packit Service cd2a00
This plugin provides the PCM type "oss".  The typical configuration
Packit Service cd2a00
looks like below:
Packit Service cd2a00
Packit Service cd2a00
	pcm.oss {
Packit Service cd2a00
		type oss
Packit Service cd2a00
		device /dev/dsp
Packit Service cd2a00
	}
Packit Service cd2a00
Packit Service cd2a00
Put the above to ~/.asoundrc (or /etc/asound.conf), and use "oss" PCM
Packit Service cd2a00
with your ALSA apps.  For example,
Packit Service cd2a00
Packit Service cd2a00
	% aplay -Doss foo.wav
Packit Service cd2a00
Packit Service cd2a00
For playing arbitrary formats, you should use "plug" layer together,
Packit Service cd2a00
Packit Service cd2a00
	% aplay -Dplug:oss foo.wav
Packit Service cd2a00
Packit Service cd2a00
The oss plugin can have an option: device.  This specifies the device
Packit Service cd2a00
file path of OSS to open.  If not given, /dev/dsp is used.
Packit Service cd2a00
Packit Service cd2a00
The function supported by this plugin is limited.  For example, you
Packit Service cd2a00
cannot use dmix together with this plugin.  Don't expect too much :)
Packit Service cd2a00
Packit Service cd2a00
The plugin is installed in /usr/lib/alsa-lib directory as default,
Packit Service cd2a00
which is the default search path of additional plugins for alsa-lib.
Packit Service cd2a00
On a 64bit system like x86-64, the proper prefix option (typically,
Packit Service cd2a00
--prefix=/usr/lib64) must be given to configure script.