updated package versions
[minix.git] / man / man7 / osscore.7
blobbdf3f63feef24c361854a69451a70910d30d75d7
1 ." Automatically generated text
2 .TH 7 "August 31, 2006" "OSS" "OSS Devices"
3 .SH NAME
4 osscore - Open Sound Sytem core audio framework.
6 .SH DESCRIPTION
7 Open Sound System core audio support psudo driver. This driver implements the core Open Sound System API for audio, midi, mixer and synth functions. This driver also implements the OS driver interface as well as device configuration and setup. 
8 More information on programming on the OSS API is avaialable at:
9 http://manuals.opensound.com/
11 .SH OPTIONS
12 .IP \(bu 3
13 ac97_recselect  When set to 1 this option enables independent
14                 recording source selection for the left and the right channel
15                 on AC97 devices. In this way it's possible to record audio
16                 streams so that (for example) the left channel signal comes
17                 from the microphone and
18                 the right channel signal from line-in. However when this
19                 option is enabled it's only possible to select the recording
20                 source by using a fully OSS 4.0 compatible mixer program such
21                 as ossxmix.
22                 Default: 0 - recording source is common to both channels.
23 .IP \(bu 3
24 ac97_amplifier  When set to 1 this option enables the speaker power
25                 amplifier feature of AC97 codec (if available).
26                 Some boards have this inverted, so this feature can be
27                 disabled by setting this option to 0.
28                 Affects all AC97 based audio devices in the system.
29                 Default: -1=autodetect correct setting.
30 .IP \(bu 3
31 cooked_enable           By default OSS will let applications to use sampling
32                 rates and formats that are not supported by the hardware.
33                 Instead OSS performs the necessary format conversions in
34                 software. Applications that don't tolerate this kind of
35                 conversions usually disable them by using features of the OSS
36                 API (SNDCTL_DSP_COOKEDMODE). If this option is set to 0 then
37                 the format conversions will be disabled for all applications
38                 and devices unless the application explicitly enables them.
39                 Default: 1 - conversions are enabled.
40                 This option should not be changed without very strong reasons.
41 .IP \(bu 3
42 detect_trace    Internal debugging (do not change). Default: 0
43 .IP \(bu 3
44 dma_buffsize    By default OSS will allocate audio DMA buffers with some
45                 system dependent default size (usually 64k but sometimes
46                 smaller). It is possible to change this default allocation by
47                 setting this option. Value of 0 means that the default size
48                 will be used. Value between 16 and 128 (kilobytes) can be used
49                 if the default size is not suitable for some reason.
50                 Default: 0 - system dependent buffsize.
51                 This option mustn't be changed unless it's absolutely necessary.
52 .IP \(bu 3
53 max_intrate     Set the maximum number of interrupts per second.
54                 Default: 100 interrupts per second which equals to about
55                 10 msec minimum latencies.
56 .IP \(bu 3
57 vmix_disabled           The virtual mixer subsystem can be disabled by setting
58                 this configuration option to 1.
59                 Default: 0 - virtual mixer is enabled.
60 .IP \(bu 3
61 vmix_loopdevs           Optionally the virtual mixer subsystem can create
62                 special loopback audio devices that can be used to record the
63                 output mix sent to the device. This option tells how many
64                 loopback devices will be created (0, 1 or 2). If there are
65                 multiple audio devices in the system the all of them will have
66                 the same number of loopback devices.
67                 Default: 0 - no loopback devices are created.
68                 This setting should be left to 0 unless there are specific
69                 reasons to enable the loopback devices.
70 .IP \(bu 3
71 vmix_no_autoattach      By default (0) the low level
72                 drivers for most sound cards will automatically
73                 attach virtual mixer (vmix) to the primary audio devices of the cards.
74                 In some situations it may be necessary to attach virtual mixer using 
75                 nonstandard parameters. If vmix_no_autoattach is set to 1 then user
76                 can use vmixctl attach command to attach virtual mixer manually to
77                 the device(s).
78                 Default: 0 - Automatically attach virtual mixer.
80 .SH FILES
81 /usr/lib/oss/conf/osscore.conf Device configuration file
83 .SH AUTHOR
84 4Front Technologies