← Back to branch summary

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

« back to all changes in this revision

Viewing changes to misc/man9ossddk/ossddk_adev_set_magic.9ossddk

  • 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:
misc/man9ossddk/ossddk_adev_set_magic.9ossddk
 
1
'\" te
 
2
.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
 
3
.TH ossddk_adev_set_magic 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
 
4
.SH "NAME"
 
5
ossddk_adev_set_magic \- Set the device magic number
 
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_magic(\fBint \fIdev\fP, \fBint \fImagic\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\fImagic\fR
 
34
.in +16n
 
35
.rt
 
36
The magic number.
 
37
.in -16n
 
38
.PP
 
39
.SH "DESCRIPTION"
 
40
.PP
 
41
Some devices may require use of dedicated configuration or setup tools. In such cases
 
42
the driver must provide some kind of magic number which the utilities can use
 
43
to find out the right device (using \fISNDCTL_AUDIOINFO(2oss)\fR).
 
44
.PP
 
45
If an magic number is needed for some device driver you must contact support@opensound.com to get a free number. Drivers developers must not use self geterated magic numbers 
 
46
because they may conflict with other devices.
 
47
.PP
 
48
Using device specific utilities is not recommended but that method can be used if there
 
49
is no other choice.
 
50
.PP
 
51
.SH "SEE ALSO"
 
52
.PP
 
53
\fISNDCTL_AUDIOINFO(2oss)\fR
 
54
.LP
 
55
\fIWriting Sound Device Drivers with OSS DDK\fR
 
56
.LP
 
57
\fIOpen Sound System Programmer's Guide\fR