← Back to branch summary

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

« back to all changes in this revision

Viewing changes to misc/man9ossddk/ossddk_register_device.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_register_device.9ossddk
 
1
'\" te
 
2
.\"  Copyright (c) 2005, 4Front Technologies 2005\&.
 
3
.TH ossddk_register_device 9ossddk "12 Sep 2005" "SunOS 5.10" "OSS DDK Services"
 
4
.SH "NAME"
 
5
ossddk_register_device \- Registers a driver with OSS
 
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
\fBoss_device_t*\fR ossddk_register_device(\fBint \fIddkvers\fP, \fBdev_info_t *\fIdip\fP, \fBint \fIdrvtype\fP, \fBint \fIinstance\fP, \fBconst char *\fInick\fP, \fBddi_iblock_cookie_t \fIiblock_cookie\fP, \fBvoid *\fIdevc\fP, \fBconst char *\fIlongname\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\fIddkvers\fR
 
26
.in +16n
 
27
.rt
 
28
OSS DDK version. Set to OSSDDK_VERSION. Registering the driver will fail if the
 
29
version numbers are incompatible.
 
30
.in -16n
 
31
.sp
 
32
.ne 2
 
33
.mk
 
34
\fB\fIdip\fR
 
35
.in +16n
 
36
.rt
 
37
This is the \fIdip\fR parameter given by Solaris as the argument of driver's
 
38
attach routine.
 
39
.in -16n
 
40
.sp
 
41
.ne 2
 
42
.mk
 
43
\fB\fIdrvtype\fR
 
44
.in +16n
 
45
.rt
 
46
Bus type of the device. OSS DDK needs this parameter for some internal purposes.
 
47
Possible values are: DRV_PCI, DRV_USB and DRV_VIRTUAL. Some other values may be defined
 
48
in ossddk.h but they are not supported by the current version of OSS DDK.
 
49
.in -16n
 
50
.sp
 
51
.ne 2
 
52
.mk
 
53
\fB\fIinstance\fR
 
54
.in +16n
 
55
.rt
 
56
This is the instance number of this driver (see ddi_get_instance(9F)).
 
57
.in -16n
 
58
.sp
 
59
.ne 2
 
60
.mk
 
61
\fB\fInick\fR
 
62
.in +16n
 
63
.rt
 
64
Nick is a short name of the driver. Usually same as the name of the driver module.
 
65
.in -16n
 
66
.sp
 
67
.ne 2
 
68
.mk
 
69
\fB\fIiblock_cookie\fR
 
70
.in +16n
 
71
.rt
 
72
The iblock cookie for the device. Should be set to NULL if the driver is a pseudo
 
73
one or if there is no iblock cookie for some other reason.
 
74
.in -16n
 
75
.sp
 
76
.ne 2
 
77
.mk
 
78
\fB\fIdevc\fR
 
79
.in +16n
 
80
.rt
 
81
Pointer to driver defined device instance data. The driver can use this memory area
 
82
to store whatever information it wants.
 
83
.sp
 
84
.ne 2
 
85
.mk
 
86
\fB\fIlongname\fR
 
87
.in +16n
 
88
.rt
 
89
Full name of the device. For example manufacturer and model. Keep as short as possible
 
90
since too long names will be truncated.
 
91
.in -16n
 
92
.PP
 
93
.SH "DESCRIPTION"
 
94
.PP
 
95
This routine registers the device with OSS and returns the \fIosdev\fR handle. The call
 
96
must be made omce in driver's attach routine before any other OSS DDK calls are made.
 
97
.PP
 
98
.SH "RETURN VALUES"
 
99
This routine returns the osdev handle or NULL if the call failed.
 
100
.PP
 
101
.SH "SEE ALSO"
 
102
.PP
 
103
\fIWriting Sound Device Drivers with OSS DDK\fR
 
104
\fIOpen Sound System Programmer's Guide\fR