pcm.c revision 877211f5e1b1196179ba1290e8e1a3dc00427c55
1/*
2 *  Digital Audio (PCM) abstract layer
3 *  Copyright (c) by Jaroslav Kysela <perex@suse.cz>
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
22#include <sound/driver.h>
23#include <linux/init.h>
24#include <linux/slab.h>
25#include <linux/time.h>
26#include <sound/core.h>
27#include <sound/minors.h>
28#include <sound/pcm.h>
29#include <sound/control.h>
30#include <sound/info.h>
31
32MODULE_AUTHOR("Jaroslav Kysela <perex@suse.cz>, Abramo Bagnara <abramo@alsa-project.org>");
33MODULE_DESCRIPTION("Midlevel PCM code for ALSA.");
34MODULE_LICENSE("GPL");
35
36struct snd_pcm *snd_pcm_devices[SNDRV_CARDS * SNDRV_PCM_DEVICES];
37static LIST_HEAD(snd_pcm_notify_list);
38static DECLARE_MUTEX(register_mutex);
39
40static int snd_pcm_free(struct snd_pcm *pcm);
41static int snd_pcm_dev_free(struct snd_device *device);
42static int snd_pcm_dev_register(struct snd_device *device);
43static int snd_pcm_dev_disconnect(struct snd_device *device);
44static int snd_pcm_dev_unregister(struct snd_device *device);
45
46static int snd_pcm_control_ioctl(struct snd_card *card,
47				 struct snd_ctl_file *control,
48				 unsigned int cmd, unsigned long arg)
49{
50	unsigned int tmp;
51
52	tmp = card->number * SNDRV_PCM_DEVICES;
53	switch (cmd) {
54	case SNDRV_CTL_IOCTL_PCM_NEXT_DEVICE:
55		{
56			int device;
57
58			if (get_user(device, (int __user *)arg))
59				return -EFAULT;
60			device = device < 0 ? 0 : device + 1;
61			while (device < SNDRV_PCM_DEVICES) {
62				if (snd_pcm_devices[tmp + device])
63					break;
64				device++;
65			}
66			if (device == SNDRV_PCM_DEVICES)
67				device = -1;
68			if (put_user(device, (int __user *)arg))
69				return -EFAULT;
70			return 0;
71		}
72	case SNDRV_CTL_IOCTL_PCM_INFO:
73		{
74			struct snd_pcm_info __user *info;
75			unsigned int device, subdevice;
76			int stream;
77			struct snd_pcm *pcm;
78			struct snd_pcm_str *pstr;
79			struct snd_pcm_substream *substream;
80			info = (struct snd_pcm_info __user *)arg;
81			if (get_user(device, &info->device))
82				return -EFAULT;
83			if (device >= SNDRV_PCM_DEVICES)
84				return -ENXIO;
85			pcm = snd_pcm_devices[tmp + device];
86			if (pcm == NULL)
87				return -ENXIO;
88			if (get_user(stream, &info->stream))
89				return -EFAULT;
90			if (stream < 0 || stream > 1)
91				return -EINVAL;
92			pstr = &pcm->streams[stream];
93			if (pstr->substream_count == 0)
94				return -ENOENT;
95			if (get_user(subdevice, &info->subdevice))
96				return -EFAULT;
97			if (subdevice >= pstr->substream_count)
98				return -ENXIO;
99			for (substream = pstr->substream; substream; substream = substream->next)
100				if (substream->number == (int)subdevice)
101					break;
102			if (substream == NULL)
103				return -ENXIO;
104			return snd_pcm_info_user(substream, info);
105		}
106	case SNDRV_CTL_IOCTL_PCM_PREFER_SUBDEVICE:
107		{
108			int val;
109
110			if (get_user(val, (int __user *)arg))
111				return -EFAULT;
112			control->prefer_pcm_subdevice = val;
113			return 0;
114		}
115	}
116	return -ENOIOCTLCMD;
117}
118#define STATE(v) [SNDRV_PCM_STATE_##v] = #v
119#define STREAM(v) [SNDRV_PCM_STREAM_##v] = #v
120#define READY(v) [SNDRV_PCM_READY_##v] = #v
121#define XRUN(v) [SNDRV_PCM_XRUN_##v] = #v
122#define SILENCE(v) [SNDRV_PCM_SILENCE_##v] = #v
123#define TSTAMP(v) [SNDRV_PCM_TSTAMP_##v] = #v
124#define ACCESS(v) [SNDRV_PCM_ACCESS_##v] = #v
125#define START(v) [SNDRV_PCM_START_##v] = #v
126#define FORMAT(v) [SNDRV_PCM_FORMAT_##v] = #v
127#define SUBFORMAT(v) [SNDRV_PCM_SUBFORMAT_##v] = #v
128
129static char *snd_pcm_stream_names[] = {
130	STREAM(PLAYBACK),
131	STREAM(CAPTURE),
132};
133
134static char *snd_pcm_state_names[] = {
135	STATE(OPEN),
136	STATE(SETUP),
137	STATE(PREPARED),
138	STATE(RUNNING),
139	STATE(XRUN),
140	STATE(DRAINING),
141	STATE(PAUSED),
142	STATE(SUSPENDED),
143};
144
145static char *snd_pcm_access_names[] = {
146	ACCESS(MMAP_INTERLEAVED),
147	ACCESS(MMAP_NONINTERLEAVED),
148	ACCESS(MMAP_COMPLEX),
149	ACCESS(RW_INTERLEAVED),
150	ACCESS(RW_NONINTERLEAVED),
151};
152
153static char *snd_pcm_format_names[] = {
154	FORMAT(S8),
155	FORMAT(U8),
156	FORMAT(S16_LE),
157	FORMAT(S16_BE),
158	FORMAT(U16_LE),
159	FORMAT(U16_BE),
160	FORMAT(S24_LE),
161	FORMAT(S24_BE),
162	FORMAT(U24_LE),
163	FORMAT(U24_BE),
164	FORMAT(S32_LE),
165	FORMAT(S32_BE),
166	FORMAT(U32_LE),
167	FORMAT(U32_BE),
168	FORMAT(FLOAT_LE),
169	FORMAT(FLOAT_BE),
170	FORMAT(FLOAT64_LE),
171	FORMAT(FLOAT64_BE),
172	FORMAT(IEC958_SUBFRAME_LE),
173	FORMAT(IEC958_SUBFRAME_BE),
174	FORMAT(MU_LAW),
175	FORMAT(A_LAW),
176	FORMAT(IMA_ADPCM),
177	FORMAT(MPEG),
178	FORMAT(GSM),
179	FORMAT(SPECIAL),
180	FORMAT(S24_3LE),
181	FORMAT(S24_3BE),
182	FORMAT(U24_3LE),
183	FORMAT(U24_3BE),
184	FORMAT(S20_3LE),
185	FORMAT(S20_3BE),
186	FORMAT(U20_3LE),
187	FORMAT(U20_3BE),
188	FORMAT(S18_3LE),
189	FORMAT(S18_3BE),
190	FORMAT(U18_3LE),
191	FORMAT(U18_3BE),
192};
193
194static char *snd_pcm_subformat_names[] = {
195	SUBFORMAT(STD),
196};
197
198static char *snd_pcm_tstamp_mode_names[] = {
199	TSTAMP(NONE),
200	TSTAMP(MMAP),
201};
202
203static const char *snd_pcm_stream_name(int stream)
204{
205	snd_assert(stream <= SNDRV_PCM_STREAM_LAST, return NULL);
206	return snd_pcm_stream_names[stream];
207}
208
209static const char *snd_pcm_access_name(snd_pcm_access_t access)
210{
211	return snd_pcm_access_names[access];
212}
213
214const char *snd_pcm_format_name(snd_pcm_format_t format)
215{
216	return snd_pcm_format_names[format];
217}
218
219static const char *snd_pcm_subformat_name(snd_pcm_subformat_t subformat)
220{
221	return snd_pcm_subformat_names[subformat];
222}
223
224static const char *snd_pcm_tstamp_mode_name(int mode)
225{
226	snd_assert(mode <= SNDRV_PCM_TSTAMP_LAST, return NULL);
227	return snd_pcm_tstamp_mode_names[mode];
228}
229
230static const char *snd_pcm_state_name(snd_pcm_state_t state)
231{
232	return snd_pcm_state_names[state];
233}
234
235#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
236#include <linux/soundcard.h>
237static const char *snd_pcm_oss_format_name(int format)
238{
239	switch (format) {
240	case AFMT_MU_LAW:
241		return "MU_LAW";
242	case AFMT_A_LAW:
243		return "A_LAW";
244	case AFMT_IMA_ADPCM:
245		return "IMA_ADPCM";
246	case AFMT_U8:
247		return "U8";
248	case AFMT_S16_LE:
249		return "S16_LE";
250	case AFMT_S16_BE:
251		return "S16_BE";
252	case AFMT_S8:
253		return "S8";
254	case AFMT_U16_LE:
255		return "U16_LE";
256	case AFMT_U16_BE:
257		return "U16_BE";
258	case AFMT_MPEG:
259		return "MPEG";
260	default:
261		return "unknown";
262	}
263}
264#endif
265
266#ifdef CONFIG_PROC_FS
267static void snd_pcm_proc_info_read(struct snd_pcm_substream *substream,
268				   struct snd_info_buffer *buffer)
269{
270	struct snd_pcm_info *info;
271	int err;
272
273	if (! substream)
274		return;
275
276	info = kmalloc(sizeof(*info), GFP_KERNEL);
277	if (! info) {
278		printk(KERN_DEBUG "snd_pcm_proc_info_read: cannot malloc\n");
279		return;
280	}
281
282	err = snd_pcm_info(substream, info);
283	if (err < 0) {
284		snd_iprintf(buffer, "error %d\n", err);
285		kfree(info);
286		return;
287	}
288	snd_iprintf(buffer, "card: %d\n", info->card);
289	snd_iprintf(buffer, "device: %d\n", info->device);
290	snd_iprintf(buffer, "subdevice: %d\n", info->subdevice);
291	snd_iprintf(buffer, "stream: %s\n", snd_pcm_stream_name(info->stream));
292	snd_iprintf(buffer, "id: %s\n", info->id);
293	snd_iprintf(buffer, "name: %s\n", info->name);
294	snd_iprintf(buffer, "subname: %s\n", info->subname);
295	snd_iprintf(buffer, "class: %d\n", info->dev_class);
296	snd_iprintf(buffer, "subclass: %d\n", info->dev_subclass);
297	snd_iprintf(buffer, "subdevices_count: %d\n", info->subdevices_count);
298	snd_iprintf(buffer, "subdevices_avail: %d\n", info->subdevices_avail);
299	kfree(info);
300}
301
302static void snd_pcm_stream_proc_info_read(struct snd_info_entry *entry,
303					  struct snd_info_buffer *buffer)
304{
305	snd_pcm_proc_info_read(((struct snd_pcm_str *)entry->private_data)->substream,
306			       buffer);
307}
308
309static void snd_pcm_substream_proc_info_read(struct snd_info_entry *entry,
310					     struct snd_info_buffer *buffer)
311{
312	snd_pcm_proc_info_read((struct snd_pcm_substream *)entry->private_data,
313			       buffer);
314}
315
316static void snd_pcm_substream_proc_hw_params_read(struct snd_info_entry *entry,
317						  struct snd_info_buffer *buffer)
318{
319	struct snd_pcm_substream *substream = entry->private_data;
320	struct snd_pcm_runtime *runtime = substream->runtime;
321	if (!runtime) {
322		snd_iprintf(buffer, "closed\n");
323		return;
324	}
325	snd_pcm_stream_lock_irq(substream);
326	if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
327		snd_iprintf(buffer, "no setup\n");
328		snd_pcm_stream_unlock_irq(substream);
329		return;
330	}
331	snd_iprintf(buffer, "access: %s\n", snd_pcm_access_name(runtime->access));
332	snd_iprintf(buffer, "format: %s\n", snd_pcm_format_name(runtime->format));
333	snd_iprintf(buffer, "subformat: %s\n", snd_pcm_subformat_name(runtime->subformat));
334	snd_iprintf(buffer, "channels: %u\n", runtime->channels);
335	snd_iprintf(buffer, "rate: %u (%u/%u)\n", runtime->rate, runtime->rate_num, runtime->rate_den);
336	snd_iprintf(buffer, "period_size: %lu\n", runtime->period_size);
337	snd_iprintf(buffer, "buffer_size: %lu\n", runtime->buffer_size);
338	snd_iprintf(buffer, "tick_time: %u\n", runtime->tick_time);
339#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
340	if (substream->oss.oss) {
341		snd_iprintf(buffer, "OSS format: %s\n", snd_pcm_oss_format_name(runtime->oss.format));
342		snd_iprintf(buffer, "OSS channels: %u\n", runtime->oss.channels);
343		snd_iprintf(buffer, "OSS rate: %u\n", runtime->oss.rate);
344		snd_iprintf(buffer, "OSS period bytes: %lu\n", (unsigned long)runtime->oss.period_bytes);
345		snd_iprintf(buffer, "OSS periods: %u\n", runtime->oss.periods);
346		snd_iprintf(buffer, "OSS period frames: %lu\n", (unsigned long)runtime->oss.period_frames);
347	}
348#endif
349	snd_pcm_stream_unlock_irq(substream);
350}
351
352static void snd_pcm_substream_proc_sw_params_read(struct snd_info_entry *entry,
353						  struct snd_info_buffer *buffer)
354{
355	struct snd_pcm_substream *substream = entry->private_data;
356	struct snd_pcm_runtime *runtime = substream->runtime;
357	if (!runtime) {
358		snd_iprintf(buffer, "closed\n");
359		return;
360	}
361	snd_pcm_stream_lock_irq(substream);
362	if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
363		snd_iprintf(buffer, "no setup\n");
364		snd_pcm_stream_unlock_irq(substream);
365		return;
366	}
367	snd_iprintf(buffer, "tstamp_mode: %s\n", snd_pcm_tstamp_mode_name(runtime->tstamp_mode));
368	snd_iprintf(buffer, "period_step: %u\n", runtime->period_step);
369	snd_iprintf(buffer, "sleep_min: %u\n", runtime->sleep_min);
370	snd_iprintf(buffer, "avail_min: %lu\n", runtime->control->avail_min);
371	snd_iprintf(buffer, "xfer_align: %lu\n", runtime->xfer_align);
372	snd_iprintf(buffer, "start_threshold: %lu\n", runtime->start_threshold);
373	snd_iprintf(buffer, "stop_threshold: %lu\n", runtime->stop_threshold);
374	snd_iprintf(buffer, "silence_threshold: %lu\n", runtime->silence_threshold);
375	snd_iprintf(buffer, "silence_size: %lu\n", runtime->silence_size);
376	snd_iprintf(buffer, "boundary: %lu\n", runtime->boundary);
377	snd_pcm_stream_unlock_irq(substream);
378}
379
380static void snd_pcm_substream_proc_status_read(struct snd_info_entry *entry,
381					       struct snd_info_buffer *buffer)
382{
383	struct snd_pcm_substream *substream = entry->private_data;
384	struct snd_pcm_runtime *runtime = substream->runtime;
385	struct snd_pcm_status status;
386	int err;
387	if (!runtime) {
388		snd_iprintf(buffer, "closed\n");
389		return;
390	}
391	memset(&status, 0, sizeof(status));
392	err = snd_pcm_status(substream, &status);
393	if (err < 0) {
394		snd_iprintf(buffer, "error %d\n", err);
395		return;
396	}
397	snd_iprintf(buffer, "state: %s\n", snd_pcm_state_name(status.state));
398	snd_iprintf(buffer, "trigger_time: %ld.%09ld\n",
399		status.trigger_tstamp.tv_sec, status.trigger_tstamp.tv_nsec);
400	snd_iprintf(buffer, "tstamp      : %ld.%09ld\n",
401		status.tstamp.tv_sec, status.tstamp.tv_nsec);
402	snd_iprintf(buffer, "delay       : %ld\n", status.delay);
403	snd_iprintf(buffer, "avail       : %ld\n", status.avail);
404	snd_iprintf(buffer, "avail_max   : %ld\n", status.avail_max);
405	snd_iprintf(buffer, "-----\n");
406	snd_iprintf(buffer, "hw_ptr      : %ld\n", runtime->status->hw_ptr);
407	snd_iprintf(buffer, "appl_ptr    : %ld\n", runtime->control->appl_ptr);
408}
409#endif
410
411#ifdef CONFIG_SND_DEBUG
412static void snd_pcm_xrun_debug_read(struct snd_info_entry *entry,
413				    struct snd_info_buffer *buffer)
414{
415	struct snd_pcm_str *pstr = entry->private_data;
416	snd_iprintf(buffer, "%d\n", pstr->xrun_debug);
417}
418
419static void snd_pcm_xrun_debug_write(struct snd_info_entry *entry,
420				     struct snd_info_buffer *buffer)
421{
422	struct snd_pcm_str *pstr = entry->private_data;
423	char line[64];
424	if (!snd_info_get_line(buffer, line, sizeof(line)))
425		pstr->xrun_debug = simple_strtoul(line, NULL, 10);
426}
427#endif
428
429static int snd_pcm_stream_proc_init(struct snd_pcm_str *pstr)
430{
431	struct snd_pcm *pcm = pstr->pcm;
432	struct snd_info_entry *entry;
433	char name[16];
434
435	sprintf(name, "pcm%i%c", pcm->device,
436		pstr->stream == SNDRV_PCM_STREAM_PLAYBACK ? 'p' : 'c');
437	if ((entry = snd_info_create_card_entry(pcm->card, name, pcm->card->proc_root)) == NULL)
438		return -ENOMEM;
439	entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
440	if (snd_info_register(entry) < 0) {
441		snd_info_free_entry(entry);
442		return -ENOMEM;
443	}
444	pstr->proc_root = entry;
445
446	if ((entry = snd_info_create_card_entry(pcm->card, "info", pstr->proc_root)) != NULL) {
447		snd_info_set_text_ops(entry, pstr, 256, snd_pcm_stream_proc_info_read);
448		if (snd_info_register(entry) < 0) {
449			snd_info_free_entry(entry);
450			entry = NULL;
451		}
452	}
453	pstr->proc_info_entry = entry;
454
455#ifdef CONFIG_SND_DEBUG
456	if ((entry = snd_info_create_card_entry(pcm->card, "xrun_debug",
457						pstr->proc_root)) != NULL) {
458		entry->c.text.read_size = 64;
459		entry->c.text.read = snd_pcm_xrun_debug_read;
460		entry->c.text.write_size = 64;
461		entry->c.text.write = snd_pcm_xrun_debug_write;
462		entry->mode |= S_IWUSR;
463		entry->private_data = pstr;
464		if (snd_info_register(entry) < 0) {
465			snd_info_free_entry(entry);
466			entry = NULL;
467		}
468	}
469	pstr->proc_xrun_debug_entry = entry;
470#endif
471	return 0;
472}
473
474static int snd_pcm_stream_proc_done(struct snd_pcm_str *pstr)
475{
476#ifdef CONFIG_SND_DEBUG
477	if (pstr->proc_xrun_debug_entry) {
478		snd_info_unregister(pstr->proc_xrun_debug_entry);
479		pstr->proc_xrun_debug_entry = NULL;
480	}
481#endif
482	if (pstr->proc_info_entry) {
483		snd_info_unregister(pstr->proc_info_entry);
484		pstr->proc_info_entry = NULL;
485	}
486	if (pstr->proc_root) {
487		snd_info_unregister(pstr->proc_root);
488		pstr->proc_root = NULL;
489	}
490	return 0;
491}
492
493static int snd_pcm_substream_proc_init(struct snd_pcm_substream *substream)
494{
495	struct snd_info_entry *entry;
496	struct snd_card *card;
497	char name[16];
498
499	card = substream->pcm->card;
500
501	sprintf(name, "sub%i", substream->number);
502	if ((entry = snd_info_create_card_entry(card, name, substream->pstr->proc_root)) == NULL)
503		return -ENOMEM;
504	entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
505	if (snd_info_register(entry) < 0) {
506		snd_info_free_entry(entry);
507		return -ENOMEM;
508	}
509	substream->proc_root = entry;
510
511	if ((entry = snd_info_create_card_entry(card, "info", substream->proc_root)) != NULL) {
512		snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_info_read);
513		if (snd_info_register(entry) < 0) {
514			snd_info_free_entry(entry);
515			entry = NULL;
516		}
517	}
518	substream->proc_info_entry = entry;
519
520	if ((entry = snd_info_create_card_entry(card, "hw_params", substream->proc_root)) != NULL) {
521		snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_hw_params_read);
522		if (snd_info_register(entry) < 0) {
523			snd_info_free_entry(entry);
524			entry = NULL;
525		}
526	}
527	substream->proc_hw_params_entry = entry;
528
529	if ((entry = snd_info_create_card_entry(card, "sw_params", substream->proc_root)) != NULL) {
530		snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_sw_params_read);
531		if (snd_info_register(entry) < 0) {
532			snd_info_free_entry(entry);
533			entry = NULL;
534		}
535	}
536	substream->proc_sw_params_entry = entry;
537
538	if ((entry = snd_info_create_card_entry(card, "status", substream->proc_root)) != NULL) {
539		snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_status_read);
540		if (snd_info_register(entry) < 0) {
541			snd_info_free_entry(entry);
542			entry = NULL;
543		}
544	}
545	substream->proc_status_entry = entry;
546
547	return 0;
548}
549
550static int snd_pcm_substream_proc_done(struct snd_pcm_substream *substream)
551{
552	if (substream->proc_info_entry) {
553		snd_info_unregister(substream->proc_info_entry);
554		substream->proc_info_entry = NULL;
555	}
556	if (substream->proc_hw_params_entry) {
557		snd_info_unregister(substream->proc_hw_params_entry);
558		substream->proc_hw_params_entry = NULL;
559	}
560	if (substream->proc_sw_params_entry) {
561		snd_info_unregister(substream->proc_sw_params_entry);
562		substream->proc_sw_params_entry = NULL;
563	}
564	if (substream->proc_status_entry) {
565		snd_info_unregister(substream->proc_status_entry);
566		substream->proc_status_entry = NULL;
567	}
568	if (substream->proc_root) {
569		snd_info_unregister(substream->proc_root);
570		substream->proc_root = NULL;
571	}
572	return 0;
573}
574
575/**
576 * snd_pcm_new_stream - create a new PCM stream
577 * @pcm: the pcm instance
578 * @stream: the stream direction, SNDRV_PCM_STREAM_XXX
579 * @substream_count: the number of substreams
580 *
581 * Creates a new stream for the pcm.
582 * The corresponding stream on the pcm must have been empty before
583 * calling this, i.e. zero must be given to the argument of
584 * snd_pcm_new().
585 *
586 * Returns zero if successful, or a negative error code on failure.
587 */
588int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count)
589{
590	int idx, err;
591	struct snd_pcm_str *pstr = &pcm->streams[stream];
592	struct snd_pcm_substream *substream, *prev;
593
594#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
595	init_MUTEX(&pstr->oss.setup_mutex);
596#endif
597	pstr->stream = stream;
598	pstr->pcm = pcm;
599	pstr->substream_count = substream_count;
600	pstr->reg = &snd_pcm_reg[stream];
601	if (substream_count > 0) {
602		err = snd_pcm_stream_proc_init(pstr);
603		if (err < 0)
604			return err;
605	}
606	prev = NULL;
607	for (idx = 0, prev = NULL; idx < substream_count; idx++) {
608		substream = kzalloc(sizeof(*substream), GFP_KERNEL);
609		if (substream == NULL)
610			return -ENOMEM;
611		substream->pcm = pcm;
612		substream->pstr = pstr;
613		substream->number = idx;
614		substream->stream = stream;
615		sprintf(substream->name, "subdevice #%i", idx);
616		substream->buffer_bytes_max = UINT_MAX;
617		if (prev == NULL)
618			pstr->substream = substream;
619		else
620			prev->next = substream;
621		err = snd_pcm_substream_proc_init(substream);
622		if (err < 0) {
623			kfree(substream);
624			return err;
625		}
626		substream->group = &substream->self_group;
627		spin_lock_init(&substream->self_group.lock);
628		INIT_LIST_HEAD(&substream->self_group.substreams);
629		list_add_tail(&substream->link_list, &substream->self_group.substreams);
630		spin_lock_init(&substream->timer_lock);
631		prev = substream;
632	}
633	return 0;
634}
635
636/**
637 * snd_pcm_new - create a new PCM instance
638 * @card: the card instance
639 * @id: the id string
640 * @device: the device index (zero based)
641 * @playback_count: the number of substreams for playback
642 * @capture_count: the number of substreams for capture
643 * @rpcm: the pointer to store the new pcm instance
644 *
645 * Creates a new PCM instance.
646 *
647 * The pcm operators have to be set afterwards to the new instance
648 * via snd_pcm_set_ops().
649 *
650 * Returns zero if successful, or a negative error code on failure.
651 */
652int snd_pcm_new(struct snd_card *card, char *id, int device,
653		int playback_count, int capture_count,
654	        struct snd_pcm ** rpcm)
655{
656	struct snd_pcm *pcm;
657	int err;
658	static struct snd_device_ops ops = {
659		.dev_free = snd_pcm_dev_free,
660		.dev_register =	snd_pcm_dev_register,
661		.dev_disconnect = snd_pcm_dev_disconnect,
662		.dev_unregister = snd_pcm_dev_unregister
663	};
664
665	snd_assert(rpcm != NULL, return -EINVAL);
666	*rpcm = NULL;
667	snd_assert(card != NULL, return -ENXIO);
668	pcm = kzalloc(sizeof(*pcm), GFP_KERNEL);
669	if (pcm == NULL)
670		return -ENOMEM;
671	pcm->card = card;
672	pcm->device = device;
673	if (id) {
674		strlcpy(pcm->id, id, sizeof(pcm->id));
675	}
676	if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_PLAYBACK, playback_count)) < 0) {
677		snd_pcm_free(pcm);
678		return err;
679	}
680	if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_CAPTURE, capture_count)) < 0) {
681		snd_pcm_free(pcm);
682		return err;
683	}
684	init_MUTEX(&pcm->open_mutex);
685	init_waitqueue_head(&pcm->open_wait);
686	if ((err = snd_device_new(card, SNDRV_DEV_PCM, pcm, &ops)) < 0) {
687		snd_pcm_free(pcm);
688		return err;
689	}
690	*rpcm = pcm;
691	return 0;
692}
693
694static void snd_pcm_free_stream(struct snd_pcm_str * pstr)
695{
696	struct snd_pcm_substream *substream, *substream_next;
697#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
698	struct snd_pcm_oss_setup *setup, *setupn;
699#endif
700	substream = pstr->substream;
701	while (substream) {
702		substream_next = substream->next;
703		snd_pcm_substream_proc_done(substream);
704		kfree(substream);
705		substream = substream_next;
706	}
707	snd_pcm_stream_proc_done(pstr);
708#if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
709	for (setup = pstr->oss.setup_list; setup; setup = setupn) {
710		setupn = setup->next;
711		kfree(setup->task_name);
712		kfree(setup);
713	}
714#endif
715}
716
717static int snd_pcm_free(struct snd_pcm *pcm)
718{
719	snd_assert(pcm != NULL, return -ENXIO);
720	if (pcm->private_free)
721		pcm->private_free(pcm);
722	snd_pcm_lib_preallocate_free_for_all(pcm);
723	snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_PLAYBACK]);
724	snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_CAPTURE]);
725	kfree(pcm);
726	return 0;
727}
728
729static int snd_pcm_dev_free(struct snd_device *device)
730{
731	struct snd_pcm *pcm = device->device_data;
732	return snd_pcm_free(pcm);
733}
734
735static void snd_pcm_tick_timer_func(unsigned long data)
736{
737	struct snd_pcm_substream *substream = (struct snd_pcm_substream *) data;
738	snd_pcm_tick_elapsed(substream);
739}
740
741int snd_pcm_open_substream(struct snd_pcm *pcm, int stream,
742			   struct snd_pcm_substream **rsubstream)
743{
744	struct snd_pcm_str * pstr;
745	struct snd_pcm_substream *substream;
746	struct snd_pcm_runtime *runtime;
747	struct snd_ctl_file *kctl;
748	struct snd_card *card;
749	struct list_head *list;
750	int prefer_subdevice = -1;
751	size_t size;
752
753	snd_assert(rsubstream != NULL, return -EINVAL);
754	*rsubstream = NULL;
755	snd_assert(pcm != NULL, return -ENXIO);
756	pstr = &pcm->streams[stream];
757	if (pstr->substream == NULL)
758		return -ENODEV;
759
760	card = pcm->card;
761	down_read(&card->controls_rwsem);
762	list_for_each(list, &card->ctl_files) {
763		kctl = snd_ctl_file(list);
764		if (kctl->pid == current->pid) {
765			prefer_subdevice = kctl->prefer_pcm_subdevice;
766			break;
767		}
768	}
769	up_read(&card->controls_rwsem);
770
771	if (pstr->substream_count == 0)
772		return -ENODEV;
773	switch (stream) {
774	case SNDRV_PCM_STREAM_PLAYBACK:
775		if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
776			for (substream = pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream; substream; substream = substream->next) {
777				if (SUBSTREAM_BUSY(substream))
778					return -EAGAIN;
779			}
780		}
781		break;
782	case SNDRV_PCM_STREAM_CAPTURE:
783		if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
784			for (substream = pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream; substream; substream = substream->next) {
785				if (SUBSTREAM_BUSY(substream))
786					return -EAGAIN;
787			}
788		}
789		break;
790	default:
791		return -EINVAL;
792	}
793
794	if (prefer_subdevice >= 0) {
795		for (substream = pstr->substream; substream; substream = substream->next)
796			if (!SUBSTREAM_BUSY(substream) && substream->number == prefer_subdevice)
797				goto __ok;
798	}
799	for (substream = pstr->substream; substream; substream = substream->next)
800		if (!SUBSTREAM_BUSY(substream))
801			break;
802      __ok:
803	if (substream == NULL)
804		return -EAGAIN;
805
806	runtime = kzalloc(sizeof(*runtime), GFP_KERNEL);
807	if (runtime == NULL)
808		return -ENOMEM;
809
810	size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status));
811	runtime->status = snd_malloc_pages(size, GFP_KERNEL);
812	if (runtime->status == NULL) {
813		kfree(runtime);
814		return -ENOMEM;
815	}
816	memset((void*)runtime->status, 0, size);
817
818	size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control));
819	runtime->control = snd_malloc_pages(size, GFP_KERNEL);
820	if (runtime->control == NULL) {
821		snd_free_pages((void*)runtime->status,
822			       PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
823		kfree(runtime);
824		return -ENOMEM;
825	}
826	memset((void*)runtime->control, 0, size);
827
828	init_waitqueue_head(&runtime->sleep);
829	atomic_set(&runtime->mmap_count, 0);
830	init_timer(&runtime->tick_timer);
831	runtime->tick_timer.function = snd_pcm_tick_timer_func;
832	runtime->tick_timer.data = (unsigned long) substream;
833
834	runtime->status->state = SNDRV_PCM_STATE_OPEN;
835
836	substream->runtime = runtime;
837	substream->private_data = pcm->private_data;
838	pstr->substream_opened++;
839	*rsubstream = substream;
840	return 0;
841}
842
843void snd_pcm_release_substream(struct snd_pcm_substream *substream)
844{
845	struct snd_pcm_runtime *runtime;
846	substream->file = NULL;
847	runtime = substream->runtime;
848	snd_assert(runtime != NULL, return);
849	if (runtime->private_free != NULL)
850		runtime->private_free(runtime);
851	snd_free_pages((void*)runtime->status,
852		       PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
853	snd_free_pages((void*)runtime->control,
854		       PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control)));
855	kfree(runtime->hw_constraints.rules);
856	kfree(runtime);
857	substream->runtime = NULL;
858	substream->pstr->substream_opened--;
859}
860
861static int snd_pcm_dev_register(struct snd_device *device)
862{
863	int idx, cidx, err;
864	unsigned short minor;
865	struct snd_pcm_substream *substream;
866	struct list_head *list;
867	char str[16];
868	struct snd_pcm *pcm = device->device_data;
869
870	snd_assert(pcm != NULL && device != NULL, return -ENXIO);
871	down(&register_mutex);
872	idx = (pcm->card->number * SNDRV_PCM_DEVICES) + pcm->device;
873	if (snd_pcm_devices[idx]) {
874		up(&register_mutex);
875		return -EBUSY;
876	}
877	snd_pcm_devices[idx] = pcm;
878	for (cidx = 0; cidx < 2; cidx++) {
879		int devtype = -1;
880		if (pcm->streams[cidx].substream == NULL)
881			continue;
882		switch (cidx) {
883		case SNDRV_PCM_STREAM_PLAYBACK:
884			sprintf(str, "pcmC%iD%ip", pcm->card->number, pcm->device);
885			minor = SNDRV_MINOR_PCM_PLAYBACK + idx;
886			devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
887			break;
888		case SNDRV_PCM_STREAM_CAPTURE:
889			sprintf(str, "pcmC%iD%ic", pcm->card->number, pcm->device);
890			minor = SNDRV_MINOR_PCM_CAPTURE + idx;
891			devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
892			break;
893		}
894		if ((err = snd_register_device(devtype, pcm->card, pcm->device, pcm->streams[cidx].reg, str)) < 0) {
895			snd_pcm_devices[idx] = NULL;
896			up(&register_mutex);
897			return err;
898		}
899		for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
900			snd_pcm_timer_init(substream);
901	}
902	list_for_each(list, &snd_pcm_notify_list) {
903		struct snd_pcm_notify *notify;
904		notify = list_entry(list, struct snd_pcm_notify, list);
905		notify->n_register(pcm);
906	}
907	up(&register_mutex);
908	return 0;
909}
910
911static int snd_pcm_dev_disconnect(struct snd_device *device)
912{
913	struct snd_pcm *pcm = device->device_data;
914	struct list_head *list;
915	struct snd_pcm_substream *substream;
916	int idx, cidx;
917
918	down(&register_mutex);
919	idx = (pcm->card->number * SNDRV_PCM_DEVICES) + pcm->device;
920	snd_pcm_devices[idx] = NULL;
921	for (cidx = 0; cidx < 2; cidx++)
922		for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
923			if (substream->runtime)
924				substream->runtime->status->state = SNDRV_PCM_STATE_DISCONNECTED;
925	list_for_each(list, &snd_pcm_notify_list) {
926		struct snd_pcm_notify *notify;
927		notify = list_entry(list, struct snd_pcm_notify, list);
928		notify->n_disconnect(pcm);
929	}
930	up(&register_mutex);
931	return 0;
932}
933
934static int snd_pcm_dev_unregister(struct snd_device *device)
935{
936	int idx, cidx, devtype;
937	struct snd_pcm_substream *substream;
938	struct list_head *list;
939	struct snd_pcm *pcm = device->device_data;
940
941	snd_assert(pcm != NULL, return -ENXIO);
942	down(&register_mutex);
943	idx = (pcm->card->number * SNDRV_PCM_DEVICES) + pcm->device;
944	snd_pcm_devices[idx] = NULL;
945	for (cidx = 0; cidx < 2; cidx++) {
946		devtype = -1;
947		switch (cidx) {
948		case SNDRV_PCM_STREAM_PLAYBACK:
949			devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
950			break;
951		case SNDRV_PCM_STREAM_CAPTURE:
952			devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
953			break;
954		}
955		snd_unregister_device(devtype, pcm->card, pcm->device);
956		for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
957			snd_pcm_timer_done(substream);
958	}
959	list_for_each(list, &snd_pcm_notify_list) {
960		struct snd_pcm_notify *notify;
961		notify = list_entry(list, struct snd_pcm_notify, list);
962		notify->n_unregister(pcm);
963	}
964	up(&register_mutex);
965	return snd_pcm_free(pcm);
966}
967
968int snd_pcm_notify(struct snd_pcm_notify *notify, int nfree)
969{
970	int idx;
971
972	snd_assert(notify != NULL && notify->n_register != NULL && notify->n_unregister != NULL, return -EINVAL);
973	down(&register_mutex);
974	if (nfree) {
975		list_del(&notify->list);
976		for (idx = 0; idx < SNDRV_CARDS * SNDRV_PCM_DEVICES; idx++) {
977			if (snd_pcm_devices[idx] == NULL)
978				continue;
979			notify->n_unregister(snd_pcm_devices[idx]);
980		}
981	} else {
982		list_add_tail(&notify->list, &snd_pcm_notify_list);
983		for (idx = 0; idx < SNDRV_CARDS * SNDRV_PCM_DEVICES; idx++) {
984			if (snd_pcm_devices[idx] == NULL)
985				continue;
986			notify->n_register(snd_pcm_devices[idx]);
987		}
988	}
989	up(&register_mutex);
990	return 0;
991}
992
993/*
994 *  Info interface
995 */
996
997static void snd_pcm_proc_read(struct snd_info_entry *entry,
998			      struct snd_info_buffer *buffer)
999{
1000	int idx;
1001	struct snd_pcm *pcm;
1002
1003	down(&register_mutex);
1004	for (idx = 0; idx < SNDRV_CARDS * SNDRV_PCM_DEVICES; idx++) {
1005		pcm = snd_pcm_devices[idx];
1006		if (pcm == NULL)
1007			continue;
1008		snd_iprintf(buffer, "%02i-%02i: %s : %s", idx / SNDRV_PCM_DEVICES,
1009			    idx % SNDRV_PCM_DEVICES, pcm->id, pcm->name);
1010		if (pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream)
1011			snd_iprintf(buffer, " : playback %i",
1012				    pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream_count);
1013		if (pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream)
1014			snd_iprintf(buffer, " : capture %i",
1015				    pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream_count);
1016		snd_iprintf(buffer, "\n");
1017	}
1018	up(&register_mutex);
1019}
1020
1021/*
1022 *  ENTRY functions
1023 */
1024
1025static struct snd_info_entry *snd_pcm_proc_entry = NULL;
1026
1027static int __init alsa_pcm_init(void)
1028{
1029	struct snd_info_entry *entry;
1030
1031	snd_ctl_register_ioctl(snd_pcm_control_ioctl);
1032	snd_ctl_register_ioctl_compat(snd_pcm_control_ioctl);
1033	if ((entry = snd_info_create_module_entry(THIS_MODULE, "pcm", NULL)) != NULL) {
1034		snd_info_set_text_ops(entry, NULL, SNDRV_CARDS * SNDRV_PCM_DEVICES * 128,
1035				      snd_pcm_proc_read);
1036		if (snd_info_register(entry) < 0) {
1037			snd_info_free_entry(entry);
1038			entry = NULL;
1039		}
1040	}
1041	snd_pcm_proc_entry = entry;
1042	return 0;
1043}
1044
1045static void __exit alsa_pcm_exit(void)
1046{
1047	snd_ctl_unregister_ioctl(snd_pcm_control_ioctl);
1048	snd_ctl_unregister_ioctl_compat(snd_pcm_control_ioctl);
1049	if (snd_pcm_proc_entry) {
1050		snd_info_unregister(snd_pcm_proc_entry);
1051		snd_pcm_proc_entry = NULL;
1052	}
1053}
1054
1055module_init(alsa_pcm_init)
1056module_exit(alsa_pcm_exit)
1057
1058EXPORT_SYMBOL(snd_pcm_devices);
1059EXPORT_SYMBOL(snd_pcm_new);
1060EXPORT_SYMBOL(snd_pcm_new_stream);
1061EXPORT_SYMBOL(snd_pcm_notify);
1062EXPORT_SYMBOL(snd_pcm_open_substream);
1063EXPORT_SYMBOL(snd_pcm_release_substream);
1064EXPORT_SYMBOL(snd_pcm_format_name);
1065  /* pcm_native.c */
1066EXPORT_SYMBOL(snd_pcm_link_rwlock);
1067#ifdef CONFIG_PM
1068EXPORT_SYMBOL(snd_pcm_suspend);
1069EXPORT_SYMBOL(snd_pcm_suspend_all);
1070#endif
1071EXPORT_SYMBOL(snd_pcm_kernel_playback_ioctl);
1072EXPORT_SYMBOL(snd_pcm_kernel_capture_ioctl);
1073EXPORT_SYMBOL(snd_pcm_kernel_ioctl);
1074EXPORT_SYMBOL(snd_pcm_mmap_data);
1075#if SNDRV_PCM_INFO_MMAP_IOMEM
1076EXPORT_SYMBOL(snd_pcm_lib_mmap_iomem);
1077#endif
1078 /* pcm_misc.c */
1079EXPORT_SYMBOL(snd_pcm_format_signed);
1080EXPORT_SYMBOL(snd_pcm_format_unsigned);
1081EXPORT_SYMBOL(snd_pcm_format_linear);
1082EXPORT_SYMBOL(snd_pcm_format_little_endian);
1083EXPORT_SYMBOL(snd_pcm_format_big_endian);
1084EXPORT_SYMBOL(snd_pcm_format_width);
1085EXPORT_SYMBOL(snd_pcm_format_physical_width);
1086EXPORT_SYMBOL(snd_pcm_format_size);
1087EXPORT_SYMBOL(snd_pcm_format_silence_64);
1088EXPORT_SYMBOL(snd_pcm_format_set_silence);
1089EXPORT_SYMBOL(snd_pcm_build_linear_format);
1090EXPORT_SYMBOL(snd_pcm_limit_hw_rates);
1091