[linux.git] / sound / sound_core.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 *	Sound core.  This file is composed of two parts.  sound_class
 *	which is common to both OSS and ALSA and OSS sound core which
 *	is used OSS or emulation of it.
 */

/*
 * First, the common part.
 */
#include <linux/module.h>
#include <linux/device.h>
#include <linux/err.h>
#include <linux/kdev_t.h>
#include <linux/major.h>
#include <sound/core.h>

#ifdef CONFIG_SOUND_OSS_CORE
static int __init init_oss_soundcore(void);
static void cleanup_oss_soundcore(void);
#else
static inline int init_oss_soundcore(void)	{ return 0; }
static inline void cleanup_oss_soundcore(void)	{ }
#endif

struct class *sound_class;
EXPORT_SYMBOL(sound_class);

MODULE_DESCRIPTION("Core sound module");
MODULE_AUTHOR("Alan Cox");
MODULE_LICENSE("GPL");

static char *sound_devnode(struct device *dev, umode_t *mode)
{
	if (MAJOR(dev->devt) == SOUND_MAJOR)
		return NULL;
	return kasprintf(GFP_KERNEL, "snd/%s", dev_name(dev));
}

static int __init init_soundcore(void)
{
	int rc;

	rc = init_oss_soundcore();
	if (rc)
		return rc;

	sound_class = class_create(THIS_MODULE, "sound");
	if (IS_ERR(sound_class)) {
		cleanup_oss_soundcore();
		return PTR_ERR(sound_class);
	}

	sound_class->devnode = sound_devnode;

	return 0;
}

static void __exit cleanup_soundcore(void)
{
	cleanup_oss_soundcore();
	class_destroy(sound_class);
}

subsys_initcall(init_soundcore);
module_exit(cleanup_soundcore);


#ifdef CONFIG_SOUND_OSS_CORE
/*
 *	OSS sound core handling. Breaks out sound functions to submodules
 *	
 *	Author:		Alan Cox <[email protected]>
 *
 *	Fixes:
 *
 *                         --------------------
 * 
 *	Top level handler for the sound subsystem. Various devices can
 *	plug into this. The fact they don't all go via OSS doesn't mean 
 *	they don't have to implement the OSS API. There is a lot of logic
 *	to keeping much of the OSS weight out of the code in a compatibility
 *	module, but it's up to the driver to rember to load it...
 *
 *	The code provides a set of functions for registration of devices
 *	by type. This is done rather than providing a single call so that
 *	we can hide any future changes in the internals (eg when we go to
 *	32bit dev_t) from the modules and their interface.
 *
 *	Secondly we need to allocate the dsp, dsp16 and audio devices as
 *	one. Thus we misuse the chains a bit to simplify this.
 *
 *	Thirdly to make it more fun and for 2.3.x and above we do all
 *	of this using fine grained locking.
 *
 *	FIXME: we have to resolve modules and fine grained load/unload
 *	locking at some point in 2.3.x.
 */

#include <linux/init.h>
#include <linux/slab.h>
#include <linux/types.h>
#include <linux/kernel.h>
#include <linux/sound.h>
#include <linux/kmod.h>

#define SOUND_STEP 16

struct sound_unit
{
	int unit_minor;
	const struct file_operations *unit_fops;
	struct sound_unit *next;
	char name[32];
};

/*
 * By default, OSS sound_core claims full legacy minor range (0-255)
 * of SOUND_MAJOR to trap open attempts to any sound minor and
 * requests modules using custom sound-slot/service-* module aliases.
 * The only benefit of doing this is allowing use of custom module
 * aliases instead of the standard char-major-* ones.  This behavior
 * prevents alternative OSS implementation and is scheduled to be
 * removed.
 *
 * CONFIG_SOUND_OSS_CORE_PRECLAIM and soundcore.preclaim_oss kernel
 * parameter are added to allow distros and developers to try and
 * switch to alternative implementations without needing to rebuild
 * the kernel in the meantime.  If preclaim_oss is non-zero, the
 * kernel will behave the same as before.  All SOUND_MAJOR minors are
 * preclaimed and the custom module aliases along with standard chrdev
 * ones are emitted if a missing device is opened.  If preclaim_oss is
 * zero, sound_core only grabs what's actually in use and for missing
 * devices only the standard chrdev aliases are requested.
 *
 * All these clutters are scheduled to be removed along with
 * sound-slot/service-* module aliases.
 */
#ifdef CONFIG_SOUND_OSS_CORE_PRECLAIM
static int preclaim_oss = 1;
#else
static int preclaim_oss = 0;
#endif

module_param(preclaim_oss, int, 0444);

static int soundcore_open(struct inode *, struct file *);

static const struct file_operations soundcore_fops =
{
	/* We must have an owner or the module locking fails */
	.owner	= THIS_MODULE,
	.open	= soundcore_open,
	.llseek = noop_llseek,
};

/*
 *	Low level list operator. Scan the ordered list, find a hole and
 *	join into it. Called with the lock asserted
 */

static int __sound_insert_unit(struct sound_unit * s, struct sound_unit **list, const struct file_operations *fops, int index, int low, int top)
{
	int n=low;

	if (index < 0) {	/* first free */

		while (*list && (*list)->unit_minor<n)
			list=&((*list)->next);

		while(n<top)
		{
			/* Found a hole ? */
			if(*list==NULL || (*list)->unit_minor>n)
				break;
			list=&((*list)->next);
			n+=SOUND_STEP;
		}

		if(n>=top)
			return -ENOENT;
	} else {
		n = low+(index*16);
		while (*list) {
			if ((*list)->unit_minor==n)
				return -EBUSY;
			if ((*list)->unit_minor>n)
				break;
			list=&((*list)->next);
		}
	}	
		
	/*
	 *	Fill it in
	 */
	 
	s->unit_minor=n;
	s->unit_fops=fops;
	
	/*
	 *	Link it
	 */
	 
	s->next=*list;
	*list=s;
	
	
	return n;
}

/*
 *	Remove a node from the chain. Called with the lock asserted
 */
 
static struct sound_unit *__sound_remove_unit(struct sound_unit **list, int unit)
{
	while(*list)
	{
		struct sound_unit *p=*list;
		if(p->unit_minor==unit)
		{
			*list=p->next;
			return p;
		}
		list=&(p->next);
	}
	printk(KERN_ERR "Sound device %d went missing!\n", unit);
	return NULL;
}

/*
 *	This lock guards the sound loader list.
 */

static DEFINE_SPINLOCK(sound_loader_lock);

/*
 *	Allocate the controlling structure and add it to the sound driver
 *	list. Acquires locks as needed
 */

static int sound_insert_unit(struct sound_unit **list, const struct file_operations *fops, int index, int low, int top, const char *name, umode_t mode, struct device *dev)
{
	struct sound_unit *s = kmalloc(sizeof(*s), GFP_KERNEL);
	int r;

	if (!s)
		return -ENOMEM;

	spin_lock(&sound_loader_lock);
retry:
	r = __sound_insert_unit(s, list, fops, index, low, top);
	spin_unlock(&sound_loader_lock);
	
	if (r < 0)
		goto fail;
	else if (r < SOUND_STEP)
		sprintf(s->name, "sound/%s", name);
	else
		sprintf(s->name, "sound/%s%d", name, r / SOUND_STEP);

	if (!preclaim_oss) {
		/*
		 * Something else might have grabbed the minor.  If
		 * first free slot is requested, rescan with @low set
		 * to the next unit; otherwise, -EBUSY.
		 */
		r = __register_chrdev(SOUND_MAJOR, s->unit_minor, 1, s->name,
				      &soundcore_fops);
		if (r < 0) {
			spin_lock(&sound_loader_lock);
			__sound_remove_unit(list, s->unit_minor);
			if (index < 0) {
				low = s->unit_minor + SOUND_STEP;
				goto retry;
			}
			spin_unlock(&sound_loader_lock);
			r = -EBUSY;
			goto fail;
		}
	}

	device_create(sound_class, dev, MKDEV(SOUND_MAJOR, s->unit_minor),
		      NULL, "%s", s->name+6);
	return s->unit_minor;

fail:
	kfree(s);
	return r;
}

/*
 *	Remove a unit. Acquires locks as needed. The drivers MUST have
 *	completed the removal before their file operations become
 *	invalid.
 */
 	
static void sound_remove_unit(struct sound_unit **list, int unit)
{
	struct sound_unit *p;

	spin_lock(&sound_loader_lock);
	p = __sound_remove_unit(list, unit);
	spin_unlock(&sound_loader_lock);
	if (p) {
		if (!preclaim_oss)
			__unregister_chrdev(SOUND_MAJOR, p->unit_minor, 1,
					    p->name);
		device_destroy(sound_class, MKDEV(SOUND_MAJOR, p->unit_minor));
		kfree(p);
	}
}

/*
 *	Allocations
 *
 *	0	*16		Mixers
 *	1	*8		Sequencers
 *	2	*16		Midi
 *	3	*16		DSP
 *	4	*16		SunDSP
 *	5	*16		DSP16
 *	6	--		sndstat (obsolete)
 *	7	*16		unused
 *	8	--		alternate sequencer (see above)
 *	9	*16		raw synthesizer access
 *	10	*16		unused
 *	11	*16		unused
 *	12	*16		unused
 *	13	*16		unused
 *	14	*16		unused
 *	15	*16		unused
 */

static struct sound_unit *chains[SOUND_STEP];

/**
 *	register_sound_special_device - register a special sound node
 *	@fops: File operations for the driver
 *	@unit: Unit number to allocate
 *      @dev: device pointer
 *
 *	Allocate a special sound device by minor number from the sound
 *	subsystem.
 *
 *	Return: The allocated number is returned on success. On failure,
 *	a negative error code is returned.
 */
 
int register_sound_special_device(const struct file_operations *fops, int unit,
				  struct device *dev)
{
	const int chain = unit % SOUND_STEP;
	int max_unit = 256;
	const char *name;
	char _name[16];

	switch (chain) {
	    case 0:
		name = "mixer";
		break;
	    case 1:
		name = "sequencer";
		if (unit >= SOUND_STEP)
			goto __unknown;
		max_unit = unit + 1;
		break;
	    case 2:
		name = "midi";
		break;
	    case 3:
		name = "dsp";
		break;
	    case 4:
		name = "audio";
		break;
	    case 5:
		name = "dspW";
		break;
	    case 8:
		name = "sequencer2";
		if (unit >= SOUND_STEP)
			goto __unknown;
		max_unit = unit + 1;
		break;
	    case 9:
		name = "dmmidi";
		break;
	    case 10:
		name = "dmfm";
		break;
	    case 12:
		name = "adsp";
		break;
	    case 13:
		name = "amidi";
		break;
	    case 14:
		name = "admmidi";
		break;
	    default:
	    	{
		    __unknown:
			sprintf(_name, "unknown%d", chain);
		    	if (unit >= SOUND_STEP)
		    		strcat(_name, "-");
		    	name = _name;
		}
		break;
	}
	return sound_insert_unit(&chains[chain], fops, -1, unit, max_unit,
				 name, 0600, dev);
}
 
EXPORT_SYMBOL(register_sound_special_device);

int register_sound_special(const struct file_operations *fops, int unit)
{
	return register_sound_special_device(fops, unit, NULL);
}

EXPORT_SYMBOL(register_sound_special);

/**
 *	register_sound_mixer - register a mixer device
 *	@fops: File operations for the driver
 *	@dev: Unit number to allocate
 *
 *	Allocate a mixer device. Unit is the number of the mixer requested.
 *	Pass -1 to request the next free mixer unit.
 *
 *	Return: On success, the allocated number is returned. On failure,
 *	a negative error code is returned.
 */

int register_sound_mixer(const struct file_operations *fops, int dev)
{
	return sound_insert_unit(&chains[0], fops, dev, 0, 128,
				 "mixer", 0600, NULL);
}

EXPORT_SYMBOL(register_sound_mixer);

/*
 *	DSP's are registered as a triple. Register only one and cheat
 *	in open - see below.
 */
 
/**
 *	register_sound_dsp - register a DSP device
 *	@fops: File operations for the driver
 *	@dev: Unit number to allocate
 *
 *	Allocate a DSP device. Unit is the number of the DSP requested.
 *	Pass -1 to request the next free DSP unit.
 *
 *	This function allocates both the audio and dsp device entries together
 *	and will always allocate them as a matching pair - eg dsp3/audio3
 *
 *	Return: On success, the allocated number is returned. On failure,
 *	a negative error code is returned.
 */

int register_sound_dsp(const struct file_operations *fops, int dev)
{
	return sound_insert_unit(&chains[3], fops, dev, 3, 131,
				 "dsp", 0600, NULL);
}

EXPORT_SYMBOL(register_sound_dsp);

/**
 *	unregister_sound_special - unregister a special sound device
 *	@unit: unit number to allocate
 *
 *	Release a sound device that was allocated with
 *	register_sound_special(). The unit passed is the return value from
 *	the register function.
 */


void unregister_sound_special(int unit)
{
	sound_remove_unit(&chains[unit % SOUND_STEP], unit);
}
 
EXPORT_SYMBOL(unregister_sound_special);

/**
 *	unregister_sound_mixer - unregister a mixer
 *	@unit: unit number to allocate
 *
 *	Release a sound device that was allocated with register_sound_mixer().
 *	The unit passed is the return value from the register function.
 */

void unregister_sound_mixer(int unit)
{
	sound_remove_unit(&chains[0], unit);
}

EXPORT_SYMBOL(unregister_sound_mixer);

/**
 *	unregister_sound_dsp - unregister a DSP device
 *	@unit: unit number to allocate
 *
 *	Release a sound device that was allocated with register_sound_dsp().
 *	The unit passed is the return value from the register function.
 *
 *	Both of the allocated units are released together automatically.
 */

void unregister_sound_dsp(int unit)
{
	sound_remove_unit(&chains[3], unit);
}


EXPORT_SYMBOL(unregister_sound_dsp);

static struct sound_unit *__look_for_unit(int chain, int unit)
{
	struct sound_unit *s;
	
	s=chains[chain];
	while(s && s->unit_minor <= unit)
	{
		if(s->unit_minor==unit)
			return s;
		s=s->next;
	}
	return NULL;
}

static int soundcore_open(struct inode *inode, struct file *file)
{
	int chain;
	int unit = iminor(inode);
	struct sound_unit *s;
	const struct file_operations *new_fops = NULL;

	chain=unit&0x0F;
	if(chain==4 || chain==5)	/* dsp/audio/dsp16 */
	{
		unit&=0xF0;
		unit|=3;
		chain=3;
	}
	
	spin_lock(&sound_loader_lock);
	s = __look_for_unit(chain, unit);
	if (s)
		new_fops = fops_get(s->unit_fops);
	if (preclaim_oss && !new_fops) {
		spin_unlock(&sound_loader_lock);

		/*
		 *  Please, don't change this order or code.
		 *  For ALSA slot means soundcard and OSS emulation code
		 *  comes as add-on modules which aren't depend on
		 *  ALSA toplevel modules for soundcards, thus we need
		 *  load them at first.	  [Jaroslav Kysela <[email protected]>]
		 */
		request_module("sound-slot-%i", unit>>4);
		request_module("sound-service-%i-%i", unit>>4, chain);

		/*
		 * sound-slot/service-* module aliases are scheduled
		 * for removal in favor of the standard char-major-*
		 * module aliases.  For the time being, generate both
		 * the legacy and standard module aliases to ease
		 * transition.
		 */
		if (request_module("char-major-%d-%d", SOUND_MAJOR, unit) > 0)
			request_module("char-major-%d", SOUND_MAJOR);

		spin_lock(&sound_loader_lock);
		s = __look_for_unit(chain, unit);
		if (s)
			new_fops = fops_get(s->unit_fops);
	}
	spin_unlock(&sound_loader_lock);
	if (new_fops) {
		/*
		 * We rely upon the fact that we can't be unloaded while the
		 * subdriver is there.
		 */
		int err = 0;
		replace_fops(file, new_fops);

		if (file->f_op->open)
			err = file->f_op->open(inode,file);

		return err;
	}
	return -ENODEV;
}

MODULE_ALIAS_CHARDEV_MAJOR(SOUND_MAJOR);

static void cleanup_oss_soundcore(void)
{
	/* We have nothing to really do here - we know the lists must be
	   empty */
	unregister_chrdev(SOUND_MAJOR, "sound");
}

static int __init init_oss_soundcore(void)
{
	if (preclaim_oss &&
	    register_chrdev(SOUND_MAJOR, "sound", &soundcore_fops) < 0) {
		printk(KERN_ERR "soundcore: sound device already in use.\n");
		return -EBUSY;
	}

	return 0;
}

#endif /* CONFIG_SOUND_OSS_CORE */
Commit	Line	Data
2874c5fd	1	// SPDX-License-Identifier: GPL-2.0-or-later
1da177e4	2	/*
d886e87c TH	3	* Sound core. This file is composed of two parts. sound_class
	4	* which is common to both OSS and ALSA and OSS sound core which
	5	* is used OSS or emulation of it.
	6	*/
	7
	8	/*
	9	* First, the common part.
	10	*/
	11	#include <linux/module.h>
	12	#include <linux/device.h>
	13	#include <linux/err.h>
954a973c KS	14	#include <linux/kdev_t.h>
954a973c KS	15	#include <linux/major.h>
3d1ee379	16	#include <sound/core.h>
d886e87c TH	17
	18	#ifdef CONFIG_SOUND_OSS_CORE
	19	static int __init init_oss_soundcore(void);
de30d36b	20	static void cleanup_oss_soundcore(void);
d886e87c TH	21	#else
	22	static inline int init_oss_soundcore(void) { return 0; }
	23	static inline void cleanup_oss_soundcore(void) { }
	24	#endif
	25
	26	struct class *sound_class;
	27	EXPORT_SYMBOL(sound_class);
	28
	29	MODULE_DESCRIPTION("Core sound module");
	30	MODULE_AUTHOR("Alan Cox");
	31	MODULE_LICENSE("GPL");
	32
2c9ede55	33	static char sound_devnode(struct device dev, umode_t *mode)
7a9d56f6	34	{
954a973c KS	35	if (MAJOR(dev->devt) == SOUND_MAJOR)
954a973c KS	36	return NULL;
7a9d56f6 KS	37	return kasprintf(GFP_KERNEL, "snd/%s", dev_name(dev));
	38	}
	39
d886e87c TH	40	static int __init init_soundcore(void)
	41	{
	42	int rc;
	43
	44	rc = init_oss_soundcore();
	45	if (rc)
	46	return rc;
	47
	48	sound_class = class_create(THIS_MODULE, "sound");
	49	if (IS_ERR(sound_class)) {
	50	cleanup_oss_soundcore();
	51	return PTR_ERR(sound_class);
	52	}
	53
e454cea2	54	sound_class->devnode = sound_devnode;
7a9d56f6	55
d886e87c TH	56	return 0;
	57	}
	58
	59	static void __exit cleanup_soundcore(void)
	60	{
	61	cleanup_oss_soundcore();
	62	class_destroy(sound_class);
	63	}
	64
c181a13a	65	subsys_initcall(init_soundcore);
d886e87c TH	66	module_exit(cleanup_soundcore);
	67
	68
	69	#ifdef CONFIG_SOUND_OSS_CORE
	70	/*
	71	* OSS sound core handling. Breaks out sound functions to submodules
1da177e4	72	*
2f1e593d	73	* Author: Alan Cox <[email protected]>
1da177e4 LT	74	*
	75	* Fixes:
	76	*
1da177e4 LT	77	* --------------------
	78	*
	79	* Top level handler for the sound subsystem. Various devices can
	80	* plug into this. The fact they don't all go via OSS doesn't mean
	81	* they don't have to implement the OSS API. There is a lot of logic
	82	* to keeping much of the OSS weight out of the code in a compatibility
	83	* module, but it's up to the driver to rember to load it...
	84	*
	85	* The code provides a set of functions for registration of devices
	86	* by type. This is done rather than providing a single call so that
	87	* we can hide any future changes in the internals (eg when we go to
	88	* 32bit dev_t) from the modules and their interface.
	89	*
	90	* Secondly we need to allocate the dsp, dsp16 and audio devices as
	91	* one. Thus we misuse the chains a bit to simplify this.
	92	*
	93	* Thirdly to make it more fun and for 2.3.x and above we do all
	94	* of this using fine grained locking.
	95	*
	96	* FIXME: we have to resolve modules and fine grained load/unload
	97	* locking at some point in 2.3.x.
	98	*/
	99
1da177e4 LT	100	#include <linux/init.h>
	101	#include <linux/slab.h>
	102	#include <linux/types.h>
	103	#include <linux/kernel.h>
1da177e4	104	#include <linux/sound.h>
1da177e4	105	#include <linux/kmod.h>
1da177e4 LT	106
	107	#define SOUND_STEP 16
	108
1da177e4 LT	109	struct sound_unit
	110	{
	111	int unit_minor;
99ac48f5	112	const struct file_operations *unit_fops;
1da177e4 LT	113	struct sound_unit *next;
	114	char name[32];
	115	};
	116
93fe4483 TH	117	/*
	118	* By default, OSS sound_core claims full legacy minor range (0-255)
	119	* of SOUND_MAJOR to trap open attempts to any sound minor and
	120	* requests modules using custom sound-slot/service-* module aliases.
	121	* The only benefit of doing this is allowing use of custom module
	122	* aliases instead of the standard char-major-* ones. This behavior
	123	* prevents alternative OSS implementation and is scheduled to be
	124	* removed.
	125	*
	126	* CONFIG_SOUND_OSS_CORE_PRECLAIM and soundcore.preclaim_oss kernel
	127	* parameter are added to allow distros and developers to try and
	128	* switch to alternative implementations without needing to rebuild
	129	* the kernel in the meantime. If preclaim_oss is non-zero, the
	130	* kernel will behave the same as before. All SOUND_MAJOR minors are
	131	* preclaimed and the custom module aliases along with standard chrdev
	132	* ones are emitted if a missing device is opened. If preclaim_oss is
	133	* zero, sound_core only grabs what's actually in use and for missing
	134	* devices only the standard chrdev aliases are requested.
	135	*
	136	* All these clutters are scheduled to be removed along with
8f6e6041	137	* sound-slot/service-* module aliases.
93fe4483 TH	138	*/
	139	#ifdef CONFIG_SOUND_OSS_CORE_PRECLAIM
	140	static int preclaim_oss = 1;
	141	#else
	142	static int preclaim_oss = 0;
	143	#endif
	144
	145	module_param(preclaim_oss, int, 0444);
	146
	147	static int soundcore_open(struct inode , struct file );
	148
	149	static const struct file_operations soundcore_fops =
	150	{
	151	/* We must have an owner or the module locking fails */
	152	.owner = THIS_MODULE,
	153	.open = soundcore_open,
6038f373	154	.llseek = noop_llseek,
93fe4483 TH	155	};
93fe4483 TH	156
1da177e4 LT	157	/*
	158	* Low level list operator. Scan the ordered list, find a hole and
	159	* join into it. Called with the lock asserted
	160	*/
	161
99ac48f5	162	static int __sound_insert_unit(struct sound_unit * s, struct sound_unit *list, const struct file_operations fops, int index, int low, int top)
1da177e4 LT	163	{
	164	int n=low;
	165
	166	if (index < 0) { /* first free */
	167
	168	while (list && (list)->unit_minor<n)
	169	list=&((*list)->next);
	170
	171	while(n<top)
	172	{
	173	/* Found a hole ? */
	174	if(list==NULL \|\| (list)->unit_minor>n)
	175	break;
	176	list=&((*list)->next);
	177	n+=SOUND_STEP;
	178	}
	179
	180	if(n>=top)
	181	return -ENOENT;
	182	} else {
	183	n = low+(index*16);
	184	while (*list) {
	185	if ((*list)->unit_minor==n)
	186	return -EBUSY;
	187	if ((*list)->unit_minor>n)
	188	break;
	189	list=&((*list)->next);
	190	}
	191	}
	192
	193	/*
	194	* Fill it in
	195	*/
	196
	197	s->unit_minor=n;
	198	s->unit_fops=fops;
	199
	200	/*
	201	* Link it
	202	*/
	203
	204	s->next=*list;
	205	*list=s;
	206
	207
	208	return n;
	209	}
	210
	211	/*
	212	* Remove a node from the chain. Called with the lock asserted
	213	*/
	214
	215	static struct sound_unit __sound_remove_unit(struct sound_unit *list, int unit)
	216	{
	217	while(*list)
	218	{
	219	struct sound_unit p=list;
	220	if(p->unit_minor==unit)
	221	{
	222	*list=p->next;
	223	return p;
	224	}
	225	list=&(p->next);
	226	}
227	printk(KERN_ERR "Sound device %d went missing!\n", unit);
228	return NULL;
229	}
230
231	/*
232	* This lock guards the sound loader list.
233	*/
234
235	static DEFINE_SPINLOCK(sound_loader_lock);
236
237	/*
238	* Allocate the controlling structure and add it to the sound driver
239	* list. Acquires locks as needed
240	*/
241
99ac48f5	242	static int sound_insert_unit(struct sound_unit *list, const struct file_operations fops, int index, int low, int top, const char name, umode_t mode, struct device dev)
1da177e4 LT	243	{
	244	struct sound_unit s = kmalloc(sizeof(s), GFP_KERNEL);
	245	int r;
	246
	247	if (!s)
	248	return -ENOMEM;
93fe4483	249
1da177e4	250	spin_lock(&sound_loader_lock);
93fe4483	251	retry:
1da177e4 LT	252	r = __sound_insert_unit(s, list, fops, index, low, top);
	253	spin_unlock(&sound_loader_lock);
	254
	255	if (r < 0)
	256	goto fail;
	257	else if (r < SOUND_STEP)
	258	sprintf(s->name, "sound/%s", name);
	259	else
	260	sprintf(s->name, "sound/%s%d", name, r / SOUND_STEP);
	261
93fe4483 TH	262	if (!preclaim_oss) {
	263	/*
	264	* Something else might have grabbed the minor. If
	265	* first free slot is requested, rescan with @low set
	266	* to the next unit; otherwise, -EBUSY.
	267	*/
	268	r = __register_chrdev(SOUND_MAJOR, s->unit_minor, 1, s->name,
	269	&soundcore_fops);
	270	if (r < 0) {
	271	spin_lock(&sound_loader_lock);
	272	__sound_remove_unit(list, s->unit_minor);
	273	if (index < 0) {
	274	low = s->unit_minor + SOUND_STEP;
	275	goto retry;
	276	}
	277	spin_unlock(&sound_loader_lock);
c7cd7c74 WW	278	r = -EBUSY;
c7cd7c74 WW	279	goto fail;
93fe4483 TH	280	}
	281	}
	282
abe9ab8f	283	device_create(sound_class, dev, MKDEV(SOUND_MAJOR, s->unit_minor),
02aa2a37	284	NULL, "%s", s->name+6);
93fe4483	285	return s->unit_minor;
1da177e4	286
93fe4483	287	fail:
1da177e4 LT	288	kfree(s);
	289	return r;
	290	}
	291
	292	/*
	293	* Remove a unit. Acquires locks as needed. The drivers MUST have
	294	* completed the removal before their file operations become
	295	* invalid.
	296	*/
	297
	298	static void sound_remove_unit(struct sound_unit **list, int unit)
	299	{
	300	struct sound_unit *p;
	301
	302	spin_lock(&sound_loader_lock);
	303	p = __sound_remove_unit(list, unit);
	304	spin_unlock(&sound_loader_lock);
	305	if (p) {
93fe4483 TH	306	if (!preclaim_oss)
	307	__unregister_chrdev(SOUND_MAJOR, p->unit_minor, 1,
	308	p->name);
d80f19fa	309	device_destroy(sound_class, MKDEV(SOUND_MAJOR, p->unit_minor));
1da177e4 LT	310	kfree(p);
	311	}
	312	}
	313
	314	/*
	315	* Allocations
	316	*
	317	* 0 *16 Mixers
	318	* 1 *8 Sequencers
	319	* 2 *16 Midi
	320	* 3 *16 DSP
	321	* 4 *16 SunDSP
	322	* 5 *16 DSP16
	323	* 6 -- sndstat (obsolete)
	324	* 7 *16 unused
	325	* 8 -- alternate sequencer (see above)
	326	* 9 *16 raw synthesizer access
	327	* 10 *16 unused
	328	* 11 *16 unused
	329	* 12 *16 unused
	330	* 13 *16 unused
	331	* 14 *16 unused
	332	* 15 *16 unused
	333	*/
	334
	335	static struct sound_unit *chains[SOUND_STEP];
	336
	337	/**
d568121c	338	* register_sound_special_device - register a special sound node
1da177e4 LT	339	* @fops: File operations for the driver
1da177e4 LT	340	* @unit: Unit number to allocate
d568121c	341	* @dev: device pointer
1da177e4 LT	342	*
1da177e4 LT	343	* Allocate a special sound device by minor number from the sound
eb7c06e8 YB	344	* subsystem.
	345	*
	346	* Return: The allocated number is returned on success. On failure,
1da177e4 LT	347	* a negative error code is returned.
	348	*/
	349
99ac48f5	350	int register_sound_special_device(const struct file_operations *fops, int unit,
d568121c	351	struct device *dev)
1da177e4 LT	352	{
1da177e4 LT	353	const int chain = unit % SOUND_STEP;
2abb8017	354	int max_unit = 256;
1da177e4 LT	355	const char *name;
	356	char _name[16];
	357
	358	switch (chain) {
	359	case 0:
	360	name = "mixer";
	361	break;
	362	case 1:
	363	name = "sequencer";
	364	if (unit >= SOUND_STEP)
	365	goto __unknown;
	366	max_unit = unit + 1;
	367	break;
	368	case 2:
	369	name = "midi";
	370	break;
	371	case 3:
	372	name = "dsp";
	373	break;
	374	case 4:
	375	name = "audio";
	376	break;
848669da TI	377	case 5:
	378	name = "dspW";
	379	break;
1da177e4 LT	380	case 8:
	381	name = "sequencer2";
	382	if (unit >= SOUND_STEP)
	383	goto __unknown;
	384	max_unit = unit + 1;
	385	break;
	386	case 9:
	387	name = "dmmidi";
	388	break;
	389	case 10:
	390	name = "dmfm";
	391	break;
	392	case 12:
	393	name = "adsp";
	394	break;
	395	case 13:
	396	name = "amidi";
	397	break;
	398	case 14:
	399	name = "admmidi";
	400	break;
	401	default:
	402	{
	403	__unknown:
	404	sprintf(_name, "unknown%d", chain);
	405	if (unit >= SOUND_STEP)
	406	strcat(_name, "-");
	407	name = _name;
	408	}
	409	break;
	410	}
	411	return sound_insert_unit(&chains[chain], fops, -1, unit, max_unit,
6a73cf46	412	name, 0600, dev);
1da177e4 LT	413	}
1da177e4 LT	414
d568121c TI	415	EXPORT_SYMBOL(register_sound_special_device);
d568121c TI	416
99ac48f5	417	int register_sound_special(const struct file_operations *fops, int unit)
d568121c TI	418	{
	419	return register_sound_special_device(fops, unit, NULL);
	420	}
	421
1da177e4 LT	422	EXPORT_SYMBOL(register_sound_special);
	423
	424	/**
	425	* register_sound_mixer - register a mixer device
	426	* @fops: File operations for the driver
	427	* @dev: Unit number to allocate
	428	*
	429	* Allocate a mixer device. Unit is the number of the mixer requested.
eb7c06e8 YB	430	* Pass -1 to request the next free mixer unit.
	431	*
	432	* Return: On success, the allocated number is returned. On failure,
	433	* a negative error code is returned.
1da177e4 LT	434	*/
1da177e4 LT	435
99ac48f5	436	int register_sound_mixer(const struct file_operations *fops, int dev)
1da177e4 LT	437	{
1da177e4 LT	438	return sound_insert_unit(&chains[0], fops, dev, 0, 128,
6a73cf46	439	"mixer", 0600, NULL);
1da177e4 LT	440	}
	441
	442	EXPORT_SYMBOL(register_sound_mixer);
	443
1da177e4 LT	444	/*
	445	* DSP's are registered as a triple. Register only one and cheat
	446	* in open - see below.
	447	*/
	448
	449	/**
	450	* register_sound_dsp - register a DSP device
	451	* @fops: File operations for the driver
	452	* @dev: Unit number to allocate
	453	*
	454	* Allocate a DSP device. Unit is the number of the DSP requested.
eb7c06e8	455	* Pass -1 to request the next free DSP unit.
1da177e4 LT	456	*
	457	* This function allocates both the audio and dsp device entries together
	458	* and will always allocate them as a matching pair - eg dsp3/audio3
eb7c06e8 YB	459	*
	460	* Return: On success, the allocated number is returned. On failure,
	461	* a negative error code is returned.
1da177e4 LT	462	*/
1da177e4 LT	463
99ac48f5	464	int register_sound_dsp(const struct file_operations *fops, int dev)
1da177e4 LT	465	{
1da177e4 LT	466	return sound_insert_unit(&chains[3], fops, dev, 3, 131,
6a73cf46	467	"dsp", 0600, NULL);
1da177e4 LT	468	}
	469
	470	EXPORT_SYMBOL(register_sound_dsp);
	471
1da177e4 LT	472	/**
	473	* unregister_sound_special - unregister a special sound device
	474	* @unit: unit number to allocate
	475	*
	476	* Release a sound device that was allocated with
	477	* register_sound_special(). The unit passed is the return value from
	478	* the register function.
	479	*/
	480
	481
	482	void unregister_sound_special(int unit)
	483	{
	484	sound_remove_unit(&chains[unit % SOUND_STEP], unit);
	485	}
	486
	487	EXPORT_SYMBOL(unregister_sound_special);
	488
	489	/**
	490	* unregister_sound_mixer - unregister a mixer
	491	* @unit: unit number to allocate
	492	*
	493	* Release a sound device that was allocated with register_sound_mixer().
	494	* The unit passed is the return value from the register function.
	495	*/
	496
	497	void unregister_sound_mixer(int unit)
	498	{
	499	sound_remove_unit(&chains[0], unit);
	500	}
	501
	502	EXPORT_SYMBOL(unregister_sound_mixer);
	503
1da177e4 LT	504	/**
	505	* unregister_sound_dsp - unregister a DSP device
	506	* @unit: unit number to allocate
	507	*
	508	* Release a sound device that was allocated with register_sound_dsp().
	509	* The unit passed is the return value from the register function.
	510	*
	511	* Both of the allocated units are released together automatically.
	512	*/
	513
	514	void unregister_sound_dsp(int unit)
	515	{
a39c4ad1	516	sound_remove_unit(&chains[3], unit);
1da177e4 LT	517	}
	518
	519
	520	EXPORT_SYMBOL(unregister_sound_dsp);
	521
1da177e4 LT	522	static struct sound_unit *__look_for_unit(int chain, int unit)
	523	{
	524	struct sound_unit *s;
	525
	526	s=chains[chain];
	527	while(s && s->unit_minor <= unit)
	528	{
	529	if(s->unit_minor==unit)
	530	return s;
	531	s=s->next;
	532	}
	533	return NULL;
	534	}
	535
a39c4ad1	536	static int soundcore_open(struct inode inode, struct file file)
1da177e4 LT	537	{
	538	int chain;
	539	int unit = iminor(inode);
	540	struct sound_unit *s;
99ac48f5	541	const struct file_operations *new_fops = NULL;
1da177e4 LT	542
	543	chain=unit&0x0F;
	544	if(chain==4 \|\| chain==5) /* dsp/audio/dsp16 */
	545	{
	546	unit&=0xF0;
	547	unit\|=3;
	548	chain=3;
	549	}
	550
	551	spin_lock(&sound_loader_lock);
	552	s = __look_for_unit(chain, unit);
	553	if (s)
	554	new_fops = fops_get(s->unit_fops);
93fe4483	555	if (preclaim_oss && !new_fops) {
1da177e4	556	spin_unlock(&sound_loader_lock);
0a848680	557
1da177e4 LT	558	/*
	559	* Please, don't change this order or code.
	560	* For ALSA slot means soundcard and OSS emulation code
	561	* comes as add-on modules which aren't depend on
	562	* ALSA toplevel modules for soundcards, thus we need
	563	* load them at first. [Jaroslav Kysela <[email protected]>]
	564	*/
	565	request_module("sound-slot-%i", unit>>4);
	566	request_module("sound-service-%i-%i", unit>>4, chain);
0a848680 TH	567
	568	/*
	569	* sound-slot/service-* module aliases are scheduled
	570	* for removal in favor of the standard char-major-*
	571	* module aliases. For the time being, generate both
	572	* the legacy and standard module aliases to ease
	573	* transition.
	574	*/
	575	if (request_module("char-major-%d-%d", SOUND_MAJOR, unit) > 0)
	576	request_module("char-major-%d", SOUND_MAJOR);
	577
1da177e4 LT	578	spin_lock(&sound_loader_lock);
	579	s = __look_for_unit(chain, unit);
	580	if (s)
	581	new_fops = fops_get(s->unit_fops);
	582	}
e84f9e57	583	spin_unlock(&sound_loader_lock);
1da177e4 LT	584	if (new_fops) {
	585	/*
	586	* We rely upon the fact that we can't be unloaded while the
e84f9e57	587	* subdriver is there.
1da177e4 LT	588	*/
1da177e4 LT	589	int err = 0;
e84f9e57	590	replace_fops(file, new_fops);
171d9f7d	591
90dc763f	592	if (file->f_op->open)
1da177e4	593	err = file->f_op->open(inode,file);
171d9f7d	594
1da177e4 LT	595	return err;
1da177e4 LT	596	}
1da177e4 LT	597	return -ENODEV;
	598	}
	599
1da177e4 LT	600	MODULE_ALIAS_CHARDEV_MAJOR(SOUND_MAJOR);
1da177e4 LT	601
de30d36b	602	static void cleanup_oss_soundcore(void)
1da177e4 LT	603	{
	604	/* We have nothing to really do here - we know the lists must be
	605	empty */
	606	unregister_chrdev(SOUND_MAJOR, "sound");
1da177e4 LT	607	}
1da177e4 LT	608
d886e87c	609	static int __init init_oss_soundcore(void)
1da177e4	610	{
93fe4483	611	if (preclaim_oss &&
cb68429d	612	register_chrdev(SOUND_MAJOR, "sound", &soundcore_fops) < 0) {
1da177e4 LT	613	printk(KERN_ERR "soundcore: sound device already in use.\n");
	614	return -EBUSY;
	615	}
1da177e4 LT	616
	617	return 0;
	618	}
	619
d886e87c	620	#endif /* CONFIG_SOUND_OSS_CORE */