← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/oss4/oneiric-proposed

« back to all changes in this revision

Viewing changes to kernel/drv/osscore/osscore.man

  • Committer: Bazaar Package Importer
  • Author(s): Stefano Rivera
  • Date: 2011-06-16 20:37:48 UTC
  • mfrom: (5.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20110616203748-jbrxik6ql33z54co
Tags: 4.2-build2004-1ubuntu1
https://launchpad.net/bugs/746048
https://launchpad.net/bugs/770972
* Merge from Debian unstable.
  - Supports our current kernel (LP: #746048)
  Remaining changes:
  - debian/oss4-dkms.dkms.in: s/source/build/ in Kernel headers paths.
* ld-as-needed.patch: Re-order CC arguments to enable building with ld
  --as-needed (LP: #770972)

Show diffs side-by-side

added added

removed removed

Lines of Context:
kernel/drv/osscore/osscore.man
 
1
NAME
 
2
osscore - Open Sound Sytem core audio framework.
 
3
 
 
4
DESCRIPTION
 
5
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. 
 
6
More information on programming on the OSS API is avaialable at:
 
7
http://manuals.opensound.com/
 
8
 
 
9
OPTIONS
 
10
o ac97_recselect        When set to 1 this option enables independent
 
11
                recording source selection for the left and the right channel
 
12
                on AC97 devices. In this way it's possible to record audio
 
13
                streams so that (for example) the left channel signal comes
 
14
                from the microphone and
 
15
                the right channel signal from line-in. However when this
 
16
                option is enabled it's only possible to select the recording
 
17
                source by using a fully OSS 4.0 compatible mixer program such
 
18
                as ossxmix.
 
19
                Default: 0 - recording source is common to both channels.
 
20
o ac97_amplifier        When set to 1 this option enables the speaker power
 
21
                amplifier feature of AC97 codec (if available).
 
22
                Some boards have this inverted, so this feature can be
 
23
                disabled by setting this option to 0.
 
24
                Affects all AC97 based audio devices in the system.
 
25
                Default: -1=autodetect correct setting.
 
26
o cooked_enable         By default OSS will let applications to use sampling
 
27
                rates and formats that are not supported by the hardware.
 
28
                Instead OSS performs the necessary format conversions in
 
29
                software. Applications that don't tolerate this kind of
 
30
                conversions usually disable them by using features of the OSS
 
31
                API (SNDCTL_DSP_COOKEDMODE). If this option is set to 0 then
 
32
                the format conversions will be disabled for all applications
 
33
                and devices unless the application explicitly enables them.
 
34
                Default: 1 - conversions are enabled.
 
35
                This option should not be changed without very strong reasons.
 
36
o detect_trace  Internal debugging (do not change). Default: 0
 
37
o dma_buffsize  By default OSS will allocate audio DMA buffers with some
 
38
                system dependent default size (usually 64k but sometimes
 
39
                smaller). It is possible to change this default allocation by
 
40
                setting this option. Value of 0 means that the default size
 
41
                will be used. Value between 16 and 128 (kilobytes) can be used
 
42
                if the default size is not suitable for some reason.
 
43
                Default: 0 - system dependent buffsize.
 
44
                This option mustn't be changed unless it's absolutely necessary.
 
45
o max_intrate   Set the maximum number of interrupts per second.
 
46
                Default: 100 interrupts per second which equals to about
 
47
                10 msec minimum latencies.
 
48
o vmix_disabled         The virtual mixer subsystem can be disabled by setting
 
49
                this configuration option to 1.
 
50
                Default: 0 - virtual mixer is enabled.
 
51
o vmix_loopdevs         Optionally the virtual mixer subsystem can create
 
52
                special loopback audio devices that can be used to record the
 
53
                output mix sent to the device. This option tells how many
 
54
                loopback devices will be created (0, 1 or 2). If there are
 
55
                multiple audio devices in the system the all of them will have
 
56
                the same number of loopback devices.
 
57
                Default: 0 - no loopback devices are created.
 
58
                This setting should be left to 0 unless there are specific
 
59
                reasons to enable the loopback devices.
 
60
o vmix_no_autoattach    By default (0) the low level
 
61
                drivers for most sound cards will automatically
 
62
                attach virtual mixer (vmix) to the primary audio devices of the cards.
 
63
                In some situations it may be necessary to attach virtual mixer using 
 
64
                nonstandard parameters. If vmix_no_autoattach is set to 1 then user
 
65
                can use vmixctl attach command to attach virtual mixer manually to
 
66
                the device(s).
 
67
                Default: 0 - Automatically attach virtual mixer.
 
68
o excl_policy   The O_EXCL open() flag can be used by programs to bypass the
 
69
                virtual mixer. Setting excl_policy to 1 or 2 makes OSS ignore O_EXCL.
 
70
                A setting of 1 ignores O_EXCL from all but root processes,
 
71
                while a setting of 2 always ignores O_EXCL.
 
72
                Default: 0 - Do not ignore O_EXCL.
 
73
o mixer_muted   By default OSS will set most volume controls to audible level.
 
74
                If this causes problems then it's possible to ask OSS to set
 
75
                the levels to zero when the drivers are loaded. However the
 
76
                levels saved with the savemixer utility will get loaded few
 
77
                moments later when all OSS drivers have been started. Note that
 
78
                just some of the OSS drivers honor this setting.
 
79
                Values: 0 (default) - Use audible volumes, 1 - Set volumes to low.
 
80
 
 
81
FILES
 
82
CONFIGFILEPATH/osscore.conf Device configuration file
 
83
 
 
84
AUTHOR
 
85
4Front Technologies