[linux-2.6-block.git] / sound / core / sound_oss.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 *  Advanced Linux Sound Architecture
 *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
 */

#include <linux/init.h>
#include <linux/export.h>
#include <linux/slab.h>
#include <linux/time.h>
#include <sound/core.h>
#include <sound/minors.h>
#include <sound/info.h>
#include <linux/sound.h>
#include <linux/mutex.h>

#define SNDRV_OSS_MINORS 256

static struct snd_minor *snd_oss_minors[SNDRV_OSS_MINORS];
static DEFINE_MUTEX(sound_oss_mutex);

/* NOTE: This function increments the refcount of the associated card like
 * snd_lookup_minor_data(); the caller must call snd_card_unref() appropriately
 */
void *snd_lookup_oss_minor_data(unsigned int minor, int type)
{
	struct snd_minor *mreg;
	void *private_data;

	if (minor >= ARRAY_SIZE(snd_oss_minors))
		return NULL;
	guard(mutex)(&sound_oss_mutex);
	mreg = snd_oss_minors[minor];
	if (mreg && mreg->type == type) {
		private_data = mreg->private_data;
		if (private_data && mreg->card_ptr)
			get_device(&mreg->card_ptr->card_dev);
	} else
		private_data = NULL;
	return private_data;
}
EXPORT_SYMBOL(snd_lookup_oss_minor_data);

static int snd_oss_kernel_minor(int type, struct snd_card *card, int dev)
{
	int minor;

	switch (type) {
	case SNDRV_OSS_DEVICE_TYPE_MIXER:
		if (snd_BUG_ON(!card || dev < 0 || dev > 1))
			return -EINVAL;
		minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIXER1 : SNDRV_MINOR_OSS_MIXER));
		break;
	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
		minor = SNDRV_MINOR_OSS_SEQUENCER;
		break;
	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
		minor = SNDRV_MINOR_OSS_MUSIC;
		break;
	case SNDRV_OSS_DEVICE_TYPE_PCM:
		if (snd_BUG_ON(!card || dev < 0 || dev > 1))
			return -EINVAL;
		minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_PCM1 : SNDRV_MINOR_OSS_PCM));
		break;
	case SNDRV_OSS_DEVICE_TYPE_MIDI:
		if (snd_BUG_ON(!card || dev < 0 || dev > 1))
			return -EINVAL;
		minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIDI1 : SNDRV_MINOR_OSS_MIDI));
		break;
	case SNDRV_OSS_DEVICE_TYPE_DMFM:
		minor = SNDRV_MINOR_OSS(card->number, SNDRV_MINOR_OSS_DMFM);
		break;
	case SNDRV_OSS_DEVICE_TYPE_SNDSTAT:
		minor = SNDRV_MINOR_OSS_SNDSTAT;
		break;
	default:
		return -EINVAL;
	}
	if (minor < 0 || minor >= SNDRV_OSS_MINORS)
		return -EINVAL;
	return minor;
}

int snd_register_oss_device(int type, struct snd_card *card, int dev,
			    const struct file_operations *f_ops, void *private_data)
{
	int minor = snd_oss_kernel_minor(type, card, dev);
	int minor_unit;
	struct snd_minor *preg;
	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	int track2 = -1;
	int register1 = -1, register2 = -1;
	struct device *carddev = snd_card_get_device_link(card);

	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
		return 0; /* ignore silently */
	if (minor < 0)
		return minor;
	preg = kmalloc(sizeof(struct snd_minor), GFP_KERNEL);
	if (preg == NULL)
		return -ENOMEM;
	preg->type = type;
	preg->card = card ? card->number : -1;
	preg->device = dev;
	preg->f_ops = f_ops;
	preg->private_data = private_data;
	preg->card_ptr = card;
	guard(mutex)(&sound_oss_mutex);
	snd_oss_minors[minor] = preg;
	minor_unit = SNDRV_MINOR_OSS_DEVICE(minor);
	switch (minor_unit) {
	case SNDRV_MINOR_OSS_PCM:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
		break;
	case SNDRV_MINOR_OSS_MIDI:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
		break;
	case SNDRV_MINOR_OSS_MIDI1:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
		break;
	}
	register1 = register_sound_special_device(f_ops, minor, carddev);
	if (register1 != minor)
		goto __end;
	if (track2 >= 0) {
		register2 = register_sound_special_device(f_ops, track2,
							  carddev);
		if (register2 != track2)
			goto __end;
		snd_oss_minors[track2] = preg;
	}
	return 0;

      __end:
      	if (register2 >= 0)
      		unregister_sound_special(register2);
      	if (register1 >= 0)
      		unregister_sound_special(register1);
	snd_oss_minors[minor] = NULL;
	kfree(preg);
      	return -EBUSY;
}
EXPORT_SYMBOL(snd_register_oss_device);

int snd_unregister_oss_device(int type, struct snd_card *card, int dev)
{
	int minor = snd_oss_kernel_minor(type, card, dev);
	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	int track2 = -1;
	struct snd_minor *mptr;

	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
		return 0;
	if (minor < 0)
		return minor;
	guard(mutex)(&sound_oss_mutex);
	mptr = snd_oss_minors[minor];
	if (mptr == NULL)
		return -ENOENT;
	switch (SNDRV_MINOR_OSS_DEVICE(minor)) {
	case SNDRV_MINOR_OSS_PCM:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
		break;
	case SNDRV_MINOR_OSS_MIDI:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
		break;
	case SNDRV_MINOR_OSS_MIDI1:
		track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
		break;
	}
	if (track2 >= 0)
		snd_oss_minors[track2] = NULL;
	snd_oss_minors[minor] = NULL;

	/* call unregister_sound_special() outside sound_oss_mutex;
	 * otherwise may deadlock, as it can trigger the release of a card
	 */
	unregister_sound_special(minor);
	if (track2 >= 0)
		unregister_sound_special(track2);

	kfree(mptr);
	return 0;
}
EXPORT_SYMBOL(snd_unregister_oss_device);

/*
 *  INFO PART
 */

#ifdef CONFIG_SND_PROC_FS
static const char *snd_oss_device_type_name(int type)
{
	switch (type) {
	case SNDRV_OSS_DEVICE_TYPE_MIXER:
		return "mixer";
	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
		return "sequencer";
	case SNDRV_OSS_DEVICE_TYPE_PCM:
		return "digital audio";
	case SNDRV_OSS_DEVICE_TYPE_MIDI:
		return "raw midi";
	case SNDRV_OSS_DEVICE_TYPE_DMFM:
		return "hardware dependent";
	default:
		return "?";
	}
}

static void snd_minor_info_oss_read(struct snd_info_entry *entry,
				    struct snd_info_buffer *buffer)
{
	int minor;
	struct snd_minor *mptr;

	guard(mutex)(&sound_oss_mutex);
	for (minor = 0; minor < SNDRV_OSS_MINORS; ++minor) {
		mptr = snd_oss_minors[minor];
		if (!mptr)
			continue;
		if (mptr->card >= 0)
			snd_iprintf(buffer, "%3i: [%i-%2i]: %s\n", minor,
				    mptr->card, mptr->device,
				    snd_oss_device_type_name(mptr->type));
		else
			snd_iprintf(buffer, "%3i:       : %s\n", minor,
				    snd_oss_device_type_name(mptr->type));
	}
}


int __init snd_minor_info_oss_init(void)
{
	struct snd_info_entry *entry;

	entry = snd_info_create_module_entry(THIS_MODULE, "devices", snd_oss_root);
	if (!entry)
		return -ENOMEM;
	entry->c.text.read = snd_minor_info_oss_read;
	return snd_info_register(entry); /* freed in error path */
}
#endif /* CONFIG_SND_PROC_FS */
Commit	Line	Data
1a59d1b8	1	// SPDX-License-Identifier: GPL-2.0-or-later
1da177e4 LT	2	/*
1da177e4 LT	3	* Advanced Linux Sound Architecture
c1017a4c	4	* Copyright (c) by Jaroslav Kysela <perex@perex.cz>
1da177e4 LT	5	*/
1da177e4 LT	6
1da177e4	7	#include <linux/init.h>
d81a6d71	8	#include <linux/export.h>
1da177e4 LT	9	#include <linux/slab.h>
	10	#include <linux/time.h>
	11	#include <sound/core.h>
	12	#include <sound/minors.h>
	13	#include <sound/info.h>
	14	#include <linux/sound.h>
1a60d4c5	15	#include <linux/mutex.h>
1da177e4	16
779ae5a0	17	#define SNDRV_OSS_MINORS 256
1da177e4	18
6983b724	19	static struct snd_minor *snd_oss_minors[SNDRV_OSS_MINORS];
1a60d4c5	20	static DEFINE_MUTEX(sound_oss_mutex);
1da177e4	21
a0830dbd TI	22	/* NOTE: This function increments the refcount of the associated card like
	23	* snd_lookup_minor_data(); the caller must call snd_card_unref() appropriately
	24	*/
f87135f5 CL	25	void *snd_lookup_oss_minor_data(unsigned int minor, int type)
	26	{
	27	struct snd_minor *mreg;
	28	void *private_data;
	29
3a63e444	30	if (minor >= ARRAY_SIZE(snd_oss_minors))
f87135f5	31	return NULL;
742ecf3c	32	guard(mutex)(&sound_oss_mutex);
f87135f5	33	mreg = snd_oss_minors[minor];
a0830dbd	34	if (mreg && mreg->type == type) {
f87135f5	35	private_data = mreg->private_data;
8bb4d9ce	36	if (private_data && mreg->card_ptr)
f2464064	37	get_device(&mreg->card_ptr->card_dev);
a0830dbd	38	} else
f87135f5	39	private_data = NULL;
f87135f5 CL	40	return private_data;
f87135f5 CL	41	}
c0d3fb39 TI	42	EXPORT_SYMBOL(snd_lookup_oss_minor_data);
c0d3fb39 TI	43
174c1f65	44	static int snd_oss_kernel_minor(int type, struct snd_card *card, int dev)
1da177e4 LT	45	{
	46	int minor;
	47
	48	switch (type) {
	49	case SNDRV_OSS_DEVICE_TYPE_MIXER:
7eaa943c TI	50	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	51	return -EINVAL;
1da177e4 LT	52	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIXER1 : SNDRV_MINOR_OSS_MIXER));
	53	break;
	54	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
	55	minor = SNDRV_MINOR_OSS_SEQUENCER;
	56	break;
	57	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
	58	minor = SNDRV_MINOR_OSS_MUSIC;
	59	break;
	60	case SNDRV_OSS_DEVICE_TYPE_PCM:
7eaa943c TI	61	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	62	return -EINVAL;
1da177e4 LT	63	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_PCM1 : SNDRV_MINOR_OSS_PCM));
	64	break;
	65	case SNDRV_OSS_DEVICE_TYPE_MIDI:
7eaa943c TI	66	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	67	return -EINVAL;
1da177e4 LT	68	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIDI1 : SNDRV_MINOR_OSS_MIDI));
	69	break;
	70	case SNDRV_OSS_DEVICE_TYPE_DMFM:
	71	minor = SNDRV_MINOR_OSS(card->number, SNDRV_MINOR_OSS_DMFM);
	72	break;
	73	case SNDRV_OSS_DEVICE_TYPE_SNDSTAT:
	74	minor = SNDRV_MINOR_OSS_SNDSTAT;
	75	break;
	76	default:
	77	return -EINVAL;
	78	}
808c569f	79	if (minor < 0 \|\| minor >= SNDRV_OSS_MINORS)
7eaa943c	80	return -EINVAL;
1da177e4 LT	81	return minor;
	82	}
	83
174c1f65	84	int snd_register_oss_device(int type, struct snd_card *card, int dev,
80d7d771	85	const struct file_operations f_ops, void private_data)
1da177e4 LT	86	{
	87	int minor = snd_oss_kernel_minor(type, card, dev);
	88	int minor_unit;
174c1f65	89	struct snd_minor *preg;
1da177e4 LT	90	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	91	int track2 = -1;
	92	int register1 = -1, register2 = -1;
7d2aae1e	93	struct device *carddev = snd_card_get_device_link(card);
1da177e4	94
779ae5a0	95	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
d001544d	96	return 0; /* ignore silently */
1da177e4 LT	97	if (minor < 0)
1da177e4 LT	98	return minor;
6983b724	99	preg = kmalloc(sizeof(struct snd_minor), GFP_KERNEL);
1da177e4 LT	100	if (preg == NULL)
1da177e4 LT	101	return -ENOMEM;
2af677fc	102	preg->type = type;
6983b724	103	preg->card = card ? card->number : -1;
1da177e4	104	preg->device = dev;
2af677fc	105	preg->f_ops = f_ops;
f87135f5	106	preg->private_data = private_data;
a0830dbd	107	preg->card_ptr = card;
742ecf3c	108	guard(mutex)(&sound_oss_mutex);
6983b724	109	snd_oss_minors[minor] = preg;
1da177e4 LT	110	minor_unit = SNDRV_MINOR_OSS_DEVICE(minor);
	111	switch (minor_unit) {
	112	case SNDRV_MINOR_OSS_PCM:
	113	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
	114	break;
	115	case SNDRV_MINOR_OSS_MIDI:
	116	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
	117	break;
	118	case SNDRV_MINOR_OSS_MIDI1:
	119	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
	120	break;
	121	}
2af677fc	122	register1 = register_sound_special_device(f_ops, minor, carddev);
1da177e4 LT	123	if (register1 != minor)
	124	goto __end;
	125	if (track2 >= 0) {
2af677fc CL	126	register2 = register_sound_special_device(f_ops, track2,
2af677fc CL	127	carddev);
1da177e4 LT	128	if (register2 != track2)
1da177e4 LT	129	goto __end;
f87135f5	130	snd_oss_minors[track2] = preg;
1da177e4	131	}
1da177e4 LT	132	return 0;
	133
	134	__end:
	135	if (register2 >= 0)
	136	unregister_sound_special(register2);
	137	if (register1 >= 0)
	138	unregister_sound_special(register1);
6983b724	139	snd_oss_minors[minor] = NULL;
1da177e4 LT	140	kfree(preg);
	141	return -EBUSY;
	142	}
c0d3fb39 TI	143	EXPORT_SYMBOL(snd_register_oss_device);
c0d3fb39 TI	144
174c1f65	145	int snd_unregister_oss_device(int type, struct snd_card *card, int dev)
1da177e4 LT	146	{
	147	int minor = snd_oss_kernel_minor(type, card, dev);
	148	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	149	int track2 = -1;
174c1f65	150	struct snd_minor *mptr;
1da177e4	151
779ae5a0	152	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
d001544d	153	return 0;
1da177e4 LT	154	if (minor < 0)
1da177e4 LT	155	return minor;
742ecf3c	156	guard(mutex)(&sound_oss_mutex);
6983b724	157	mptr = snd_oss_minors[minor];
742ecf3c	158	if (mptr == NULL)
1da177e4	159	return -ENOENT;
1da177e4 LT	160	switch (SNDRV_MINOR_OSS_DEVICE(minor)) {
	161	case SNDRV_MINOR_OSS_PCM:
	162	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
	163	break;
	164	case SNDRV_MINOR_OSS_MIDI:
	165	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
	166	break;
	167	case SNDRV_MINOR_OSS_MIDI1:
	168	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
	169	break;
	170	}
97d91787	171	if (track2 >= 0)
f87135f5	172	snd_oss_minors[track2] = NULL;
6983b724	173	snd_oss_minors[minor] = NULL;
97d91787 TI	174
	175	/* call unregister_sound_special() outside sound_oss_mutex;
	176	* otherwise may deadlock, as it can trigger the release of a card
	177	*/
	178	unregister_sound_special(minor);
	179	if (track2 >= 0)
	180	unregister_sound_special(track2);
	181
1da177e4 LT	182	kfree(mptr);
	183	return 0;
	184	}
c0d3fb39 TI	185	EXPORT_SYMBOL(snd_unregister_oss_device);
c0d3fb39 TI	186
1da177e4 LT	187	/*
	188	* INFO PART
	189	*/
	190
cd6a6503	191	#ifdef CONFIG_SND_PROC_FS
2af677fc CL	192	static const char *snd_oss_device_type_name(int type)
	193	{
	194	switch (type) {
	195	case SNDRV_OSS_DEVICE_TYPE_MIXER:
	196	return "mixer";
	197	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
	198	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
	199	return "sequencer";
	200	case SNDRV_OSS_DEVICE_TYPE_PCM:
	201	return "digital audio";
	202	case SNDRV_OSS_DEVICE_TYPE_MIDI:
	203	return "raw midi";
	204	case SNDRV_OSS_DEVICE_TYPE_DMFM:
	205	return "hardware dependent";
	206	default:
	207	return "?";
	208	}
	209	}
	210
174c1f65 TI	211	static void snd_minor_info_oss_read(struct snd_info_entry *entry,
174c1f65 TI	212	struct snd_info_buffer *buffer)
1da177e4	213	{
6983b724	214	int minor;
174c1f65	215	struct snd_minor *mptr;
1da177e4	216
742ecf3c	217	guard(mutex)(&sound_oss_mutex);
6983b724	218	for (minor = 0; minor < SNDRV_OSS_MINORS; ++minor) {
e3ded899 TI	219	mptr = snd_oss_minors[minor];
e3ded899 TI	220	if (!mptr)
6983b724 CL	221	continue;
	222	if (mptr->card >= 0)
	223	snd_iprintf(buffer, "%3i: [%i-%2i]: %s\n", minor,
	224	mptr->card, mptr->device,
	225	snd_oss_device_type_name(mptr->type));
	226	else
	227	snd_iprintf(buffer, "%3i: : %s\n", minor,
	228	snd_oss_device_type_name(mptr->type));
1da177e4	229	}
1da177e4 LT	230	}
1da177e4 LT	231
1da177e4 LT	232
	233	int __init snd_minor_info_oss_init(void)
	234	{
174c1f65	235	struct snd_info_entry *entry;
1da177e4 LT	236
1da177e4 LT	237	entry = snd_info_create_module_entry(THIS_MODULE, "devices", snd_oss_root);
b591b6e9 TI	238	if (!entry)
	239	return -ENOMEM;
	240	entry->c.text.read = snd_minor_info_oss_read;
	241	return snd_info_register(entry); /* freed in error path */
1da177e4	242	}
cd6a6503	243	#endif /* CONFIG_SND_PROC_FS */