[PATCH] orinoco: orinoco_xmit() should only return valid symbolic constants
[linux-2.6/sactl.git] / sound / core / pcm.c
blob122e10a61ab9c7e788c68e8991965ec3dd8beb6e
1 /*
2 * Digital Audio (PCM) abstract layer
3 * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
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.
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.
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
22 #include <sound/driver.h>
23 #include <linux/init.h>
24 #include <linux/slab.h>
25 #include <linux/time.h>
26 #include <linux/mutex.h>
27 #include <sound/core.h>
28 #include <sound/minors.h>
29 #include <sound/pcm.h>
30 #include <sound/control.h>
31 #include <sound/info.h>
33 MODULE_AUTHOR("Jaroslav Kysela <perex@suse.cz>, Abramo Bagnara <abramo@alsa-project.org>");
34 MODULE_DESCRIPTION("Midlevel PCM code for ALSA.");
35 MODULE_LICENSE("GPL");
37 static LIST_HEAD(snd_pcm_devices);
38 static LIST_HEAD(snd_pcm_notify_list);
39 static DEFINE_MUTEX(register_mutex);
41 static int snd_pcm_free(struct snd_pcm *pcm);
42 static int snd_pcm_dev_free(struct snd_device *device);
43 static int snd_pcm_dev_register(struct snd_device *device);
44 static int snd_pcm_dev_disconnect(struct snd_device *device);
45 static int snd_pcm_dev_unregister(struct snd_device *device);
47 static struct snd_pcm *snd_pcm_search(struct snd_card *card, int device)
49 struct list_head *p;
50 struct snd_pcm *pcm;
52 list_for_each(p, &snd_pcm_devices) {
53 pcm = list_entry(p, struct snd_pcm, list);
54 if (pcm->card == card && pcm->device == device)
55 return pcm;
57 return NULL;
60 static int snd_pcm_control_ioctl(struct snd_card *card,
61 struct snd_ctl_file *control,
62 unsigned int cmd, unsigned long arg)
64 switch (cmd) {
65 case SNDRV_CTL_IOCTL_PCM_NEXT_DEVICE:
67 int device;
69 if (get_user(device, (int __user *)arg))
70 return -EFAULT;
71 mutex_lock(&register_mutex);
72 device = device < 0 ? 0 : device + 1;
73 while (device < SNDRV_PCM_DEVICES) {
74 if (snd_pcm_search(card, device))
75 break;
76 device++;
78 if (device == SNDRV_PCM_DEVICES)
79 device = -1;
80 mutex_unlock(&register_mutex);
81 if (put_user(device, (int __user *)arg))
82 return -EFAULT;
83 return 0;
85 case SNDRV_CTL_IOCTL_PCM_INFO:
87 struct snd_pcm_info __user *info;
88 unsigned int device, subdevice;
89 int stream;
90 struct snd_pcm *pcm;
91 struct snd_pcm_str *pstr;
92 struct snd_pcm_substream *substream;
93 int err;
95 info = (struct snd_pcm_info __user *)arg;
96 if (get_user(device, &info->device))
97 return -EFAULT;
98 if (get_user(stream, &info->stream))
99 return -EFAULT;
100 if (stream < 0 || stream > 1)
101 return -EINVAL;
102 if (get_user(subdevice, &info->subdevice))
103 return -EFAULT;
104 mutex_lock(&register_mutex);
105 pcm = snd_pcm_search(card, device);
106 if (pcm == NULL) {
107 err = -ENXIO;
108 goto _error;
110 pstr = &pcm->streams[stream];
111 if (pstr->substream_count == 0) {
112 err = -ENOENT;
113 goto _error;
115 if (subdevice >= pstr->substream_count) {
116 err = -ENXIO;
117 goto _error;
119 for (substream = pstr->substream; substream;
120 substream = substream->next)
121 if (substream->number == (int)subdevice)
122 break;
123 if (substream == NULL) {
124 err = -ENXIO;
125 goto _error;
127 err = snd_pcm_info_user(substream, info);
128 _error:
129 mutex_unlock(&register_mutex);
130 return err;
132 case SNDRV_CTL_IOCTL_PCM_PREFER_SUBDEVICE:
134 int val;
136 if (get_user(val, (int __user *)arg))
137 return -EFAULT;
138 control->prefer_pcm_subdevice = val;
139 return 0;
142 return -ENOIOCTLCMD;
145 #if defined(CONFIG_PROC_FS) && defined(CONFIG_SND_VERBOSE_PROCFS)
147 #define STATE(v) [SNDRV_PCM_STATE_##v] = #v
148 #define STREAM(v) [SNDRV_PCM_STREAM_##v] = #v
149 #define READY(v) [SNDRV_PCM_READY_##v] = #v
150 #define XRUN(v) [SNDRV_PCM_XRUN_##v] = #v
151 #define SILENCE(v) [SNDRV_PCM_SILENCE_##v] = #v
152 #define TSTAMP(v) [SNDRV_PCM_TSTAMP_##v] = #v
153 #define ACCESS(v) [SNDRV_PCM_ACCESS_##v] = #v
154 #define START(v) [SNDRV_PCM_START_##v] = #v
155 #define FORMAT(v) [SNDRV_PCM_FORMAT_##v] = #v
156 #define SUBFORMAT(v) [SNDRV_PCM_SUBFORMAT_##v] = #v
158 static char *snd_pcm_format_names[] = {
159 FORMAT(S8),
160 FORMAT(U8),
161 FORMAT(S16_LE),
162 FORMAT(S16_BE),
163 FORMAT(U16_LE),
164 FORMAT(U16_BE),
165 FORMAT(S24_LE),
166 FORMAT(S24_BE),
167 FORMAT(U24_LE),
168 FORMAT(U24_BE),
169 FORMAT(S32_LE),
170 FORMAT(S32_BE),
171 FORMAT(U32_LE),
172 FORMAT(U32_BE),
173 FORMAT(FLOAT_LE),
174 FORMAT(FLOAT_BE),
175 FORMAT(FLOAT64_LE),
176 FORMAT(FLOAT64_BE),
177 FORMAT(IEC958_SUBFRAME_LE),
178 FORMAT(IEC958_SUBFRAME_BE),
179 FORMAT(MU_LAW),
180 FORMAT(A_LAW),
181 FORMAT(IMA_ADPCM),
182 FORMAT(MPEG),
183 FORMAT(GSM),
184 FORMAT(SPECIAL),
185 FORMAT(S24_3LE),
186 FORMAT(S24_3BE),
187 FORMAT(U24_3LE),
188 FORMAT(U24_3BE),
189 FORMAT(S20_3LE),
190 FORMAT(S20_3BE),
191 FORMAT(U20_3LE),
192 FORMAT(U20_3BE),
193 FORMAT(S18_3LE),
194 FORMAT(S18_3BE),
195 FORMAT(U18_3LE),
196 FORMAT(U18_3BE),
199 static const char *snd_pcm_format_name(snd_pcm_format_t format)
201 return snd_pcm_format_names[format];
204 static char *snd_pcm_stream_names[] = {
205 STREAM(PLAYBACK),
206 STREAM(CAPTURE),
209 static char *snd_pcm_state_names[] = {
210 STATE(OPEN),
211 STATE(SETUP),
212 STATE(PREPARED),
213 STATE(RUNNING),
214 STATE(XRUN),
215 STATE(DRAINING),
216 STATE(PAUSED),
217 STATE(SUSPENDED),
220 static char *snd_pcm_access_names[] = {
221 ACCESS(MMAP_INTERLEAVED),
222 ACCESS(MMAP_NONINTERLEAVED),
223 ACCESS(MMAP_COMPLEX),
224 ACCESS(RW_INTERLEAVED),
225 ACCESS(RW_NONINTERLEAVED),
228 static char *snd_pcm_subformat_names[] = {
229 SUBFORMAT(STD),
232 static char *snd_pcm_tstamp_mode_names[] = {
233 TSTAMP(NONE),
234 TSTAMP(MMAP),
237 static const char *snd_pcm_stream_name(int stream)
239 snd_assert(stream <= SNDRV_PCM_STREAM_LAST, return NULL);
240 return snd_pcm_stream_names[stream];
243 static const char *snd_pcm_access_name(snd_pcm_access_t access)
245 return snd_pcm_access_names[access];
248 static const char *snd_pcm_subformat_name(snd_pcm_subformat_t subformat)
250 return snd_pcm_subformat_names[subformat];
253 static const char *snd_pcm_tstamp_mode_name(int mode)
255 snd_assert(mode <= SNDRV_PCM_TSTAMP_LAST, return NULL);
256 return snd_pcm_tstamp_mode_names[mode];
259 static const char *snd_pcm_state_name(snd_pcm_state_t state)
261 return snd_pcm_state_names[state];
264 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
265 #include <linux/soundcard.h>
267 static const char *snd_pcm_oss_format_name(int format)
269 switch (format) {
270 case AFMT_MU_LAW:
271 return "MU_LAW";
272 case AFMT_A_LAW:
273 return "A_LAW";
274 case AFMT_IMA_ADPCM:
275 return "IMA_ADPCM";
276 case AFMT_U8:
277 return "U8";
278 case AFMT_S16_LE:
279 return "S16_LE";
280 case AFMT_S16_BE:
281 return "S16_BE";
282 case AFMT_S8:
283 return "S8";
284 case AFMT_U16_LE:
285 return "U16_LE";
286 case AFMT_U16_BE:
287 return "U16_BE";
288 case AFMT_MPEG:
289 return "MPEG";
290 default:
291 return "unknown";
294 #endif
296 static void snd_pcm_proc_info_read(struct snd_pcm_substream *substream,
297 struct snd_info_buffer *buffer)
299 struct snd_pcm_info *info;
300 int err;
302 if (! substream)
303 return;
305 info = kmalloc(sizeof(*info), GFP_KERNEL);
306 if (! info) {
307 printk(KERN_DEBUG "snd_pcm_proc_info_read: cannot malloc\n");
308 return;
311 err = snd_pcm_info(substream, info);
312 if (err < 0) {
313 snd_iprintf(buffer, "error %d\n", err);
314 kfree(info);
315 return;
317 snd_iprintf(buffer, "card: %d\n", info->card);
318 snd_iprintf(buffer, "device: %d\n", info->device);
319 snd_iprintf(buffer, "subdevice: %d\n", info->subdevice);
320 snd_iprintf(buffer, "stream: %s\n", snd_pcm_stream_name(info->stream));
321 snd_iprintf(buffer, "id: %s\n", info->id);
322 snd_iprintf(buffer, "name: %s\n", info->name);
323 snd_iprintf(buffer, "subname: %s\n", info->subname);
324 snd_iprintf(buffer, "class: %d\n", info->dev_class);
325 snd_iprintf(buffer, "subclass: %d\n", info->dev_subclass);
326 snd_iprintf(buffer, "subdevices_count: %d\n", info->subdevices_count);
327 snd_iprintf(buffer, "subdevices_avail: %d\n", info->subdevices_avail);
328 kfree(info);
331 static void snd_pcm_stream_proc_info_read(struct snd_info_entry *entry,
332 struct snd_info_buffer *buffer)
334 snd_pcm_proc_info_read(((struct snd_pcm_str *)entry->private_data)->substream,
335 buffer);
338 static void snd_pcm_substream_proc_info_read(struct snd_info_entry *entry,
339 struct snd_info_buffer *buffer)
341 snd_pcm_proc_info_read((struct snd_pcm_substream *)entry->private_data,
342 buffer);
345 static void snd_pcm_substream_proc_hw_params_read(struct snd_info_entry *entry,
346 struct snd_info_buffer *buffer)
348 struct snd_pcm_substream *substream = entry->private_data;
349 struct snd_pcm_runtime *runtime = substream->runtime;
350 if (!runtime) {
351 snd_iprintf(buffer, "closed\n");
352 return;
354 snd_pcm_stream_lock_irq(substream);
355 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
356 snd_iprintf(buffer, "no setup\n");
357 snd_pcm_stream_unlock_irq(substream);
358 return;
360 snd_iprintf(buffer, "access: %s\n", snd_pcm_access_name(runtime->access));
361 snd_iprintf(buffer, "format: %s\n", snd_pcm_format_name(runtime->format));
362 snd_iprintf(buffer, "subformat: %s\n", snd_pcm_subformat_name(runtime->subformat));
363 snd_iprintf(buffer, "channels: %u\n", runtime->channels);
364 snd_iprintf(buffer, "rate: %u (%u/%u)\n", runtime->rate, runtime->rate_num, runtime->rate_den);
365 snd_iprintf(buffer, "period_size: %lu\n", runtime->period_size);
366 snd_iprintf(buffer, "buffer_size: %lu\n", runtime->buffer_size);
367 snd_iprintf(buffer, "tick_time: %u\n", runtime->tick_time);
368 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
369 if (substream->oss.oss) {
370 snd_iprintf(buffer, "OSS format: %s\n", snd_pcm_oss_format_name(runtime->oss.format));
371 snd_iprintf(buffer, "OSS channels: %u\n", runtime->oss.channels);
372 snd_iprintf(buffer, "OSS rate: %u\n", runtime->oss.rate);
373 snd_iprintf(buffer, "OSS period bytes: %lu\n", (unsigned long)runtime->oss.period_bytes);
374 snd_iprintf(buffer, "OSS periods: %u\n", runtime->oss.periods);
375 snd_iprintf(buffer, "OSS period frames: %lu\n", (unsigned long)runtime->oss.period_frames);
377 #endif
378 snd_pcm_stream_unlock_irq(substream);
381 static void snd_pcm_substream_proc_sw_params_read(struct snd_info_entry *entry,
382 struct snd_info_buffer *buffer)
384 struct snd_pcm_substream *substream = entry->private_data;
385 struct snd_pcm_runtime *runtime = substream->runtime;
386 if (!runtime) {
387 snd_iprintf(buffer, "closed\n");
388 return;
390 snd_pcm_stream_lock_irq(substream);
391 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
392 snd_iprintf(buffer, "no setup\n");
393 snd_pcm_stream_unlock_irq(substream);
394 return;
396 snd_iprintf(buffer, "tstamp_mode: %s\n", snd_pcm_tstamp_mode_name(runtime->tstamp_mode));
397 snd_iprintf(buffer, "period_step: %u\n", runtime->period_step);
398 snd_iprintf(buffer, "sleep_min: %u\n", runtime->sleep_min);
399 snd_iprintf(buffer, "avail_min: %lu\n", runtime->control->avail_min);
400 snd_iprintf(buffer, "xfer_align: %lu\n", runtime->xfer_align);
401 snd_iprintf(buffer, "start_threshold: %lu\n", runtime->start_threshold);
402 snd_iprintf(buffer, "stop_threshold: %lu\n", runtime->stop_threshold);
403 snd_iprintf(buffer, "silence_threshold: %lu\n", runtime->silence_threshold);
404 snd_iprintf(buffer, "silence_size: %lu\n", runtime->silence_size);
405 snd_iprintf(buffer, "boundary: %lu\n", runtime->boundary);
406 snd_pcm_stream_unlock_irq(substream);
409 static void snd_pcm_substream_proc_status_read(struct snd_info_entry *entry,
410 struct snd_info_buffer *buffer)
412 struct snd_pcm_substream *substream = entry->private_data;
413 struct snd_pcm_runtime *runtime = substream->runtime;
414 struct snd_pcm_status status;
415 int err;
416 if (!runtime) {
417 snd_iprintf(buffer, "closed\n");
418 return;
420 memset(&status, 0, sizeof(status));
421 err = snd_pcm_status(substream, &status);
422 if (err < 0) {
423 snd_iprintf(buffer, "error %d\n", err);
424 return;
426 snd_iprintf(buffer, "state: %s\n", snd_pcm_state_name(status.state));
427 snd_iprintf(buffer, "trigger_time: %ld.%09ld\n",
428 status.trigger_tstamp.tv_sec, status.trigger_tstamp.tv_nsec);
429 snd_iprintf(buffer, "tstamp : %ld.%09ld\n",
430 status.tstamp.tv_sec, status.tstamp.tv_nsec);
431 snd_iprintf(buffer, "delay : %ld\n", status.delay);
432 snd_iprintf(buffer, "avail : %ld\n", status.avail);
433 snd_iprintf(buffer, "avail_max : %ld\n", status.avail_max);
434 snd_iprintf(buffer, "-----\n");
435 snd_iprintf(buffer, "hw_ptr : %ld\n", runtime->status->hw_ptr);
436 snd_iprintf(buffer, "appl_ptr : %ld\n", runtime->control->appl_ptr);
439 #ifdef CONFIG_SND_DEBUG
440 static void snd_pcm_xrun_debug_read(struct snd_info_entry *entry,
441 struct snd_info_buffer *buffer)
443 struct snd_pcm_str *pstr = entry->private_data;
444 snd_iprintf(buffer, "%d\n", pstr->xrun_debug);
447 static void snd_pcm_xrun_debug_write(struct snd_info_entry *entry,
448 struct snd_info_buffer *buffer)
450 struct snd_pcm_str *pstr = entry->private_data;
451 char line[64];
452 if (!snd_info_get_line(buffer, line, sizeof(line)))
453 pstr->xrun_debug = simple_strtoul(line, NULL, 10);
455 #endif
457 static int snd_pcm_stream_proc_init(struct snd_pcm_str *pstr)
459 struct snd_pcm *pcm = pstr->pcm;
460 struct snd_info_entry *entry;
461 char name[16];
463 sprintf(name, "pcm%i%c", pcm->device,
464 pstr->stream == SNDRV_PCM_STREAM_PLAYBACK ? 'p' : 'c');
465 if ((entry = snd_info_create_card_entry(pcm->card, name, pcm->card->proc_root)) == NULL)
466 return -ENOMEM;
467 entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
468 if (snd_info_register(entry) < 0) {
469 snd_info_free_entry(entry);
470 return -ENOMEM;
472 pstr->proc_root = entry;
474 if ((entry = snd_info_create_card_entry(pcm->card, "info", pstr->proc_root)) != NULL) {
475 snd_info_set_text_ops(entry, pstr, 256, snd_pcm_stream_proc_info_read);
476 if (snd_info_register(entry) < 0) {
477 snd_info_free_entry(entry);
478 entry = NULL;
481 pstr->proc_info_entry = entry;
483 #ifdef CONFIG_SND_DEBUG
484 if ((entry = snd_info_create_card_entry(pcm->card, "xrun_debug",
485 pstr->proc_root)) != NULL) {
486 entry->c.text.read_size = 64;
487 entry->c.text.read = snd_pcm_xrun_debug_read;
488 entry->c.text.write_size = 64;
489 entry->c.text.write = snd_pcm_xrun_debug_write;
490 entry->mode |= S_IWUSR;
491 entry->private_data = pstr;
492 if (snd_info_register(entry) < 0) {
493 snd_info_free_entry(entry);
494 entry = NULL;
497 pstr->proc_xrun_debug_entry = entry;
498 #endif
499 return 0;
502 static int snd_pcm_stream_proc_done(struct snd_pcm_str *pstr)
504 #ifdef CONFIG_SND_DEBUG
505 if (pstr->proc_xrun_debug_entry) {
506 snd_info_unregister(pstr->proc_xrun_debug_entry);
507 pstr->proc_xrun_debug_entry = NULL;
509 #endif
510 if (pstr->proc_info_entry) {
511 snd_info_unregister(pstr->proc_info_entry);
512 pstr->proc_info_entry = NULL;
514 if (pstr->proc_root) {
515 snd_info_unregister(pstr->proc_root);
516 pstr->proc_root = NULL;
518 return 0;
521 static int snd_pcm_substream_proc_init(struct snd_pcm_substream *substream)
523 struct snd_info_entry *entry;
524 struct snd_card *card;
525 char name[16];
527 card = substream->pcm->card;
529 sprintf(name, "sub%i", substream->number);
530 if ((entry = snd_info_create_card_entry(card, name, substream->pstr->proc_root)) == NULL)
531 return -ENOMEM;
532 entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
533 if (snd_info_register(entry) < 0) {
534 snd_info_free_entry(entry);
535 return -ENOMEM;
537 substream->proc_root = entry;
539 if ((entry = snd_info_create_card_entry(card, "info", substream->proc_root)) != NULL) {
540 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_info_read);
541 if (snd_info_register(entry) < 0) {
542 snd_info_free_entry(entry);
543 entry = NULL;
546 substream->proc_info_entry = entry;
548 if ((entry = snd_info_create_card_entry(card, "hw_params", substream->proc_root)) != NULL) {
549 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_hw_params_read);
550 if (snd_info_register(entry) < 0) {
551 snd_info_free_entry(entry);
552 entry = NULL;
555 substream->proc_hw_params_entry = entry;
557 if ((entry = snd_info_create_card_entry(card, "sw_params", substream->proc_root)) != NULL) {
558 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_sw_params_read);
559 if (snd_info_register(entry) < 0) {
560 snd_info_free_entry(entry);
561 entry = NULL;
564 substream->proc_sw_params_entry = entry;
566 if ((entry = snd_info_create_card_entry(card, "status", substream->proc_root)) != NULL) {
567 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_status_read);
568 if (snd_info_register(entry) < 0) {
569 snd_info_free_entry(entry);
570 entry = NULL;
573 substream->proc_status_entry = entry;
575 return 0;
578 static int snd_pcm_substream_proc_done(struct snd_pcm_substream *substream)
580 if (substream->proc_info_entry) {
581 snd_info_unregister(substream->proc_info_entry);
582 substream->proc_info_entry = NULL;
584 if (substream->proc_hw_params_entry) {
585 snd_info_unregister(substream->proc_hw_params_entry);
586 substream->proc_hw_params_entry = NULL;
588 if (substream->proc_sw_params_entry) {
589 snd_info_unregister(substream->proc_sw_params_entry);
590 substream->proc_sw_params_entry = NULL;
592 if (substream->proc_status_entry) {
593 snd_info_unregister(substream->proc_status_entry);
594 substream->proc_status_entry = NULL;
596 if (substream->proc_root) {
597 snd_info_unregister(substream->proc_root);
598 substream->proc_root = NULL;
600 return 0;
602 #else /* !CONFIG_PROC_FS */
603 static inline int snd_pcm_stream_proc_init(struct snd_pcm_str *pstr) { return 0; }
604 static inline int snd_pcm_stream_proc_done(struct snd_pcm_str *pstr) { return 0; }
605 static inline int snd_pcm_substream_proc_init(struct snd_pcm_substream *substream) { return 0; }
606 static inline int snd_pcm_substream_proc_done(struct snd_pcm_substream *substream) { return 0; }
607 #endif /* CONFIG_PROC_FS */
610 * snd_pcm_new_stream - create a new PCM stream
611 * @pcm: the pcm instance
612 * @stream: the stream direction, SNDRV_PCM_STREAM_XXX
613 * @substream_count: the number of substreams
615 * Creates a new stream for the pcm.
616 * The corresponding stream on the pcm must have been empty before
617 * calling this, i.e. zero must be given to the argument of
618 * snd_pcm_new().
620 * Returns zero if successful, or a negative error code on failure.
622 int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count)
624 int idx, err;
625 struct snd_pcm_str *pstr = &pcm->streams[stream];
626 struct snd_pcm_substream *substream, *prev;
628 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
629 mutex_init(&pstr->oss.setup_mutex);
630 #endif
631 pstr->stream = stream;
632 pstr->pcm = pcm;
633 pstr->substream_count = substream_count;
634 if (substream_count > 0) {
635 err = snd_pcm_stream_proc_init(pstr);
636 if (err < 0) {
637 snd_printk(KERN_ERR "Error in snd_pcm_stream_proc_init\n");
638 return err;
641 prev = NULL;
642 for (idx = 0, prev = NULL; idx < substream_count; idx++) {
643 substream = kzalloc(sizeof(*substream), GFP_KERNEL);
644 if (substream == NULL) {
645 snd_printk(KERN_ERR "Cannot allocate PCM substream\n");
646 return -ENOMEM;
648 substream->pcm = pcm;
649 substream->pstr = pstr;
650 substream->number = idx;
651 substream->stream = stream;
652 sprintf(substream->name, "subdevice #%i", idx);
653 substream->buffer_bytes_max = UINT_MAX;
654 if (prev == NULL)
655 pstr->substream = substream;
656 else
657 prev->next = substream;
658 err = snd_pcm_substream_proc_init(substream);
659 if (err < 0) {
660 snd_printk(KERN_ERR "Error in snd_pcm_stream_proc_init\n");
661 kfree(substream);
662 return err;
664 substream->group = &substream->self_group;
665 spin_lock_init(&substream->self_group.lock);
666 INIT_LIST_HEAD(&substream->self_group.substreams);
667 list_add_tail(&substream->link_list, &substream->self_group.substreams);
668 spin_lock_init(&substream->timer_lock);
669 prev = substream;
671 return 0;
675 * snd_pcm_new - create a new PCM instance
676 * @card: the card instance
677 * @id: the id string
678 * @device: the device index (zero based)
679 * @playback_count: the number of substreams for playback
680 * @capture_count: the number of substreams for capture
681 * @rpcm: the pointer to store the new pcm instance
683 * Creates a new PCM instance.
685 * The pcm operators have to be set afterwards to the new instance
686 * via snd_pcm_set_ops().
688 * Returns zero if successful, or a negative error code on failure.
690 int snd_pcm_new(struct snd_card *card, char *id, int device,
691 int playback_count, int capture_count,
692 struct snd_pcm ** rpcm)
694 struct snd_pcm *pcm;
695 int err;
696 static struct snd_device_ops ops = {
697 .dev_free = snd_pcm_dev_free,
698 .dev_register = snd_pcm_dev_register,
699 .dev_disconnect = snd_pcm_dev_disconnect,
700 .dev_unregister = snd_pcm_dev_unregister
703 snd_assert(rpcm != NULL, return -EINVAL);
704 *rpcm = NULL;
705 snd_assert(card != NULL, return -ENXIO);
706 pcm = kzalloc(sizeof(*pcm), GFP_KERNEL);
707 if (pcm == NULL) {
708 snd_printk(KERN_ERR "Cannot allocate PCM\n");
709 return -ENOMEM;
711 pcm->card = card;
712 pcm->device = device;
713 if (id)
714 strlcpy(pcm->id, id, sizeof(pcm->id));
715 if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_PLAYBACK, playback_count)) < 0) {
716 snd_pcm_free(pcm);
717 return err;
719 if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_CAPTURE, capture_count)) < 0) {
720 snd_pcm_free(pcm);
721 return err;
723 mutex_init(&pcm->open_mutex);
724 init_waitqueue_head(&pcm->open_wait);
725 if ((err = snd_device_new(card, SNDRV_DEV_PCM, pcm, &ops)) < 0) {
726 snd_pcm_free(pcm);
727 return err;
729 *rpcm = pcm;
730 return 0;
733 static void snd_pcm_free_stream(struct snd_pcm_str * pstr)
735 struct snd_pcm_substream *substream, *substream_next;
736 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
737 struct snd_pcm_oss_setup *setup, *setupn;
738 #endif
739 substream = pstr->substream;
740 while (substream) {
741 substream_next = substream->next;
742 snd_pcm_substream_proc_done(substream);
743 kfree(substream);
744 substream = substream_next;
746 snd_pcm_stream_proc_done(pstr);
747 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
748 for (setup = pstr->oss.setup_list; setup; setup = setupn) {
749 setupn = setup->next;
750 kfree(setup->task_name);
751 kfree(setup);
753 #endif
756 static int snd_pcm_free(struct snd_pcm *pcm)
758 snd_assert(pcm != NULL, return -ENXIO);
759 if (pcm->private_free)
760 pcm->private_free(pcm);
761 snd_pcm_lib_preallocate_free_for_all(pcm);
762 snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_PLAYBACK]);
763 snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_CAPTURE]);
764 kfree(pcm);
765 return 0;
768 static int snd_pcm_dev_free(struct snd_device *device)
770 struct snd_pcm *pcm = device->device_data;
771 return snd_pcm_free(pcm);
774 static void snd_pcm_tick_timer_func(unsigned long data)
776 struct snd_pcm_substream *substream = (struct snd_pcm_substream *) data;
777 snd_pcm_tick_elapsed(substream);
780 int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream,
781 struct file *file,
782 struct snd_pcm_substream **rsubstream)
784 struct snd_pcm_str * pstr;
785 struct snd_pcm_substream *substream;
786 struct snd_pcm_runtime *runtime;
787 struct snd_ctl_file *kctl;
788 struct snd_card *card;
789 struct list_head *list;
790 int prefer_subdevice = -1;
791 size_t size;
793 snd_assert(rsubstream != NULL, return -EINVAL);
794 *rsubstream = NULL;
795 snd_assert(pcm != NULL, return -ENXIO);
796 pstr = &pcm->streams[stream];
797 if (pstr->substream == NULL || pstr->substream_count == 0)
798 return -ENODEV;
800 card = pcm->card;
801 down_read(&card->controls_rwsem);
802 list_for_each(list, &card->ctl_files) {
803 kctl = snd_ctl_file(list);
804 if (kctl->pid == current->pid) {
805 prefer_subdevice = kctl->prefer_pcm_subdevice;
806 break;
809 up_read(&card->controls_rwsem);
811 switch (stream) {
812 case SNDRV_PCM_STREAM_PLAYBACK:
813 if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
814 for (substream = pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream; substream; substream = substream->next) {
815 if (SUBSTREAM_BUSY(substream))
816 return -EAGAIN;
819 break;
820 case SNDRV_PCM_STREAM_CAPTURE:
821 if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
822 for (substream = pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream; substream; substream = substream->next) {
823 if (SUBSTREAM_BUSY(substream))
824 return -EAGAIN;
827 break;
828 default:
829 return -EINVAL;
832 if (prefer_subdevice >= 0) {
833 for (substream = pstr->substream; substream; substream = substream->next)
834 if (!SUBSTREAM_BUSY(substream) && substream->number == prefer_subdevice)
835 goto __ok;
837 for (substream = pstr->substream; substream; substream = substream->next)
838 if (!SUBSTREAM_BUSY(substream))
839 break;
840 __ok:
841 if (substream == NULL)
842 return -EAGAIN;
844 runtime = kzalloc(sizeof(*runtime), GFP_KERNEL);
845 if (runtime == NULL)
846 return -ENOMEM;
848 size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status));
849 runtime->status = snd_malloc_pages(size, GFP_KERNEL);
850 if (runtime->status == NULL) {
851 kfree(runtime);
852 return -ENOMEM;
854 memset((void*)runtime->status, 0, size);
856 size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control));
857 runtime->control = snd_malloc_pages(size, GFP_KERNEL);
858 if (runtime->control == NULL) {
859 snd_free_pages((void*)runtime->status,
860 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
861 kfree(runtime);
862 return -ENOMEM;
864 memset((void*)runtime->control, 0, size);
866 init_waitqueue_head(&runtime->sleep);
867 atomic_set(&runtime->mmap_count, 0);
868 init_timer(&runtime->tick_timer);
869 runtime->tick_timer.function = snd_pcm_tick_timer_func;
870 runtime->tick_timer.data = (unsigned long) substream;
872 runtime->status->state = SNDRV_PCM_STATE_OPEN;
874 substream->runtime = runtime;
875 substream->private_data = pcm->private_data;
876 substream->ffile = file;
877 pstr->substream_opened++;
878 *rsubstream = substream;
879 return 0;
882 void snd_pcm_detach_substream(struct snd_pcm_substream *substream)
884 struct snd_pcm_runtime *runtime;
885 substream->file = NULL;
886 runtime = substream->runtime;
887 snd_assert(runtime != NULL, return);
888 if (runtime->private_free != NULL)
889 runtime->private_free(runtime);
890 snd_free_pages((void*)runtime->status,
891 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
892 snd_free_pages((void*)runtime->control,
893 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control)));
894 kfree(runtime->hw_constraints.rules);
895 kfree(runtime);
896 substream->runtime = NULL;
897 substream->pstr->substream_opened--;
900 static int snd_pcm_dev_register(struct snd_device *device)
902 int cidx, err;
903 struct snd_pcm_substream *substream;
904 struct list_head *list;
905 char str[16];
906 struct snd_pcm *pcm = device->device_data;
908 snd_assert(pcm != NULL && device != NULL, return -ENXIO);
909 mutex_lock(&register_mutex);
910 if (snd_pcm_search(pcm->card, pcm->device)) {
911 mutex_unlock(&register_mutex);
912 return -EBUSY;
914 list_add_tail(&pcm->list, &snd_pcm_devices);
915 for (cidx = 0; cidx < 2; cidx++) {
916 int devtype = -1;
917 if (pcm->streams[cidx].substream == NULL)
918 continue;
919 switch (cidx) {
920 case SNDRV_PCM_STREAM_PLAYBACK:
921 sprintf(str, "pcmC%iD%ip", pcm->card->number, pcm->device);
922 devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
923 break;
924 case SNDRV_PCM_STREAM_CAPTURE:
925 sprintf(str, "pcmC%iD%ic", pcm->card->number, pcm->device);
926 devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
927 break;
929 if ((err = snd_register_device(devtype, pcm->card,
930 pcm->device,
931 &snd_pcm_f_ops[cidx],
932 pcm, str)) < 0)
934 list_del(&pcm->list);
935 mutex_unlock(&register_mutex);
936 return err;
938 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
939 snd_pcm_timer_init(substream);
941 list_for_each(list, &snd_pcm_notify_list) {
942 struct snd_pcm_notify *notify;
943 notify = list_entry(list, struct snd_pcm_notify, list);
944 notify->n_register(pcm);
946 mutex_unlock(&register_mutex);
947 return 0;
950 static int snd_pcm_dev_disconnect(struct snd_device *device)
952 struct snd_pcm *pcm = device->device_data;
953 struct list_head *list;
954 struct snd_pcm_substream *substream;
955 int cidx;
957 mutex_lock(&register_mutex);
958 list_del_init(&pcm->list);
959 for (cidx = 0; cidx < 2; cidx++)
960 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
961 if (substream->runtime)
962 substream->runtime->status->state = SNDRV_PCM_STATE_DISCONNECTED;
963 list_for_each(list, &snd_pcm_notify_list) {
964 struct snd_pcm_notify *notify;
965 notify = list_entry(list, struct snd_pcm_notify, list);
966 notify->n_disconnect(pcm);
968 mutex_unlock(&register_mutex);
969 return 0;
972 static int snd_pcm_dev_unregister(struct snd_device *device)
974 int cidx, devtype;
975 struct snd_pcm_substream *substream;
976 struct list_head *list;
977 struct snd_pcm *pcm = device->device_data;
979 snd_assert(pcm != NULL, return -ENXIO);
980 mutex_lock(&register_mutex);
981 list_del(&pcm->list);
982 for (cidx = 0; cidx < 2; cidx++) {
983 devtype = -1;
984 switch (cidx) {
985 case SNDRV_PCM_STREAM_PLAYBACK:
986 devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
987 break;
988 case SNDRV_PCM_STREAM_CAPTURE:
989 devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
990 break;
992 snd_unregister_device(devtype, pcm->card, pcm->device);
993 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
994 snd_pcm_timer_done(substream);
996 list_for_each(list, &snd_pcm_notify_list) {
997 struct snd_pcm_notify *notify;
998 notify = list_entry(list, struct snd_pcm_notify, list);
999 notify->n_unregister(pcm);
1001 mutex_unlock(&register_mutex);
1002 return snd_pcm_free(pcm);
1005 int snd_pcm_notify(struct snd_pcm_notify *notify, int nfree)
1007 struct list_head *p;
1009 snd_assert(notify != NULL && notify->n_register != NULL && notify->n_unregister != NULL, return -EINVAL);
1010 mutex_lock(&register_mutex);
1011 if (nfree) {
1012 list_del(&notify->list);
1013 list_for_each(p, &snd_pcm_devices)
1014 notify->n_unregister(list_entry(p,
1015 struct snd_pcm, list));
1016 } else {
1017 list_add_tail(&notify->list, &snd_pcm_notify_list);
1018 list_for_each(p, &snd_pcm_devices)
1019 notify->n_register(list_entry(p, struct snd_pcm, list));
1021 mutex_unlock(&register_mutex);
1022 return 0;
1025 #ifdef CONFIG_PROC_FS
1027 * Info interface
1030 static void snd_pcm_proc_read(struct snd_info_entry *entry,
1031 struct snd_info_buffer *buffer)
1033 struct list_head *p;
1034 struct snd_pcm *pcm;
1036 mutex_lock(&register_mutex);
1037 list_for_each(p, &snd_pcm_devices) {
1038 pcm = list_entry(p, struct snd_pcm, list);
1039 snd_iprintf(buffer, "%02i-%02i: %s : %s",
1040 pcm->card->number, pcm->device, pcm->id, pcm->name);
1041 if (pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream)
1042 snd_iprintf(buffer, " : playback %i",
1043 pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream_count);
1044 if (pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream)
1045 snd_iprintf(buffer, " : capture %i",
1046 pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream_count);
1047 snd_iprintf(buffer, "\n");
1049 mutex_unlock(&register_mutex);
1052 static struct snd_info_entry *snd_pcm_proc_entry = NULL;
1054 static void snd_pcm_proc_init(void)
1056 struct snd_info_entry *entry;
1058 if ((entry = snd_info_create_module_entry(THIS_MODULE, "pcm", NULL)) != NULL) {
1059 snd_info_set_text_ops(entry, NULL, SNDRV_CARDS * SNDRV_PCM_DEVICES * 128,
1060 snd_pcm_proc_read);
1061 if (snd_info_register(entry) < 0) {
1062 snd_info_free_entry(entry);
1063 entry = NULL;
1066 snd_pcm_proc_entry = entry;
1069 static void snd_pcm_proc_done(void)
1071 if (snd_pcm_proc_entry)
1072 snd_info_unregister(snd_pcm_proc_entry);
1075 #else /* !CONFIG_PROC_FS */
1076 #define snd_pcm_proc_init()
1077 #define snd_pcm_proc_done()
1078 #endif /* CONFIG_PROC_FS */
1082 * ENTRY functions
1085 static int __init alsa_pcm_init(void)
1087 snd_ctl_register_ioctl(snd_pcm_control_ioctl);
1088 snd_ctl_register_ioctl_compat(snd_pcm_control_ioctl);
1089 snd_pcm_proc_init();
1090 return 0;
1093 static void __exit alsa_pcm_exit(void)
1095 snd_ctl_unregister_ioctl(snd_pcm_control_ioctl);
1096 snd_ctl_unregister_ioctl_compat(snd_pcm_control_ioctl);
1097 snd_pcm_proc_done();
1100 module_init(alsa_pcm_init)
1101 module_exit(alsa_pcm_exit)
1103 EXPORT_SYMBOL(snd_pcm_new);
1104 EXPORT_SYMBOL(snd_pcm_new_stream);
1105 EXPORT_SYMBOL(snd_pcm_notify);
1106 EXPORT_SYMBOL(snd_pcm_open_substream);
1107 EXPORT_SYMBOL(snd_pcm_release_substream);
1108 /* pcm_native.c */
1109 EXPORT_SYMBOL(snd_pcm_link_rwlock);
1110 #ifdef CONFIG_PM
1111 EXPORT_SYMBOL(snd_pcm_suspend);
1112 EXPORT_SYMBOL(snd_pcm_suspend_all);
1113 #endif
1114 EXPORT_SYMBOL(snd_pcm_kernel_ioctl);
1115 EXPORT_SYMBOL(snd_pcm_mmap_data);
1116 #if SNDRV_PCM_INFO_MMAP_IOMEM
1117 EXPORT_SYMBOL(snd_pcm_lib_mmap_iomem);
1118 #endif
1119 /* pcm_misc.c */
1120 EXPORT_SYMBOL(snd_pcm_format_signed);
1121 EXPORT_SYMBOL(snd_pcm_format_unsigned);
1122 EXPORT_SYMBOL(snd_pcm_format_linear);
1123 EXPORT_SYMBOL(snd_pcm_format_little_endian);
1124 EXPORT_SYMBOL(snd_pcm_format_big_endian);
1125 EXPORT_SYMBOL(snd_pcm_format_width);
1126 EXPORT_SYMBOL(snd_pcm_format_physical_width);
1127 EXPORT_SYMBOL(snd_pcm_format_size);
1128 EXPORT_SYMBOL(snd_pcm_format_silence_64);
1129 EXPORT_SYMBOL(snd_pcm_format_set_silence);
1130 EXPORT_SYMBOL(snd_pcm_build_linear_format);
1131 EXPORT_SYMBOL(snd_pcm_limit_hw_rates);