← Back to branch summary

~ubuntu-branches/ubuntu/vivid/oss4/vivid

« back to all changes in this revision

Viewing changes to misc/man9ossddk/ossddk_adev_set_ratesource.9ossddk

  • 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
http://bugs.debian.org/589127
http://bugs.debian.org/604679
http://bugs.debian.org/595298
http://bugs.debian.org/619272
http://bugs.debian.org/627149
http://bugs.debian.org/628879
[ 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:
misc/man9ossddk/ossddk_adev_set_ratesource.9ossddk
 
1
'\" te
 
2
.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
 
3
.TH ossddk_adev_set_ratesource 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
 
4
.SH "NAME"
 
5
ossddk_adev_set_ratesource \- Sets the rate source
 
6
.PP
 
7
.SH "SYNOPSIS"
 
8
.nf
 
9
#include <sys/soundcard.h>
 
10
.LP
 
11
#include <sys/ossddk/ossddk.h>
 
12
.fi
 
13
.LP
 
14
\fBvoid\fR ossddk_adev_set_ratesource(\fBint \fIdev\fP, \fBint \fIrate_source\fP);
 
15
.PP
 
16
.SH "INTERFACE LEVEL"
 
17
.PP
 
18
Open Sound System specific (OSS 4.0 DDK)\&.
 
19
.PP
 
20
.SH "ARGUMENTS"
 
21
.PP
 
22
.sp
 
23
.ne 2
 
24
.mk
 
25
\fB\fIdev\fR
 
26
.in +16n
 
27
.rt
 
28
OSS audio device number.
 
29
.in -16n
 
30
.sp
 
31
.ne 2
 
32
.mk
 
33
\fB\fIrate_source\fR
 
34
.in +16n
 
35
.rt
 
36
Audio device number of the rate source.
 
37
.in -16n
 
38
.PP
 
39
.SH "DESCRIPTION"
 
40
.PP
 
41
In some cases the sampling rate of an audio device is locked with some other device.
 
42
This information may be usefull to some applications that support multiple 
 
43
simultaneous devices. Knowing that the devices are rate locked together makes it 
 
44
possible to bypass any synchronization mechanisms that are normally required.
 
45
.PP
 
46
The driver can set this parameter in the followinng cases:
 
47
.PP
 
48
1) The device is a virtual device that works on top of some other (real) device.
 
49
In that case the master device should be reported as the rate source.
 
50
.LP
 
51
2) If a sound card has multiple audio engines (recording or playback) then the
 
52
subsequent ones should report the first one as their rate source. However this should
 
53
only be done if all the engines use the same sample rate clock.
 
54
.LP
 
55
3) There may be multiple devices (cards) of the same type which are connected together
 
56
using some kind of sync cable. If the driver knows this it can use the first audio device
 
57
of the first card (or the mown master card) as the rate source for the other audio devices.
 
58
.PP
 
59
Sometimes several cards of different type may be syncronized together using
 
60
word clock or some other methods. In such cases the drivers should not try to
 
61
set the rate sources based on that. This situation will be handled by the upper
 
62
layers of OSS (in some future OSS versions).
 
63
 
 
64
.PP
 
65
.SH "SEE ALSO"
 
66
.PP
 
67
\fISNDCTL_AUDIOINFO(2oss)\fR
 
68
.LP
 
69
\fIWriting Sound Device Drivers with OSS DDK\fR
 
70
.LP
 
71
\fIOpen Sound System Programmer's Guide\fR