[linux.git] / sound / core / sound_oss.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 *  Advanced Linux Sound Architecture
 *  Copyright (c) by Jaroslav Kysela <[email protected]>
 */

#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;
	mutex_lock(&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;
	mutex_unlock(&sound_oss_mutex);
	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;
	mutex_lock(&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;
	}
	mutex_unlock(&sound_oss_mutex);
	return 0;

      __end:
      	if (register2 >= 0)
      		unregister_sound_special(register2);
      	if (register1 >= 0)
      		unregister_sound_special(register1);
	snd_oss_minors[minor] = NULL;
	mutex_unlock(&sound_oss_mutex);
	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;
	mutex_lock(&sound_oss_mutex);
	mptr = snd_oss_minors[minor];
	if (mptr == NULL) {
		mutex_unlock(&sound_oss_mutex);
		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;
	mutex_unlock(&sound_oss_mutex);

	/* 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;

	mutex_lock(&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));
	}
	mutex_unlock(&sound_oss_mutex);
}


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 <[email protected]>
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;
1a60d4c5	32	mutex_lock(&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;
1a60d4c5	40	mutex_unlock(&sound_oss_mutex);
f87135f5 CL	41	return private_data;
f87135f5 CL	42	}
c0d3fb39 TI	43	EXPORT_SYMBOL(snd_lookup_oss_minor_data);
c0d3fb39 TI	44
174c1f65	45	static int snd_oss_kernel_minor(int type, struct snd_card *card, int dev)
1da177e4 LT	46	{
	47	int minor;
	48
	49	switch (type) {
	50	case SNDRV_OSS_DEVICE_TYPE_MIXER:
7eaa943c TI	51	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	52	return -EINVAL;
1da177e4 LT	53	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIXER1 : SNDRV_MINOR_OSS_MIXER));
	54	break;
	55	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
	56	minor = SNDRV_MINOR_OSS_SEQUENCER;
	57	break;
	58	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
	59	minor = SNDRV_MINOR_OSS_MUSIC;
	60	break;
	61	case SNDRV_OSS_DEVICE_TYPE_PCM:
7eaa943c TI	62	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	63	return -EINVAL;
1da177e4 LT	64	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_PCM1 : SNDRV_MINOR_OSS_PCM));
	65	break;
	66	case SNDRV_OSS_DEVICE_TYPE_MIDI:
7eaa943c TI	67	if (snd_BUG_ON(!card \|\| dev < 0 \|\| dev > 1))
7eaa943c TI	68	return -EINVAL;
1da177e4 LT	69	minor = SNDRV_MINOR_OSS(card->number, (dev ? SNDRV_MINOR_OSS_MIDI1 : SNDRV_MINOR_OSS_MIDI));
	70	break;
	71	case SNDRV_OSS_DEVICE_TYPE_DMFM:
	72	minor = SNDRV_MINOR_OSS(card->number, SNDRV_MINOR_OSS_DMFM);
	73	break;
	74	case SNDRV_OSS_DEVICE_TYPE_SNDSTAT:
	75	minor = SNDRV_MINOR_OSS_SNDSTAT;
	76	break;
	77	default:
	78	return -EINVAL;
	79	}
808c569f	80	if (minor < 0 \|\| minor >= SNDRV_OSS_MINORS)
7eaa943c	81	return -EINVAL;
1da177e4 LT	82	return minor;
	83	}
	84
174c1f65	85	int snd_register_oss_device(int type, struct snd_card *card, int dev,
80d7d771	86	const struct file_operations f_ops, void private_data)
1da177e4 LT	87	{
	88	int minor = snd_oss_kernel_minor(type, card, dev);
	89	int minor_unit;
174c1f65	90	struct snd_minor *preg;
1da177e4 LT	91	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	92	int track2 = -1;
	93	int register1 = -1, register2 = -1;
7d2aae1e	94	struct device *carddev = snd_card_get_device_link(card);
1da177e4	95
779ae5a0	96	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
d001544d	97	return 0; /* ignore silently */
1da177e4 LT	98	if (minor < 0)
1da177e4 LT	99	return minor;
6983b724	100	preg = kmalloc(sizeof(struct snd_minor), GFP_KERNEL);
1da177e4 LT	101	if (preg == NULL)
1da177e4 LT	102	return -ENOMEM;
2af677fc	103	preg->type = type;
6983b724	104	preg->card = card ? card->number : -1;
1da177e4	105	preg->device = dev;
2af677fc	106	preg->f_ops = f_ops;
f87135f5	107	preg->private_data = private_data;
a0830dbd	108	preg->card_ptr = card;
1a60d4c5	109	mutex_lock(&sound_oss_mutex);
6983b724	110	snd_oss_minors[minor] = preg;
1da177e4 LT	111	minor_unit = SNDRV_MINOR_OSS_DEVICE(minor);
	112	switch (minor_unit) {
	113	case SNDRV_MINOR_OSS_PCM:
	114	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
	115	break;
	116	case SNDRV_MINOR_OSS_MIDI:
	117	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
	118	break;
	119	case SNDRV_MINOR_OSS_MIDI1:
	120	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
	121	break;
	122	}
2af677fc	123	register1 = register_sound_special_device(f_ops, minor, carddev);
1da177e4 LT	124	if (register1 != minor)
	125	goto __end;
	126	if (track2 >= 0) {
2af677fc CL	127	register2 = register_sound_special_device(f_ops, track2,
2af677fc CL	128	carddev);
1da177e4 LT	129	if (register2 != track2)
1da177e4 LT	130	goto __end;
f87135f5	131	snd_oss_minors[track2] = preg;
1da177e4	132	}
1a60d4c5	133	mutex_unlock(&sound_oss_mutex);
1da177e4 LT	134	return 0;
	135
	136	__end:
	137	if (register2 >= 0)
	138	unregister_sound_special(register2);
	139	if (register1 >= 0)
	140	unregister_sound_special(register1);
6983b724	141	snd_oss_minors[minor] = NULL;
1a60d4c5	142	mutex_unlock(&sound_oss_mutex);
1da177e4 LT	143	kfree(preg);
	144	return -EBUSY;
	145	}
c0d3fb39 TI	146	EXPORT_SYMBOL(snd_register_oss_device);
c0d3fb39 TI	147
174c1f65	148	int snd_unregister_oss_device(int type, struct snd_card *card, int dev)
1da177e4 LT	149	{
	150	int minor = snd_oss_kernel_minor(type, card, dev);
	151	int cidx = SNDRV_MINOR_OSS_CARD(minor);
	152	int track2 = -1;
174c1f65	153	struct snd_minor *mptr;
1da177e4	154
779ae5a0	155	if (card && card->number >= SNDRV_MINOR_OSS_DEVICES)
d001544d	156	return 0;
1da177e4 LT	157	if (minor < 0)
1da177e4 LT	158	return minor;
1a60d4c5	159	mutex_lock(&sound_oss_mutex);
6983b724	160	mptr = snd_oss_minors[minor];
1da177e4	161	if (mptr == NULL) {
1a60d4c5	162	mutex_unlock(&sound_oss_mutex);
1da177e4 LT	163	return -ENOENT;
1da177e4 LT	164	}
1da177e4 LT	165	switch (SNDRV_MINOR_OSS_DEVICE(minor)) {
	166	case SNDRV_MINOR_OSS_PCM:
	167	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_AUDIO);
	168	break;
	169	case SNDRV_MINOR_OSS_MIDI:
	170	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI);
	171	break;
	172	case SNDRV_MINOR_OSS_MIDI1:
	173	track2 = SNDRV_MINOR_OSS(cidx, SNDRV_MINOR_OSS_DMMIDI1);
	174	break;
	175	}
97d91787	176	if (track2 >= 0)
f87135f5	177	snd_oss_minors[track2] = NULL;
6983b724	178	snd_oss_minors[minor] = NULL;
1a60d4c5	179	mutex_unlock(&sound_oss_mutex);
97d91787 TI	180
	181	/* call unregister_sound_special() outside sound_oss_mutex;
	182	* otherwise may deadlock, as it can trigger the release of a card
	183	*/
	184	unregister_sound_special(minor);
	185	if (track2 >= 0)
	186	unregister_sound_special(track2);
	187
1da177e4 LT	188	kfree(mptr);
	189	return 0;
	190	}
c0d3fb39 TI	191	EXPORT_SYMBOL(snd_unregister_oss_device);
c0d3fb39 TI	192
1da177e4 LT	193	/*
	194	* INFO PART
	195	*/
	196
cd6a6503	197	#ifdef CONFIG_SND_PROC_FS
2af677fc CL	198	static const char *snd_oss_device_type_name(int type)
	199	{
	200	switch (type) {
	201	case SNDRV_OSS_DEVICE_TYPE_MIXER:
	202	return "mixer";
	203	case SNDRV_OSS_DEVICE_TYPE_SEQUENCER:
	204	case SNDRV_OSS_DEVICE_TYPE_MUSIC:
	205	return "sequencer";
	206	case SNDRV_OSS_DEVICE_TYPE_PCM:
	207	return "digital audio";
	208	case SNDRV_OSS_DEVICE_TYPE_MIDI:
	209	return "raw midi";
	210	case SNDRV_OSS_DEVICE_TYPE_DMFM:
	211	return "hardware dependent";
	212	default:
	213	return "?";
	214	}
	215	}
	216
174c1f65 TI	217	static void snd_minor_info_oss_read(struct snd_info_entry *entry,
174c1f65 TI	218	struct snd_info_buffer *buffer)
1da177e4	219	{
6983b724	220	int minor;
174c1f65	221	struct snd_minor *mptr;
1da177e4	222
1a60d4c5	223	mutex_lock(&sound_oss_mutex);
6983b724	224	for (minor = 0; minor < SNDRV_OSS_MINORS; ++minor) {
e3ded899 TI	225	mptr = snd_oss_minors[minor];
e3ded899 TI	226	if (!mptr)
6983b724 CL	227	continue;
	228	if (mptr->card >= 0)
	229	snd_iprintf(buffer, "%3i: [%i-%2i]: %s\n", minor,
	230	mptr->card, mptr->device,
	231	snd_oss_device_type_name(mptr->type));
	232	else
	233	snd_iprintf(buffer, "%3i: : %s\n", minor,
	234	snd_oss_device_type_name(mptr->type));
1da177e4	235	}
1a60d4c5	236	mutex_unlock(&sound_oss_mutex);
1da177e4 LT	237	}
1da177e4 LT	238
1da177e4 LT	239
	240	int __init snd_minor_info_oss_init(void)
	241	{
174c1f65	242	struct snd_info_entry *entry;
1da177e4 LT	243
1da177e4 LT	244	entry = snd_info_create_module_entry(THIS_MODULE, "devices", snd_oss_root);
b591b6e9 TI	245	if (!entry)
	246	return -ENOMEM;
	247	entry->c.text.read = snd_minor_info_oss_read;
	248	return snd_info_register(entry); /* freed in error path */
1da177e4	249	}
cd6a6503	250	#endif /* CONFIG_SND_PROC_FS */