Commit | Line | Data |
---|---|---|
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 | #include <linux/init.h> |
23 | #include <linux/slab.h> | |
24 | #include <linux/time.h> | |
9a1a2a1d | 25 | #include <linux/device.h> |
65a77217 | 26 | #include <linux/module.h> |
1da177e4 LT |
27 | #include <sound/core.h> |
28 | #include <sound/minors.h> | |
29 | #include <sound/info.h> | |
1da177e4 LT |
30 | #include <sound/control.h> |
31 | #include <sound/initval.h> | |
32 | #include <linux/kmod.h> | |
1a60d4c5 | 33 | #include <linux/mutex.h> |
1da177e4 | 34 | |
1da177e4 LT |
35 | static int major = CONFIG_SND_MAJOR; |
36 | int snd_major; | |
c0d3fb39 TI |
37 | EXPORT_SYMBOL(snd_major); |
38 | ||
1da177e4 | 39 | static int cards_limit = 1; |
1da177e4 | 40 | |
c1017a4c | 41 | MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>"); |
1da177e4 LT |
42 | MODULE_DESCRIPTION("Advanced Linux Sound Architecture driver for soundcards."); |
43 | MODULE_LICENSE("GPL"); | |
44 | module_param(major, int, 0444); | |
45 | MODULE_PARM_DESC(major, "Major # for sound driver."); | |
46 | module_param(cards_limit, int, 0444); | |
47 | MODULE_PARM_DESC(cards_limit, "Count of auto-loadable soundcards."); | |
1da177e4 LT |
48 | MODULE_ALIAS_CHARDEV_MAJOR(CONFIG_SND_MAJOR); |
49 | ||
50 | /* this one holds the actual max. card number currently available. | |
51 | * as default, it's identical with cards_limit option. when more | |
52 | * modules are loaded manually, this limit number increases, too. | |
53 | */ | |
54 | int snd_ecards_limit; | |
c0d3fb39 | 55 | EXPORT_SYMBOL(snd_ecards_limit); |
1da177e4 | 56 | |
6983b724 | 57 | static struct snd_minor *snd_minors[SNDRV_OS_MINORS]; |
1a60d4c5 | 58 | static DEFINE_MUTEX(sound_mutex); |
1da177e4 | 59 | |
ee2da997 | 60 | #ifdef CONFIG_MODULES |
1da177e4 LT |
61 | |
62 | /** | |
63 | * snd_request_card - try to load the card module | |
64 | * @card: the card number | |
65 | * | |
66 | * Tries to load the module "snd-card-X" for the given card number | |
ee2da997 | 67 | * via request_module. Returns immediately if already loaded. |
1da177e4 LT |
68 | */ |
69 | void snd_request_card(int card) | |
70 | { | |
746df948 | 71 | if (snd_card_locked(card)) |
1da177e4 LT |
72 | return; |
73 | if (card < 0 || card >= cards_limit) | |
74 | return; | |
75 | request_module("snd-card-%i", card); | |
76 | } | |
77 | ||
c0d3fb39 TI |
78 | EXPORT_SYMBOL(snd_request_card); |
79 | ||
1da177e4 LT |
80 | static void snd_request_other(int minor) |
81 | { | |
82 | char *str; | |
83 | ||
1da177e4 LT |
84 | switch (minor) { |
85 | case SNDRV_MINOR_SEQUENCER: str = "snd-seq"; break; | |
86 | case SNDRV_MINOR_TIMER: str = "snd-timer"; break; | |
87 | default: return; | |
88 | } | |
89 | request_module(str); | |
90 | } | |
91 | ||
ee2da997 | 92 | #endif /* modular kernel */ |
1da177e4 | 93 | |
f87135f5 CL |
94 | /** |
95 | * snd_lookup_minor_data - get user data of a registered device | |
96 | * @minor: the minor number | |
97 | * @type: device type (SNDRV_DEVICE_TYPE_XXX) | |
98 | * | |
99 | * Checks that a minor device with the specified type is registered, and returns | |
100 | * its user data pointer. | |
a0830dbd TI |
101 | * |
102 | * This function increments the reference counter of the card instance | |
103 | * if an associated instance with the given minor number and type is found. | |
104 | * The caller must call snd_card_unref() appropriately later. | |
eb7c06e8 YB |
105 | * |
106 | * Return: The user data pointer if the specified device is found. %NULL | |
107 | * otherwise. | |
f87135f5 CL |
108 | */ |
109 | void *snd_lookup_minor_data(unsigned int minor, int type) | |
110 | { | |
111 | struct snd_minor *mreg; | |
112 | void *private_data; | |
113 | ||
3a63e444 | 114 | if (minor >= ARRAY_SIZE(snd_minors)) |
f87135f5 | 115 | return NULL; |
1a60d4c5 | 116 | mutex_lock(&sound_mutex); |
f87135f5 | 117 | mreg = snd_minors[minor]; |
a0830dbd | 118 | if (mreg && mreg->type == type) { |
f87135f5 | 119 | private_data = mreg->private_data; |
8bb4d9ce | 120 | if (private_data && mreg->card_ptr) |
f2464064 | 121 | get_device(&mreg->card_ptr->card_dev); |
a0830dbd | 122 | } else |
f87135f5 | 123 | private_data = NULL; |
1a60d4c5 | 124 | mutex_unlock(&sound_mutex); |
f87135f5 CL |
125 | return private_data; |
126 | } | |
127 | ||
c0d3fb39 TI |
128 | EXPORT_SYMBOL(snd_lookup_minor_data); |
129 | ||
4cf19b84 TI |
130 | #ifdef CONFIG_MODULES |
131 | static struct snd_minor *autoload_device(unsigned int minor) | |
132 | { | |
133 | int dev; | |
134 | mutex_unlock(&sound_mutex); /* release lock temporarily */ | |
135 | dev = SNDRV_MINOR_DEVICE(minor); | |
136 | if (dev == SNDRV_MINOR_CONTROL) { | |
137 | /* /dev/aloadC? */ | |
138 | int card = SNDRV_MINOR_CARD(minor); | |
139 | if (snd_cards[card] == NULL) | |
140 | snd_request_card(card); | |
141 | } else if (dev == SNDRV_MINOR_GLOBAL) { | |
142 | /* /dev/aloadSEQ */ | |
143 | snd_request_other(minor); | |
144 | } | |
145 | mutex_lock(&sound_mutex); /* reacuire lock */ | |
146 | return snd_minors[minor]; | |
147 | } | |
148 | #else /* !CONFIG_MODULES */ | |
149 | #define autoload_device(minor) NULL | |
150 | #endif /* CONFIG_MODULES */ | |
151 | ||
152 | static int snd_open(struct inode *inode, struct file *file) | |
1da177e4 | 153 | { |
332682b1 | 154 | unsigned int minor = iminor(inode); |
512bbd6a | 155 | struct snd_minor *mptr = NULL; |
e84f9e57 | 156 | const struct file_operations *new_fops; |
1da177e4 LT |
157 | int err = 0; |
158 | ||
3a63e444 | 159 | if (minor >= ARRAY_SIZE(snd_minors)) |
332682b1 | 160 | return -ENODEV; |
4cf19b84 | 161 | mutex_lock(&sound_mutex); |
332682b1 CL |
162 | mptr = snd_minors[minor]; |
163 | if (mptr == NULL) { | |
4cf19b84 TI |
164 | mptr = autoload_device(minor); |
165 | if (!mptr) { | |
166 | mutex_unlock(&sound_mutex); | |
332682b1 | 167 | return -ENODEV; |
4cf19b84 | 168 | } |
1da177e4 | 169 | } |
e84f9e57 | 170 | new_fops = fops_get(mptr->f_ops); |
4cf19b84 | 171 | mutex_unlock(&sound_mutex); |
e84f9e57 AV |
172 | if (!new_fops) |
173 | return -ENODEV; | |
174 | replace_fops(file, new_fops); | |
4cf19b84 | 175 | |
e84f9e57 | 176 | if (file->f_op->open) |
1da177e4 | 177 | err = file->f_op->open(inode, file); |
1da177e4 LT |
178 | return err; |
179 | } | |
180 | ||
9c2e08c5 | 181 | static const struct file_operations snd_fops = |
1da177e4 LT |
182 | { |
183 | .owner = THIS_MODULE, | |
6038f373 AB |
184 | .open = snd_open, |
185 | .llseek = noop_llseek, | |
1da177e4 LT |
186 | }; |
187 | ||
332682b1 | 188 | #ifdef CONFIG_SND_DYNAMIC_MINORS |
03cfe6f5 | 189 | static int snd_find_free_minor(int type) |
332682b1 CL |
190 | { |
191 | int minor; | |
192 | ||
03cfe6f5 KS |
193 | /* static minors for module auto loading */ |
194 | if (type == SNDRV_DEVICE_TYPE_SEQUENCER) | |
195 | return SNDRV_MINOR_SEQUENCER; | |
196 | if (type == SNDRV_DEVICE_TYPE_TIMER) | |
197 | return SNDRV_MINOR_TIMER; | |
198 | ||
332682b1 | 199 | for (minor = 0; minor < ARRAY_SIZE(snd_minors); ++minor) { |
03cfe6f5 KS |
200 | /* skip static minors still used for module auto loading */ |
201 | if (SNDRV_MINOR_DEVICE(minor) == SNDRV_MINOR_CONTROL) | |
202 | continue; | |
203 | if (minor == SNDRV_MINOR_SEQUENCER || | |
204 | minor == SNDRV_MINOR_TIMER) | |
332682b1 CL |
205 | continue; |
206 | if (!snd_minors[minor]) | |
207 | return minor; | |
208 | } | |
209 | return -EBUSY; | |
210 | } | |
211 | #else | |
512bbd6a | 212 | static int snd_kernel_minor(int type, struct snd_card *card, int dev) |
1da177e4 LT |
213 | { |
214 | int minor; | |
215 | ||
216 | switch (type) { | |
217 | case SNDRV_DEVICE_TYPE_SEQUENCER: | |
218 | case SNDRV_DEVICE_TYPE_TIMER: | |
219 | minor = type; | |
220 | break; | |
221 | case SNDRV_DEVICE_TYPE_CONTROL: | |
7eaa943c TI |
222 | if (snd_BUG_ON(!card)) |
223 | return -EINVAL; | |
1da177e4 LT |
224 | minor = SNDRV_MINOR(card->number, type); |
225 | break; | |
226 | case SNDRV_DEVICE_TYPE_HWDEP: | |
227 | case SNDRV_DEVICE_TYPE_RAWMIDI: | |
228 | case SNDRV_DEVICE_TYPE_PCM_PLAYBACK: | |
229 | case SNDRV_DEVICE_TYPE_PCM_CAPTURE: | |
3eafc959 | 230 | case SNDRV_DEVICE_TYPE_COMPRESS: |
7eaa943c TI |
231 | if (snd_BUG_ON(!card)) |
232 | return -EINVAL; | |
1da177e4 LT |
233 | minor = SNDRV_MINOR(card->number, type + dev); |
234 | break; | |
235 | default: | |
236 | return -EINVAL; | |
237 | } | |
7eaa943c TI |
238 | if (snd_BUG_ON(minor < 0 || minor >= SNDRV_OS_MINORS)) |
239 | return -EINVAL; | |
1da177e4 LT |
240 | return minor; |
241 | } | |
332682b1 | 242 | #endif |
1da177e4 LT |
243 | |
244 | /** | |
40a4b263 | 245 | * snd_register_device - Register the ALSA device file for the card |
1da177e4 LT |
246 | * @type: the device type, SNDRV_DEVICE_TYPE_XXX |
247 | * @card: the card instance | |
248 | * @dev: the device index | |
2af677fc | 249 | * @f_ops: the file operations |
f87135f5 | 250 | * @private_data: user pointer for f_ops->open() |
40a4b263 | 251 | * @device: the device to register |
1da177e4 LT |
252 | * |
253 | * Registers an ALSA device file for the given card. | |
254 | * The operators have to be set in reg parameter. | |
255 | * | |
eb7c06e8 | 256 | * Return: Zero if successful, or a negative error code on failure. |
1da177e4 | 257 | */ |
40a4b263 TI |
258 | int snd_register_device(int type, struct snd_card *card, int dev, |
259 | const struct file_operations *f_ops, | |
260 | void *private_data, struct device *device) | |
1da177e4 | 261 | { |
332682b1 | 262 | int minor; |
92b7952d | 263 | int err = 0; |
512bbd6a | 264 | struct snd_minor *preg; |
1da177e4 | 265 | |
40a4b263 TI |
266 | if (snd_BUG_ON(!device)) |
267 | return -EINVAL; | |
268 | ||
562b590d | 269 | preg = kmalloc(sizeof *preg, GFP_KERNEL); |
1da177e4 LT |
270 | if (preg == NULL) |
271 | return -ENOMEM; | |
2af677fc | 272 | preg->type = type; |
6983b724 | 273 | preg->card = card ? card->number : -1; |
1da177e4 | 274 | preg->device = dev; |
2af677fc | 275 | preg->f_ops = f_ops; |
f87135f5 | 276 | preg->private_data = private_data; |
a0830dbd | 277 | preg->card_ptr = card; |
1a60d4c5 | 278 | mutex_lock(&sound_mutex); |
332682b1 | 279 | #ifdef CONFIG_SND_DYNAMIC_MINORS |
03cfe6f5 | 280 | minor = snd_find_free_minor(type); |
332682b1 CL |
281 | #else |
282 | minor = snd_kernel_minor(type, card, dev); | |
283 | if (minor >= 0 && snd_minors[minor]) | |
284 | minor = -EBUSY; | |
285 | #endif | |
286 | if (minor < 0) { | |
92b7952d TI |
287 | err = minor; |
288 | goto error; | |
1da177e4 | 289 | } |
92b7952d | 290 | |
40a4b263 TI |
291 | preg->dev = device; |
292 | device->devt = MKDEV(major, minor); | |
293 | err = device_add(device); | |
92b7952d TI |
294 | if (err < 0) |
295 | goto error; | |
2469049e | 296 | |
92b7952d TI |
297 | snd_minors[minor] = preg; |
298 | error: | |
1a60d4c5 | 299 | mutex_unlock(&sound_mutex); |
92b7952d TI |
300 | if (err < 0) |
301 | kfree(preg); | |
302 | return err; | |
1da177e4 | 303 | } |
40a4b263 | 304 | EXPORT_SYMBOL(snd_register_device); |
c0d3fb39 | 305 | |
9d19f48c TI |
306 | /* find the matching minor record |
307 | * return the index of snd_minor, or -1 if not found | |
308 | */ | |
309 | static int find_snd_minor(int type, struct snd_card *card, int dev) | |
310 | { | |
311 | int cardnum, minor; | |
312 | struct snd_minor *mptr; | |
313 | ||
314 | cardnum = card ? card->number : -1; | |
315 | for (minor = 0; minor < ARRAY_SIZE(snd_minors); ++minor) | |
316 | if ((mptr = snd_minors[minor]) != NULL && | |
317 | mptr->type == type && | |
318 | mptr->card == cardnum && | |
319 | mptr->device == dev) | |
320 | return minor; | |
321 | return -1; | |
322 | } | |
323 | ||
1da177e4 LT |
324 | /** |
325 | * snd_unregister_device - unregister the device on the given card | |
40a4b263 | 326 | * @dev: the device instance |
1da177e4 LT |
327 | * |
328 | * Unregisters the device file already registered via | |
329 | * snd_register_device(). | |
330 | * | |
eb7c06e8 | 331 | * Return: Zero if successful, or a negative error code on failure. |
1da177e4 | 332 | */ |
40a4b263 | 333 | int snd_unregister_device(struct device *dev) |
1da177e4 | 334 | { |
9d19f48c | 335 | int minor; |
92b7952d | 336 | struct snd_minor *preg; |
1da177e4 | 337 | |
1a60d4c5 | 338 | mutex_lock(&sound_mutex); |
40a4b263 TI |
339 | for (minor = 0; minor < ARRAY_SIZE(snd_minors); ++minor) { |
340 | preg = snd_minors[minor]; | |
341 | if (preg && preg->dev == dev) { | |
342 | snd_minors[minor] = NULL; | |
343 | device_del(dev); | |
344 | kfree(preg); | |
345 | break; | |
346 | } | |
1da177e4 | 347 | } |
1a60d4c5 | 348 | mutex_unlock(&sound_mutex); |
40a4b263 TI |
349 | if (minor >= ARRAY_SIZE(snd_minors)) |
350 | return -ENOENT; | |
1da177e4 LT |
351 | return 0; |
352 | } | |
c0d3fb39 TI |
353 | EXPORT_SYMBOL(snd_unregister_device); |
354 | ||
eb9c38d5 TI |
355 | /** |
356 | * snd_get_device - get the assigned device to the given type and device number | |
357 | * @type: the device type, SNDRV_DEVICE_TYPE_XXX | |
358 | * @card:the card instance | |
359 | * @dev: the device index | |
360 | * | |
361 | * The caller needs to release it via put_device() after using it. | |
caa751ba TI |
362 | */ |
363 | struct device *snd_get_device(int type, struct snd_card *card, int dev) | |
9d19f48c | 364 | { |
caa751ba TI |
365 | int minor; |
366 | struct device *d = NULL; | |
9d19f48c TI |
367 | |
368 | mutex_lock(&sound_mutex); | |
369 | minor = find_snd_minor(type, card, dev); | |
caa751ba TI |
370 | if (minor >= 0) { |
371 | d = snd_minors[minor]->dev; | |
372 | if (d) | |
373 | get_device(d); | |
374 | } | |
9d19f48c | 375 | mutex_unlock(&sound_mutex); |
caa751ba | 376 | return d; |
9d19f48c | 377 | } |
caa751ba | 378 | EXPORT_SYMBOL(snd_get_device); |
9d19f48c | 379 | |
e28563cc | 380 | #ifdef CONFIG_PROC_FS |
1da177e4 LT |
381 | /* |
382 | * INFO PART | |
383 | */ | |
384 | ||
6581f4e7 | 385 | static struct snd_info_entry *snd_minor_info_entry; |
1da177e4 | 386 | |
2af677fc CL |
387 | static const char *snd_device_type_name(int type) |
388 | { | |
389 | switch (type) { | |
390 | case SNDRV_DEVICE_TYPE_CONTROL: | |
391 | return "control"; | |
392 | case SNDRV_DEVICE_TYPE_HWDEP: | |
393 | return "hardware dependent"; | |
394 | case SNDRV_DEVICE_TYPE_RAWMIDI: | |
395 | return "raw midi"; | |
396 | case SNDRV_DEVICE_TYPE_PCM_PLAYBACK: | |
397 | return "digital audio playback"; | |
398 | case SNDRV_DEVICE_TYPE_PCM_CAPTURE: | |
399 | return "digital audio capture"; | |
400 | case SNDRV_DEVICE_TYPE_SEQUENCER: | |
401 | return "sequencer"; | |
402 | case SNDRV_DEVICE_TYPE_TIMER: | |
403 | return "timer"; | |
404 | default: | |
405 | return "?"; | |
406 | } | |
407 | } | |
408 | ||
512bbd6a | 409 | static void snd_minor_info_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer) |
1da177e4 | 410 | { |
6983b724 | 411 | int minor; |
512bbd6a | 412 | struct snd_minor *mptr; |
1da177e4 | 413 | |
1a60d4c5 | 414 | mutex_lock(&sound_mutex); |
6983b724 CL |
415 | for (minor = 0; minor < SNDRV_OS_MINORS; ++minor) { |
416 | if (!(mptr = snd_minors[minor])) | |
417 | continue; | |
418 | if (mptr->card >= 0) { | |
419 | if (mptr->device >= 0) | |
d001544d | 420 | snd_iprintf(buffer, "%3i: [%2i-%2i]: %s\n", |
6983b724 CL |
421 | minor, mptr->card, mptr->device, |
422 | snd_device_type_name(mptr->type)); | |
423 | else | |
d001544d | 424 | snd_iprintf(buffer, "%3i: [%2i] : %s\n", |
6983b724 CL |
425 | minor, mptr->card, |
426 | snd_device_type_name(mptr->type)); | |
427 | } else | |
d001544d | 428 | snd_iprintf(buffer, "%3i: : %s\n", minor, |
6983b724 | 429 | snd_device_type_name(mptr->type)); |
1da177e4 | 430 | } |
1a60d4c5 | 431 | mutex_unlock(&sound_mutex); |
1da177e4 LT |
432 | } |
433 | ||
434 | int __init snd_minor_info_init(void) | |
435 | { | |
512bbd6a | 436 | struct snd_info_entry *entry; |
1da177e4 LT |
437 | |
438 | entry = snd_info_create_module_entry(THIS_MODULE, "devices", NULL); | |
439 | if (entry) { | |
1da177e4 LT |
440 | entry->c.text.read = snd_minor_info_read; |
441 | if (snd_info_register(entry) < 0) { | |
442 | snd_info_free_entry(entry); | |
443 | entry = NULL; | |
444 | } | |
445 | } | |
446 | snd_minor_info_entry = entry; | |
447 | return 0; | |
448 | } | |
449 | ||
450 | int __exit snd_minor_info_done(void) | |
451 | { | |
746d4a02 | 452 | snd_info_free_entry(snd_minor_info_entry); |
1da177e4 LT |
453 | return 0; |
454 | } | |
e28563cc | 455 | #endif /* CONFIG_PROC_FS */ |
1da177e4 LT |
456 | |
457 | /* | |
458 | * INIT PART | |
459 | */ | |
460 | ||
461 | static int __init alsa_sound_init(void) | |
462 | { | |
1da177e4 LT |
463 | snd_major = major; |
464 | snd_ecards_limit = cards_limit; | |
1da177e4 | 465 | if (register_chrdev(major, "alsa", &snd_fops)) { |
f2f9307a | 466 | pr_err("ALSA core: unable to register native major device number %d\n", major); |
1da177e4 LT |
467 | return -EIO; |
468 | } | |
1da177e4 | 469 | if (snd_info_init() < 0) { |
1da177e4 | 470 | unregister_chrdev(major, "alsa"); |
1da177e4 LT |
471 | return -ENOMEM; |
472 | } | |
473 | snd_info_minor_register(); | |
1da177e4 | 474 | #ifndef MODULE |
f2f9307a | 475 | pr_info("Advanced Linux Sound Architecture Driver Initialized.\n"); |
1da177e4 LT |
476 | #endif |
477 | return 0; | |
478 | } | |
479 | ||
480 | static void __exit alsa_sound_exit(void) | |
481 | { | |
1da177e4 LT |
482 | snd_info_minor_unregister(); |
483 | snd_info_done(); | |
68fc4fab | 484 | unregister_chrdev(major, "alsa"); |
1da177e4 LT |
485 | } |
486 | ||
c181a13a TLSC |
487 | subsys_initcall(alsa_sound_init); |
488 | module_exit(alsa_sound_exit); |