ALSA: jack: Update documention to reflect other userspace interfaces
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / sound / core / sound_oss.c
CommitLineData
1da177e4
LT
1/*
2 * Advanced Linux Sound Architecture
c1017a4c 3 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
1da177e4
LT
4 *
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 *
20 */
21
1da177e4
LT
22#ifdef CONFIG_SND_OSSEMUL
23
24#if !defined(CONFIG_SOUND) && !(defined(MODULE) && defined(CONFIG_SOUND_MODULE))
25#error "Enable the OSS soundcore multiplexer (CONFIG_SOUND) in the kernel."
26#endif
27
28#include <linux/init.h>
d81a6d71 29#include <linux/export.h>
1da177e4
LT
30#include <linux/slab.h>
31#include <linux/time.h>
32#include <sound/core.h>
33#include <sound/minors.h>
34#include <sound/info.h>
35#include <linux/sound.h>
1a60d4c5 36#include <linux/mutex.h>
1da177e4 37
6983b724 38#define SNDRV_OSS_MINORS 128
1da177e4 39
6983b724 40static struct snd_minor *snd_oss_minors[SNDRV_OSS_MINORS];
1a60d4c5 41static DEFINE_MUTEX(sound_oss_mutex);
1da177e4 42
f87135f5
CL
43void *snd_lookup_oss_minor_data(unsigned int minor, int type)
44{
45 struct snd_minor *mreg;
46 void *private_data;
47
3a63e444 48 if (minor >= ARRAY_SIZE(snd_oss_minors))
f87135f5 49 return NULL;
1a60d4c5 50 mutex_lock(&sound_oss_mutex);
f87135f5
CL
51 mreg = snd_oss_minors[minor];
52 if (mreg && mreg->type == type)
53 private_data = mreg->private_data;
54 else
55 private_data = NULL;
1a60d4c5 56 mutex_unlock(&sound_oss_mutex);
f87135f5
CL
57 return private_data;
58}
59
c0d3fb39
TI
60EXPORT_SYMBOL(snd_lookup_oss_minor_data);
61
174c1f65 62static int snd_oss_kernel_minor(int type, struct snd_card *card, int dev)
1da177e4
LT
63{
64 int minor;
65
66 switch (type) {
67 case SNDRV_OSS_DEVICE_TYPE_MIXER:
7eaa943c
TI
68 if (snd_BUG_ON(!card || dev < 0 || dev > 1))
69 return -EINVAL;
1da177e4
LT
70 minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIXER1 : SNDRV_MINOR_OSS_MIXER));
71 break;
72 case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
73 minor = SNDRV_MINOR_OSS_SEQUENCER;
74 break;
75 case SNDRV_OSS_DEVICE_TYPE_MUSIC:
76 minor = SNDRV_MINOR_OSS_MUSIC;
77 break;
78 case SNDRV_OSS_DEVICE_TYPE_PCM:
7eaa943c
TI
79 if (snd_BUG_ON(!card || dev < 0 || dev > 1))
80 return -EINVAL;
1da177e4
LT
81 minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_PCM1 : SNDRV_MINOR_OSS_PCM));
82 break;
83 case SNDRV_OSS_DEVICE_TYPE_MIDI:
7eaa943c
TI
84 if (snd_BUG_ON(!card || dev < 0 || dev > 1))
85 return -EINVAL;
1da177e4
LT
86 minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIDI1 : SNDRV_MINOR_OSS_MIDI));
87 break;
88 case SNDRV_OSS_DEVICE_TYPE_DMFM:
89 minor = SNDRV_MINOR_OSS(card->number, SNDRV_MINOR_OSS_DMFM);
90 break;
91 case SNDRV_OSS_DEVICE_TYPE_SNDSTAT:
92 minor = SNDRV_MINOR_OSS_SNDSTAT;
93 break;
94 default:
95 return -EINVAL;
96 }
808c569f 97 if (minor < 0 || minor >= SNDRV_OSS_MINORS)
7eaa943c 98 return -EINVAL;
1da177e4
LT
99 return minor;
100}
101
174c1f65 102int snd_register_oss_device(int type, struct snd_card *card, int dev,
99ac48f5 103 const struct file_operations *f_ops, void *private_data,
f87135f5 104 const char *name)
1da177e4
LT
105{
106 int minor = snd_oss_kernel_minor(type, card, dev);
107 int minor_unit;
174c1f65 108 struct snd_minor *preg;
1da177e4
LT
109 int cidx = SNDRV_MINOR_OSS_CARD(minor);
110 int track2 = -1;
111 int register1 = -1, register2 = -1;
7d2aae1e 112 struct device *carddev = snd_card_get_device_link(card);
1da177e4 113
d001544d
CL
114 if (card && card->number >= 8)
115 return 0; /* ignore silently */
1da177e4
LT
116 if (minor < 0)
117 return minor;
6983b724 118 preg = kmalloc(sizeof(struct snd_minor), GFP_KERNEL);
1da177e4
LT
119 if (preg == NULL)
120 return -ENOMEM;
2af677fc 121 preg->type = type;
6983b724 122 preg->card = card ? card->number : -1;
1da177e4 123 preg->device = dev;
2af677fc 124 preg->f_ops = f_ops;
f87135f5 125 preg->private_data = private_data;
1a60d4c5 126 mutex_lock(&sound_oss_mutex);
6983b724 127 snd_oss_minors[minor] = preg;
1da177e4
LT
128 minor_unit = SNDRV_MINOR_OSS_DEVICE(minor);
129 switch (minor_unit) {
130 case SNDRV_MINOR_OSS_PCM:
131 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
132 break;
133 case SNDRV_MINOR_OSS_MIDI:
134 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
135 break;
136 case SNDRV_MINOR_OSS_MIDI1:
137 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
138 break;
139 }
2af677fc 140 register1 = register_sound_special_device(f_ops, minor, carddev);
1da177e4
LT
141 if (register1 != minor)
142 goto __end;
143 if (track2 >= 0) {
2af677fc
CL
144 register2 = register_sound_special_device(f_ops, track2,
145 carddev);
1da177e4
LT
146 if (register2 != track2)
147 goto __end;
f87135f5 148 snd_oss_minors[track2] = preg;
1da177e4 149 }
1a60d4c5 150 mutex_unlock(&sound_oss_mutex);
1da177e4
LT
151 return 0;
152
153 __end:
154 if (register2 >= 0)
155 unregister_sound_special(register2);
156 if (register1 >= 0)
157 unregister_sound_special(register1);
6983b724 158 snd_oss_minors[minor] = NULL;
1a60d4c5 159 mutex_unlock(&sound_oss_mutex);
1da177e4
LT
160 kfree(preg);
161 return -EBUSY;
162}
163
c0d3fb39
TI
164EXPORT_SYMBOL(snd_register_oss_device);
165
174c1f65 166int snd_unregister_oss_device(int type, struct snd_card *card, int dev)
1da177e4
LT
167{
168 int minor = snd_oss_kernel_minor(type, card, dev);
169 int cidx = SNDRV_MINOR_OSS_CARD(minor);
170 int track2 = -1;
174c1f65 171 struct snd_minor *mptr;
1da177e4 172
d001544d
CL
173 if (card && card->number >= 8)
174 return 0;
1da177e4
LT
175 if (minor < 0)
176 return minor;
1a60d4c5 177 mutex_lock(&sound_oss_mutex);
6983b724 178 mptr = snd_oss_minors[minor];
1da177e4 179 if (mptr == NULL) {
1a60d4c5 180 mutex_unlock(&sound_oss_mutex);
1da177e4
LT
181 return -ENOENT;
182 }
183 unregister_sound_special(minor);
184 switch (SNDRV_MINOR_OSS_DEVICE(minor)) {
185 case SNDRV_MINOR_OSS_PCM:
186 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
187 break;
188 case SNDRV_MINOR_OSS_MIDI:
189 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
190 break;
191 case SNDRV_MINOR_OSS_MIDI1:
192 track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
193 break;
194 }
f87135f5 195 if (track2 >= 0) {
1da177e4 196 unregister_sound_special(track2);
f87135f5
CL
197 snd_oss_minors[track2] = NULL;
198 }
6983b724 199 snd_oss_minors[minor] = NULL;
1a60d4c5 200 mutex_unlock(&sound_oss_mutex);
1da177e4
LT
201 kfree(mptr);
202 return 0;
203}
204
c0d3fb39
TI
205EXPORT_SYMBOL(snd_unregister_oss_device);
206
1da177e4
LT
207/*
208 * INFO PART
209 */
210
211#ifdef CONFIG_PROC_FS
212
6581f4e7 213static struct snd_info_entry *snd_minor_info_oss_entry;
1da177e4 214
2af677fc
CL
215static const char *snd_oss_device_type_name(int type)
216{
217 switch (type) {
218 case SNDRV_OSS_DEVICE_TYPE_MIXER:
219 return "mixer";
220 case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
221 case SNDRV_OSS_DEVICE_TYPE_MUSIC:
222 return "sequencer";
223 case SNDRV_OSS_DEVICE_TYPE_PCM:
224 return "digital audio";
225 case SNDRV_OSS_DEVICE_TYPE_MIDI:
226 return "raw midi";
227 case SNDRV_OSS_DEVICE_TYPE_DMFM:
228 return "hardware dependent";
229 default:
230 return "?";
231 }
232}
233
174c1f65
TI
234static void snd_minor_info_oss_read(struct snd_info_entry *entry,
235 struct snd_info_buffer *buffer)
1da177e4 236{
6983b724 237 int minor;
174c1f65 238 struct snd_minor *mptr;
1da177e4 239
1a60d4c5 240 mutex_lock(&sound_oss_mutex);
6983b724
CL
241 for (minor = 0; minor < SNDRV_OSS_MINORS; ++minor) {
242 if (!(mptr = snd_oss_minors[minor]))
243 continue;
244 if (mptr->card >= 0)
245 snd_iprintf(buffer, "%3i: [%i-%2i]: %s\n", minor,
246 mptr->card, mptr->device,
247 snd_oss_device_type_name(mptr->type));
248 else
249 snd_iprintf(buffer, "%3i: : %s\n", minor,
250 snd_oss_device_type_name(mptr->type));
1da177e4 251 }
1a60d4c5 252 mutex_unlock(&sound_oss_mutex);
1da177e4
LT
253}
254
1da177e4
LT
255
256int __init snd_minor_info_oss_init(void)
257{
174c1f65 258 struct snd_info_entry *entry;
1da177e4
LT
259
260 entry = snd_info_create_module_entry(THIS_MODULE, "devices", snd_oss_root);
261 if (entry) {
1da177e4
LT
262 entry->c.text.read = snd_minor_info_oss_read;
263 if (snd_info_register(entry) < 0) {
264 snd_info_free_entry(entry);
265 entry = NULL;
266 }
267 }
268 snd_minor_info_oss_entry = entry;
1da177e4
LT
269 return 0;
270}
271
272int __exit snd_minor_info_oss_done(void)
273{
746d4a02 274 snd_info_free_entry(snd_minor_info_oss_entry);
1da177e4
LT
275 return 0;
276}
e28563cc 277#endif /* CONFIG_PROC_FS */
1da177e4 278
1da177e4 279#endif /* CONFIG_SND_OSSEMUL */