control.c 44.0 KB
Newer Older
L
Linus Torvalds 已提交
1 2
/*
 *  Routines for driver control interface
3
 *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
L
Linus Torvalds 已提交
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
 *
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 *
 */

#include <linux/threads.h>
#include <linux/interrupt.h>
#include <linux/slab.h>
#include <linux/vmalloc.h>
#include <linux/time.h>
#include <sound/core.h>
#include <sound/minors.h>
#include <sound/info.h>
#include <sound/control.h>

/* max number of user-defined controls */
#define MAX_USER_CONTROLS	32
34
#define MAX_CONTROL_COUNT	1028
L
Linus Torvalds 已提交
35

36
struct snd_kctl_ioctl {
L
Linus Torvalds 已提交
37 38
	struct list_head list;		/* list of all ioctls */
	snd_kctl_ioctl_func_t fioctl;
39
};
L
Linus Torvalds 已提交
40 41 42 43 44 45 46 47 48 49

static DECLARE_RWSEM(snd_ioctl_rwsem);
static LIST_HEAD(snd_control_ioctls);
#ifdef CONFIG_COMPAT
static LIST_HEAD(snd_control_compat_ioctls);
#endif

static int snd_ctl_open(struct inode *inode, struct file *file)
{
	unsigned long flags;
50 51
	struct snd_card *card;
	struct snd_ctl_file *ctl;
L
Linus Torvalds 已提交
52 53
	int err;

T
Takashi Iwai 已提交
54 55 56 57
	err = nonseekable_open(inode, file);
	if (err < 0)
		return err;

58
	card = snd_lookup_minor_data(iminor(inode), SNDRV_DEVICE_TYPE_CONTROL);
L
Linus Torvalds 已提交
59 60 61 62 63 64 65 66 67 68 69 70 71
	if (!card) {
		err = -ENODEV;
		goto __error1;
	}
	err = snd_card_file_add(card, file);
	if (err < 0) {
		err = -ENODEV;
		goto __error1;
	}
	if (!try_module_get(card->module)) {
		err = -EFAULT;
		goto __error2;
	}
72
	ctl = kzalloc(sizeof(*ctl), GFP_KERNEL);
L
Linus Torvalds 已提交
73 74 75 76 77 78 79 80
	if (ctl == NULL) {
		err = -ENOMEM;
		goto __error;
	}
	INIT_LIST_HEAD(&ctl->events);
	init_waitqueue_head(&ctl->change_sleep);
	spin_lock_init(&ctl->read_lock);
	ctl->card = card;
81 82
	ctl->prefer_pcm_subdevice = -1;
	ctl->prefer_rawmidi_subdevice = -1;
83
	ctl->pid = get_pid(task_pid(current));
L
Linus Torvalds 已提交
84 85 86 87 88 89 90 91 92 93 94 95 96 97
	file->private_data = ctl;
	write_lock_irqsave(&card->ctl_files_rwlock, flags);
	list_add_tail(&ctl->list, &card->ctl_files);
	write_unlock_irqrestore(&card->ctl_files_rwlock, flags);
	return 0;

      __error:
	module_put(card->module);
      __error2:
	snd_card_file_remove(card, file);
      __error1:
      	return err;
}

98
static void snd_ctl_empty_read_queue(struct snd_ctl_file * ctl)
L
Linus Torvalds 已提交
99
{
100
	unsigned long flags;
101
	struct snd_kctl_event *cread;
L
Linus Torvalds 已提交
102
	
103
	spin_lock_irqsave(&ctl->read_lock, flags);
L
Linus Torvalds 已提交
104 105 106 107 108
	while (!list_empty(&ctl->events)) {
		cread = snd_kctl_event(ctl->events.next);
		list_del(&cread->list);
		kfree(cread);
	}
109
	spin_unlock_irqrestore(&ctl->read_lock, flags);
L
Linus Torvalds 已提交
110 111 112 113 114
}

static int snd_ctl_release(struct inode *inode, struct file *file)
{
	unsigned long flags;
115 116 117
	struct snd_card *card;
	struct snd_ctl_file *ctl;
	struct snd_kcontrol *control;
L
Linus Torvalds 已提交
118 119 120 121 122 123 124 125 126
	unsigned int idx;

	ctl = file->private_data;
	file->private_data = NULL;
	card = ctl->card;
	write_lock_irqsave(&card->ctl_files_rwlock, flags);
	list_del(&ctl->list);
	write_unlock_irqrestore(&card->ctl_files_rwlock, flags);
	down_write(&card->controls_rwsem);
127
	list_for_each_entry(control, &card->controls, list)
L
Linus Torvalds 已提交
128 129 130 131 132
		for (idx = 0; idx < control->count; idx++)
			if (control->vd[idx].owner == ctl)
				control->vd[idx].owner = NULL;
	up_write(&card->controls_rwsem);
	snd_ctl_empty_read_queue(ctl);
133
	put_pid(ctl->pid);
L
Linus Torvalds 已提交
134 135 136 137 138 139
	kfree(ctl);
	module_put(card->module);
	snd_card_file_remove(card, file);
	return 0;
}

140 141
void snd_ctl_notify(struct snd_card *card, unsigned int mask,
		    struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
142 143
{
	unsigned long flags;
144 145
	struct snd_ctl_file *ctl;
	struct snd_kctl_event *ev;
L
Linus Torvalds 已提交
146
	
147 148
	if (snd_BUG_ON(!card || !id))
		return;
L
Linus Torvalds 已提交
149 150 151 152
	read_lock(&card->ctl_files_rwlock);
#if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE)
	card->mixer_oss_change_count++;
#endif
153
	list_for_each_entry(ctl, &card->ctl_files, list) {
L
Linus Torvalds 已提交
154 155 156
		if (!ctl->subscribed)
			continue;
		spin_lock_irqsave(&ctl->read_lock, flags);
157
		list_for_each_entry(ev, &ctl->events, list) {
L
Linus Torvalds 已提交
158 159 160 161 162
			if (ev->id.numid == id->numid) {
				ev->mask |= mask;
				goto _found;
			}
		}
163
		ev = kzalloc(sizeof(*ev), GFP_ATOMIC);
L
Linus Torvalds 已提交
164 165 166 167 168 169 170 171 172 173 174 175 176 177 178
		if (ev) {
			ev->id = *id;
			ev->mask = mask;
			list_add_tail(&ev->list, &ctl->events);
		} else {
			snd_printk(KERN_ERR "No memory available to allocate event\n");
		}
	_found:
		wake_up(&ctl->change_sleep);
		spin_unlock_irqrestore(&ctl->read_lock, flags);
		kill_fasync(&ctl->fasync, SIGIO, POLL_IN);
	}
	read_unlock(&card->ctl_files_rwlock);
}

179 180
EXPORT_SYMBOL(snd_ctl_notify);

L
Linus Torvalds 已提交
181 182 183 184 185
/**
 * snd_ctl_new - create a control instance from the template
 * @control: the control template
 * @access: the default control access
 *
186
 * Allocates a new struct snd_kcontrol instance and copies the given template 
L
Linus Torvalds 已提交
187 188 189 190
 * to the new instance. It does not copy volatile data (access).
 *
 * Returns the pointer of the new instance, or NULL on failure.
 */
191 192
static struct snd_kcontrol *snd_ctl_new(struct snd_kcontrol *control,
					unsigned int access)
L
Linus Torvalds 已提交
193
{
194
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
195 196
	unsigned int idx;
	
197 198
	if (snd_BUG_ON(!control || !control->count))
		return NULL;
199 200 201 202

	if (control->count > MAX_CONTROL_COUNT)
		return NULL;

203
	kctl = kzalloc(sizeof(*kctl) + sizeof(struct snd_kcontrol_volatile) * control->count, GFP_KERNEL);
T
Takashi Iwai 已提交
204 205
	if (kctl == NULL) {
		snd_printk(KERN_ERR "Cannot allocate control instance\n");
L
Linus Torvalds 已提交
206
		return NULL;
T
Takashi Iwai 已提交
207
	}
L
Linus Torvalds 已提交
208 209 210 211 212 213 214 215 216 217 218
	*kctl = *control;
	for (idx = 0; idx < kctl->count; idx++)
		kctl->vd[idx].access = access;
	return kctl;
}

/**
 * snd_ctl_new1 - create a control instance from the template
 * @ncontrol: the initialization record
 * @private_data: the private data to set
 *
219
 * Allocates a new struct snd_kcontrol instance and initialize from the given 
L
Linus Torvalds 已提交
220 221 222 223 224
 * template.  When the access field of ncontrol is 0, it's assumed as
 * READWRITE access. When the count field is 0, it's assumes as one.
 *
 * Returns the pointer of the newly generated instance, or NULL on failure.
 */
225 226
struct snd_kcontrol *snd_ctl_new1(const struct snd_kcontrol_new *ncontrol,
				  void *private_data)
L
Linus Torvalds 已提交
227
{
228
	struct snd_kcontrol kctl;
L
Linus Torvalds 已提交
229 230
	unsigned int access;
	
231 232
	if (snd_BUG_ON(!ncontrol || !ncontrol->info))
		return NULL;
L
Linus Torvalds 已提交
233 234 235 236
	memset(&kctl, 0, sizeof(kctl));
	kctl.id.iface = ncontrol->iface;
	kctl.id.device = ncontrol->device;
	kctl.id.subdevice = ncontrol->subdevice;
237
	if (ncontrol->name) {
L
Linus Torvalds 已提交
238
		strlcpy(kctl.id.name, ncontrol->name, sizeof(kctl.id.name));
239 240 241 242 243
		if (strcmp(ncontrol->name, kctl.id.name) != 0)
			snd_printk(KERN_WARNING
				   "Control name '%s' truncated to '%s'\n",
				   ncontrol->name, kctl.id.name);
	}
L
Linus Torvalds 已提交
244 245 246
	kctl.id.index = ncontrol->index;
	kctl.count = ncontrol->count ? ncontrol->count : 1;
	access = ncontrol->access == 0 ? SNDRV_CTL_ELEM_ACCESS_READWRITE :
247 248
		 (ncontrol->access & (SNDRV_CTL_ELEM_ACCESS_READWRITE|
				      SNDRV_CTL_ELEM_ACCESS_INACTIVE|
249 250 251
				      SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE|
				      SNDRV_CTL_ELEM_ACCESS_TLV_COMMAND|
				      SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK));
L
Linus Torvalds 已提交
252 253 254
	kctl.info = ncontrol->info;
	kctl.get = ncontrol->get;
	kctl.put = ncontrol->put;
255
	kctl.tlv.p = ncontrol->tlv.p;
L
Linus Torvalds 已提交
256 257 258 259 260
	kctl.private_value = ncontrol->private_value;
	kctl.private_data = private_data;
	return snd_ctl_new(&kctl, access);
}

261 262
EXPORT_SYMBOL(snd_ctl_new1);

L
Linus Torvalds 已提交
263 264 265 266 267 268 269 270
/**
 * snd_ctl_free_one - release the control instance
 * @kcontrol: the control instance
 *
 * Releases the control instance created via snd_ctl_new()
 * or snd_ctl_new1().
 * Don't call this after the control was added to the card.
 */
271
void snd_ctl_free_one(struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
272 273 274 275 276 277 278 279
{
	if (kcontrol) {
		if (kcontrol->private_free)
			kcontrol->private_free(kcontrol);
		kfree(kcontrol);
	}
}

280 281
EXPORT_SYMBOL(snd_ctl_free_one);

282 283
static bool snd_ctl_remove_numid_conflict(struct snd_card *card,
					  unsigned int count)
L
Linus Torvalds 已提交
284
{
285
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
286

287
	list_for_each_entry(kctl, &card->controls, list) {
288
		if (kctl->id.numid < card->last_numid + 1 + count &&
289 290 291 292
		    kctl->id.numid + kctl->count > card->last_numid + 1) {
		    	card->last_numid = kctl->id.numid + kctl->count - 1;
			return true;
		}
L
Linus Torvalds 已提交
293
	}
294
	return false;
L
Linus Torvalds 已提交
295 296
}

297
static int snd_ctl_find_hole(struct snd_card *card, unsigned int count)
L
Linus Torvalds 已提交
298
{
299
	unsigned int iter = 100000;
L
Linus Torvalds 已提交
300

301
	while (snd_ctl_remove_numid_conflict(card, count)) {
L
Linus Torvalds 已提交
302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323
		if (--iter == 0) {
			/* this situation is very unlikely */
			snd_printk(KERN_ERR "unable to allocate new control numid\n");
			return -ENOMEM;
		}
	}
	return 0;
}

/**
 * snd_ctl_add - add the control instance to the card
 * @card: the card instance
 * @kcontrol: the control instance to add
 *
 * Adds the control instance created via snd_ctl_new() or
 * snd_ctl_new1() to the given card. Assigns also an unique
 * numid used for fast search.
 *
 * Returns zero if successful, or a negative error code on failure.
 *
 * It frees automatically the control which cannot be added.
 */
324
int snd_ctl_add(struct snd_card *card, struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
325
{
326
	struct snd_ctl_elem_id id;
L
Linus Torvalds 已提交
327
	unsigned int idx;
328
	int err = -EINVAL;
L
Linus Torvalds 已提交
329

T
Takashi Iwai 已提交
330
	if (! kcontrol)
331
		return err;
332 333
	if (snd_BUG_ON(!card || !kcontrol->info))
		goto error;
L
Linus Torvalds 已提交
334 335 336 337 338 339 340 341 342 343
	id = kcontrol->id;
	down_write(&card->controls_rwsem);
	if (snd_ctl_find_id(card, &id)) {
		up_write(&card->controls_rwsem);
		snd_printd(KERN_ERR "control %i:%i:%i:%s:%i is already present\n",
					id.iface,
					id.device,
					id.subdevice,
					id.name,
					id.index);
344 345
		err = -EBUSY;
		goto error;
L
Linus Torvalds 已提交
346 347 348
	}
	if (snd_ctl_find_hole(card, kcontrol->count) < 0) {
		up_write(&card->controls_rwsem);
349 350
		err = -ENOMEM;
		goto error;
L
Linus Torvalds 已提交
351 352 353 354 355 356 357 358 359
	}
	list_add_tail(&kcontrol->list, &card->controls);
	card->controls_count += kcontrol->count;
	kcontrol->id.numid = card->last_numid + 1;
	card->last_numid += kcontrol->count;
	up_write(&card->controls_rwsem);
	for (idx = 0; idx < kcontrol->count; idx++, id.index++, id.numid++)
		snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_ADD, &id);
	return 0;
360 361 362 363

 error:
	snd_ctl_free_one(kcontrol);
	return err;
L
Linus Torvalds 已提交
364 365
}

366 367
EXPORT_SYMBOL(snd_ctl_add);

368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431
/**
 * snd_ctl_replace - replace the control instance of the card
 * @card: the card instance
 * @kcontrol: the control instance to replace
 * @add_on_replace: add the control if not already added
 *
 * Replaces the given control.  If the given control does not exist
 * and the add_on_replace flag is set, the control is added.  If the
 * control exists, it is destroyed first.
 *
 * Returns zero if successful, or a negative error code on failure.
 *
 * It frees automatically the control which cannot be added or replaced.
 */
int snd_ctl_replace(struct snd_card *card, struct snd_kcontrol *kcontrol,
		    bool add_on_replace)
{
	struct snd_ctl_elem_id id;
	unsigned int idx;
	struct snd_kcontrol *old;
	int ret;

	if (!kcontrol)
		return -EINVAL;
	if (snd_BUG_ON(!card || !kcontrol->info)) {
		ret = -EINVAL;
		goto error;
	}
	id = kcontrol->id;
	down_write(&card->controls_rwsem);
	old = snd_ctl_find_id(card, &id);
	if (!old) {
		if (add_on_replace)
			goto add;
		up_write(&card->controls_rwsem);
		ret = -EINVAL;
		goto error;
	}
	ret = snd_ctl_remove(card, old);
	if (ret < 0) {
		up_write(&card->controls_rwsem);
		goto error;
	}
add:
	if (snd_ctl_find_hole(card, kcontrol->count) < 0) {
		up_write(&card->controls_rwsem);
		ret = -ENOMEM;
		goto error;
	}
	list_add_tail(&kcontrol->list, &card->controls);
	card->controls_count += kcontrol->count;
	kcontrol->id.numid = card->last_numid + 1;
	card->last_numid += kcontrol->count;
	up_write(&card->controls_rwsem);
	for (idx = 0; idx < kcontrol->count; idx++, id.index++, id.numid++)
		snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_ADD, &id);
	return 0;

error:
	snd_ctl_free_one(kcontrol);
	return ret;
}
EXPORT_SYMBOL(snd_ctl_replace);

L
Linus Torvalds 已提交
432 433 434 435 436 437 438 439 440 441 442
/**
 * snd_ctl_remove - remove the control from the card and release it
 * @card: the card instance
 * @kcontrol: the control instance to remove
 *
 * Removes the control from the card and then releases the instance.
 * You don't need to call snd_ctl_free_one(). You must be in
 * the write lock - down_write(&card->controls_rwsem).
 * 
 * Returns 0 if successful, or a negative error code on failure.
 */
443
int snd_ctl_remove(struct snd_card *card, struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
444
{
445
	struct snd_ctl_elem_id id;
L
Linus Torvalds 已提交
446 447
	unsigned int idx;

448 449
	if (snd_BUG_ON(!card || !kcontrol))
		return -EINVAL;
L
Linus Torvalds 已提交
450 451 452 453 454 455 456 457 458
	list_del(&kcontrol->list);
	card->controls_count -= kcontrol->count;
	id = kcontrol->id;
	for (idx = 0; idx < kcontrol->count; idx++, id.index++, id.numid++)
		snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_REMOVE, &id);
	snd_ctl_free_one(kcontrol);
	return 0;
}

459 460
EXPORT_SYMBOL(snd_ctl_remove);

L
Linus Torvalds 已提交
461 462 463 464 465 466 467 468 469 470
/**
 * snd_ctl_remove_id - remove the control of the given id and release it
 * @card: the card instance
 * @id: the control id to remove
 *
 * Finds the control instance with the given id, removes it from the
 * card list and releases it.
 * 
 * Returns 0 if successful, or a negative error code on failure.
 */
471
int snd_ctl_remove_id(struct snd_card *card, struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
472
{
473
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
474 475 476 477 478 479 480 481 482 483 484 485 486
	int ret;

	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, id);
	if (kctl == NULL) {
		up_write(&card->controls_rwsem);
		return -ENOENT;
	}
	ret = snd_ctl_remove(card, kctl);
	up_write(&card->controls_rwsem);
	return ret;
}

487 488
EXPORT_SYMBOL(snd_ctl_remove_id);

L
Linus Torvalds 已提交
489
/**
490
 * snd_ctl_remove_user_ctl - remove and release the unlocked user control
L
Linus Torvalds 已提交
491 492 493 494 495 496 497 498
 * @file: active control handle
 * @id: the control id to remove
 *
 * Finds the control instance with the given id, removes it from the
 * card list and releases it.
 * 
 * Returns 0 if successful, or a negative error code on failure.
 */
499 500
static int snd_ctl_remove_user_ctl(struct snd_ctl_file * file,
				   struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
501
{
502 503
	struct snd_card *card = file->card;
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
504 505 506 507 508
	int idx, ret;

	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, id);
	if (kctl == NULL) {
509 510
		ret = -ENOENT;
		goto error;
L
Linus Torvalds 已提交
511
	}
512 513 514 515
	if (!(kctl->vd[0].access & SNDRV_CTL_ELEM_ACCESS_USER)) {
		ret = -EINVAL;
		goto error;
	}
L
Linus Torvalds 已提交
516 517
	for (idx = 0; idx < kctl->count; idx++)
		if (kctl->vd[idx].owner != NULL && kctl->vd[idx].owner != file) {
518 519
			ret = -EBUSY;
			goto error;
L
Linus Torvalds 已提交
520 521
		}
	ret = snd_ctl_remove(card, kctl);
522 523 524
	if (ret < 0)
		goto error;
	card->user_ctl_count--;
525
error:
L
Linus Torvalds 已提交
526 527 528 529
	up_write(&card->controls_rwsem);
	return ret;
}

T
Takashi Iwai 已提交
530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575
/**
 * snd_ctl_activate_id - activate/inactivate the control of the given id
 * @card: the card instance
 * @id: the control id to activate/inactivate
 * @active: non-zero to activate
 *
 * Finds the control instance with the given id, and activate or
 * inactivate the control together with notification, if changed.
 *
 * Returns 0 if unchanged, 1 if changed, or a negative error code on failure.
 */
int snd_ctl_activate_id(struct snd_card *card, struct snd_ctl_elem_id *id,
			int active)
{
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
	unsigned int index_offset;
	int ret;

	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, id);
	if (kctl == NULL) {
		ret = -ENOENT;
		goto unlock;
	}
	index_offset = snd_ctl_get_ioff(kctl, &kctl->id);
	vd = &kctl->vd[index_offset];
	ret = 0;
	if (active) {
		if (!(vd->access & SNDRV_CTL_ELEM_ACCESS_INACTIVE))
			goto unlock;
		vd->access &= ~SNDRV_CTL_ELEM_ACCESS_INACTIVE;
	} else {
		if (vd->access & SNDRV_CTL_ELEM_ACCESS_INACTIVE)
			goto unlock;
		vd->access |= SNDRV_CTL_ELEM_ACCESS_INACTIVE;
	}
	ret = 1;
 unlock:
	up_write(&card->controls_rwsem);
	if (ret > 0)
		snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_INFO, id);
	return ret;
}
EXPORT_SYMBOL_GPL(snd_ctl_activate_id);

L
Linus Torvalds 已提交
576 577 578 579 580 581 582 583 584 585 586
/**
 * snd_ctl_rename_id - replace the id of a control on the card
 * @card: the card instance
 * @src_id: the old id
 * @dst_id: the new id
 *
 * Finds the control with the old id from the card, and replaces the
 * id with the new one.
 *
 * Returns zero if successful, or a negative error code on failure.
 */
587 588
int snd_ctl_rename_id(struct snd_card *card, struct snd_ctl_elem_id *src_id,
		      struct snd_ctl_elem_id *dst_id)
L
Linus Torvalds 已提交
589
{
590
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
591 592 593 594 595 596 597 598 599 600 601 602 603 604

	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, src_id);
	if (kctl == NULL) {
		up_write(&card->controls_rwsem);
		return -ENOENT;
	}
	kctl->id = *dst_id;
	kctl->id.numid = card->last_numid + 1;
	card->last_numid += kctl->count;
	up_write(&card->controls_rwsem);
	return 0;
}

605 606
EXPORT_SYMBOL(snd_ctl_rename_id);

L
Linus Torvalds 已提交
607 608 609 610 611 612 613 614 615 616 617 618
/**
 * snd_ctl_find_numid - find the control instance with the given number-id
 * @card: the card instance
 * @numid: the number-id to search
 *
 * Finds the control instance with the given number-id from the card.
 *
 * Returns the pointer of the instance if found, or NULL if not.
 *
 * The caller must down card->controls_rwsem before calling this function
 * (if the race condition can happen).
 */
619
struct snd_kcontrol *snd_ctl_find_numid(struct snd_card *card, unsigned int numid)
L
Linus Torvalds 已提交
620
{
621
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
622

623 624
	if (snd_BUG_ON(!card || !numid))
		return NULL;
625
	list_for_each_entry(kctl, &card->controls, list) {
L
Linus Torvalds 已提交
626 627 628 629 630 631
		if (kctl->id.numid <= numid && kctl->id.numid + kctl->count > numid)
			return kctl;
	}
	return NULL;
}

632 633
EXPORT_SYMBOL(snd_ctl_find_numid);

L
Linus Torvalds 已提交
634 635 636 637 638 639 640 641 642 643 644 645
/**
 * snd_ctl_find_id - find the control instance with the given id
 * @card: the card instance
 * @id: the id to search
 *
 * Finds the control instance with the given id from the card.
 *
 * Returns the pointer of the instance if found, or NULL if not.
 *
 * The caller must down card->controls_rwsem before calling this function
 * (if the race condition can happen).
 */
646 647
struct snd_kcontrol *snd_ctl_find_id(struct snd_card *card,
				     struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
648
{
649
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
650

651 652
	if (snd_BUG_ON(!card || !id))
		return NULL;
L
Linus Torvalds 已提交
653 654
	if (id->numid != 0)
		return snd_ctl_find_numid(card, id->numid);
655
	list_for_each_entry(kctl, &card->controls, list) {
L
Linus Torvalds 已提交
656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672
		if (kctl->id.iface != id->iface)
			continue;
		if (kctl->id.device != id->device)
			continue;
		if (kctl->id.subdevice != id->subdevice)
			continue;
		if (strncmp(kctl->id.name, id->name, sizeof(kctl->id.name)))
			continue;
		if (kctl->id.index > id->index)
			continue;
		if (kctl->id.index + kctl->count <= id->index)
			continue;
		return kctl;
	}
	return NULL;
}

673 674
EXPORT_SYMBOL(snd_ctl_find_id);

675
static int snd_ctl_card_info(struct snd_card *card, struct snd_ctl_file * ctl,
L
Linus Torvalds 已提交
676 677
			     unsigned int cmd, void __user *arg)
{
678
	struct snd_ctl_card_info *info;
L
Linus Torvalds 已提交
679

680
	info = kzalloc(sizeof(*info), GFP_KERNEL);
L
Linus Torvalds 已提交
681 682 683 684 685 686 687 688 689 690 691
	if (! info)
		return -ENOMEM;
	down_read(&snd_ioctl_rwsem);
	info->card = card->number;
	strlcpy(info->id, card->id, sizeof(info->id));
	strlcpy(info->driver, card->driver, sizeof(info->driver));
	strlcpy(info->name, card->shortname, sizeof(info->name));
	strlcpy(info->longname, card->longname, sizeof(info->longname));
	strlcpy(info->mixername, card->mixername, sizeof(info->mixername));
	strlcpy(info->components, card->components, sizeof(info->components));
	up_read(&snd_ioctl_rwsem);
692
	if (copy_to_user(arg, info, sizeof(struct snd_ctl_card_info))) {
L
Linus Torvalds 已提交
693 694 695 696 697 698 699
		kfree(info);
		return -EFAULT;
	}
	kfree(info);
	return 0;
}

700 701
static int snd_ctl_elem_list(struct snd_card *card,
			     struct snd_ctl_elem_list __user *_list)
L
Linus Torvalds 已提交
702 703
{
	struct list_head *plist;
704 705 706
	struct snd_ctl_elem_list list;
	struct snd_kcontrol *kctl;
	struct snd_ctl_elem_id *dst, *id;
707
	unsigned int offset, space, jidx;
L
Linus Torvalds 已提交
708 709 710 711 712 713 714 715 716 717
	
	if (copy_from_user(&list, _list, sizeof(list)))
		return -EFAULT;
	offset = list.offset;
	space = list.space;
	/* try limit maximum space */
	if (space > 16384)
		return -ENOMEM;
	if (space > 0) {
		/* allocate temporary buffer for atomic operation */
718
		dst = vmalloc(space * sizeof(struct snd_ctl_elem_id));
L
Linus Torvalds 已提交
719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746
		if (dst == NULL)
			return -ENOMEM;
		down_read(&card->controls_rwsem);
		list.count = card->controls_count;
		plist = card->controls.next;
		while (plist != &card->controls) {
			if (offset == 0)
				break;
			kctl = snd_kcontrol(plist);
			if (offset < kctl->count)
				break;
			offset -= kctl->count;
			plist = plist->next;
		}
		list.used = 0;
		id = dst;
		while (space > 0 && plist != &card->controls) {
			kctl = snd_kcontrol(plist);
			for (jidx = offset; space > 0 && jidx < kctl->count; jidx++) {
				snd_ctl_build_ioff(id, kctl, jidx);
				id++;
				space--;
				list.used++;
			}
			plist = plist->next;
			offset = 0;
		}
		up_read(&card->controls_rwsem);
747 748 749
		if (list.used > 0 &&
		    copy_to_user(list.pids, dst,
				 list.used * sizeof(struct snd_ctl_elem_id))) {
L
Linus Torvalds 已提交
750 751 752 753 754 755 756 757 758 759 760 761 762 763
			vfree(dst);
			return -EFAULT;
		}
		vfree(dst);
	} else {
		down_read(&card->controls_rwsem);
		list.count = card->controls_count;
		up_read(&card->controls_rwsem);
	}
	if (copy_to_user(_list, &list, sizeof(list)))
		return -EFAULT;
	return 0;
}

764 765
static int snd_ctl_elem_info(struct snd_ctl_file *ctl,
			     struct snd_ctl_elem_info *info)
L
Linus Torvalds 已提交
766
{
767 768 769
	struct snd_card *card = ctl->card;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
770 771 772 773 774 775 776 777 778 779 780 781 782 783
	unsigned int index_offset;
	int result;
	
	down_read(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, &info->id);
	if (kctl == NULL) {
		up_read(&card->controls_rwsem);
		return -ENOENT;
	}
#ifdef CONFIG_SND_DEBUG
	info->access = 0;
#endif
	result = kctl->info(kctl, info);
	if (result >= 0) {
784
		snd_BUG_ON(info->access);
L
Linus Torvalds 已提交
785 786 787 788 789 790 791 792
		index_offset = snd_ctl_get_ioff(kctl, &info->id);
		vd = &kctl->vd[index_offset];
		snd_ctl_build_ioff(&info->id, kctl, index_offset);
		info->access = vd->access;
		if (vd->owner) {
			info->access |= SNDRV_CTL_ELEM_ACCESS_LOCK;
			if (vd->owner == ctl)
				info->access |= SNDRV_CTL_ELEM_ACCESS_OWNER;
793
			info->owner = pid_vnr(vd->owner->pid);
L
Linus Torvalds 已提交
794 795 796 797 798 799 800 801
		} else {
			info->owner = -1;
		}
	}
	up_read(&card->controls_rwsem);
	return result;
}

802 803
static int snd_ctl_elem_info_user(struct snd_ctl_file *ctl,
				  struct snd_ctl_elem_info __user *_info)
L
Linus Torvalds 已提交
804
{
805
	struct snd_ctl_elem_info info;
L
Linus Torvalds 已提交
806 807 808 809
	int result;

	if (copy_from_user(&info, _info, sizeof(info)))
		return -EFAULT;
810
	snd_power_lock(ctl->card);
811
	result = snd_power_wait(ctl->card, SNDRV_CTL_POWER_D0);
812 813 814
	if (result >= 0)
		result = snd_ctl_elem_info(ctl, &info);
	snd_power_unlock(ctl->card);
L
Linus Torvalds 已提交
815 816 817 818 819 820
	if (result >= 0)
		if (copy_to_user(_info, &info, sizeof(info)))
			return -EFAULT;
	return result;
}

821 822
static int snd_ctl_elem_read(struct snd_card *card,
			     struct snd_ctl_elem_value *control)
L
Linus Torvalds 已提交
823
{
824 825
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
826
	unsigned int index_offset;
827
	int result;
L
Linus Torvalds 已提交
828 829 830 831 832 833 834 835

	down_read(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, &control->id);
	if (kctl == NULL) {
		result = -ENOENT;
	} else {
		index_offset = snd_ctl_get_ioff(kctl, &control->id);
		vd = &kctl->vd[index_offset];
836 837 838 839 840 841
		if ((vd->access & SNDRV_CTL_ELEM_ACCESS_READ) &&
		    kctl->get != NULL) {
			snd_ctl_build_ioff(&control->id, kctl, index_offset);
			result = kctl->get(kctl, control);
		} else
			result = -EPERM;
L
Linus Torvalds 已提交
842 843 844 845 846
	}
	up_read(&card->controls_rwsem);
	return result;
}

847 848
static int snd_ctl_elem_read_user(struct snd_card *card,
				  struct snd_ctl_elem_value __user *_control)
L
Linus Torvalds 已提交
849
{
850
	struct snd_ctl_elem_value *control;
L
Linus Torvalds 已提交
851
	int result;
L
Li Zefan 已提交
852 853 854 855 856

	control = memdup_user(_control, sizeof(*control));
	if (IS_ERR(control))
		return PTR_ERR(control);

857
	snd_power_lock(card);
858
	result = snd_power_wait(card, SNDRV_CTL_POWER_D0);
859 860 861
	if (result >= 0)
		result = snd_ctl_elem_read(card, control);
	snd_power_unlock(card);
L
Linus Torvalds 已提交
862 863 864 865 866 867 868
	if (result >= 0)
		if (copy_to_user(_control, control, sizeof(*control)))
			result = -EFAULT;
	kfree(control);
	return result;
}

869 870
static int snd_ctl_elem_write(struct snd_card *card, struct snd_ctl_file *file,
			      struct snd_ctl_elem_value *control)
L
Linus Torvalds 已提交
871
{
872 873
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
874
	unsigned int index_offset;
875
	int result;
L
Linus Torvalds 已提交
876 877 878 879 880 881 882 883

	down_read(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, &control->id);
	if (kctl == NULL) {
		result = -ENOENT;
	} else {
		index_offset = snd_ctl_get_ioff(kctl, &control->id);
		vd = &kctl->vd[index_offset];
884 885 886 887
		if (!(vd->access & SNDRV_CTL_ELEM_ACCESS_WRITE) ||
		    kctl->put == NULL ||
		    (file && vd->owner && vd->owner != file)) {
			result = -EPERM;
L
Linus Torvalds 已提交
888
		} else {
889 890 891 892 893 894 895 896
			snd_ctl_build_ioff(&control->id, kctl, index_offset);
			result = kctl->put(kctl, control);
		}
		if (result > 0) {
			up_read(&card->controls_rwsem);
			snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
				       &control->id);
			return 0;
L
Linus Torvalds 已提交
897 898 899 900 901 902
		}
	}
	up_read(&card->controls_rwsem);
	return result;
}

903 904
static int snd_ctl_elem_write_user(struct snd_ctl_file *file,
				   struct snd_ctl_elem_value __user *_control)
L
Linus Torvalds 已提交
905
{
906
	struct snd_ctl_elem_value *control;
907
	struct snd_card *card;
L
Linus Torvalds 已提交
908 909
	int result;

L
Li Zefan 已提交
910 911 912 913
	control = memdup_user(_control, sizeof(*control));
	if (IS_ERR(control))
		return PTR_ERR(control);

914 915
	card = file->card;
	snd_power_lock(card);
916
	result = snd_power_wait(card, SNDRV_CTL_POWER_D0);
917 918 919
	if (result >= 0)
		result = snd_ctl_elem_write(card, file, control);
	snd_power_unlock(card);
L
Linus Torvalds 已提交
920 921 922 923 924 925 926
	if (result >= 0)
		if (copy_to_user(_control, control, sizeof(*control)))
			result = -EFAULT;
	kfree(control);
	return result;
}

927 928
static int snd_ctl_elem_lock(struct snd_ctl_file *file,
			     struct snd_ctl_elem_id __user *_id)
L
Linus Torvalds 已提交
929
{
930 931 932 933
	struct snd_card *card = file->card;
	struct snd_ctl_elem_id id;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954
	int result;
	
	if (copy_from_user(&id, _id, sizeof(id)))
		return -EFAULT;
	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, &id);
	if (kctl == NULL) {
		result = -ENOENT;
	} else {
		vd = &kctl->vd[snd_ctl_get_ioff(kctl, &id)];
		if (vd->owner != NULL)
			result = -EBUSY;
		else {
			vd->owner = file;
			result = 0;
		}
	}
	up_write(&card->controls_rwsem);
	return result;
}

955 956
static int snd_ctl_elem_unlock(struct snd_ctl_file *file,
			       struct snd_ctl_elem_id __user *_id)
L
Linus Torvalds 已提交
957
{
958 959 960 961
	struct snd_card *card = file->card;
	struct snd_ctl_elem_id id;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985
	int result;
	
	if (copy_from_user(&id, _id, sizeof(id)))
		return -EFAULT;
	down_write(&card->controls_rwsem);
	kctl = snd_ctl_find_id(card, &id);
	if (kctl == NULL) {
		result = -ENOENT;
	} else {
		vd = &kctl->vd[snd_ctl_get_ioff(kctl, &id)];
		if (vd->owner == NULL)
			result = -EINVAL;
		else if (vd->owner != file)
			result = -EPERM;
		else {
			vd->owner = NULL;
			result = 0;
		}
	}
	up_write(&card->controls_rwsem);
	return result;
}

struct user_element {
986
	struct snd_ctl_elem_info info;
L
Linus Torvalds 已提交
987 988
	void *elem_data;		/* element data */
	unsigned long elem_data_size;	/* size of element data in bytes */
989 990
	void *tlv_data;			/* TLV data */
	unsigned long tlv_data_size;	/* TLV data size */
L
Linus Torvalds 已提交
991 992 993
	void *priv_data;		/* private data (like strings for enumerated type) */
};

994 995
static int snd_ctl_elem_user_info(struct snd_kcontrol *kcontrol,
				  struct snd_ctl_elem_info *uinfo)
L
Linus Torvalds 已提交
996 997 998 999 1000 1001 1002
{
	struct user_element *ue = kcontrol->private_data;

	*uinfo = ue->info;
	return 0;
}

1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024
static int snd_ctl_elem_user_enum_info(struct snd_kcontrol *kcontrol,
				       struct snd_ctl_elem_info *uinfo)
{
	struct user_element *ue = kcontrol->private_data;
	const char *names;
	unsigned int item;

	item = uinfo->value.enumerated.item;

	*uinfo = ue->info;

	item = min(item, uinfo->value.enumerated.items - 1);
	uinfo->value.enumerated.item = item;

	names = ue->priv_data;
	for (; item > 0; --item)
		names += strlen(names) + 1;
	strcpy(uinfo->value.enumerated.name, names);

	return 0;
}

1025 1026
static int snd_ctl_elem_user_get(struct snd_kcontrol *kcontrol,
				 struct snd_ctl_elem_value *ucontrol)
L
Linus Torvalds 已提交
1027 1028 1029 1030 1031 1032 1033
{
	struct user_element *ue = kcontrol->private_data;

	memcpy(&ucontrol->value, ue->elem_data, ue->elem_data_size);
	return 0;
}

1034 1035
static int snd_ctl_elem_user_put(struct snd_kcontrol *kcontrol,
				 struct snd_ctl_elem_value *ucontrol)
L
Linus Torvalds 已提交
1036 1037 1038 1039 1040 1041 1042 1043 1044 1045
{
	int change;
	struct user_element *ue = kcontrol->private_data;
	
	change = memcmp(&ucontrol->value, ue->elem_data, ue->elem_data_size) != 0;
	if (change)
		memcpy(ue->elem_data, &ucontrol->value, ue->elem_data_size);
	return change;
}

1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057
static int snd_ctl_elem_user_tlv(struct snd_kcontrol *kcontrol,
				 int op_flag,
				 unsigned int size,
				 unsigned int __user *tlv)
{
	struct user_element *ue = kcontrol->private_data;
	int change = 0;
	void *new_data;

	if (op_flag > 0) {
		if (size > 1024 * 128)	/* sane value */
			return -EINVAL;
L
Li Zefan 已提交
1058 1059 1060 1061

		new_data = memdup_user(tlv, size);
		if (IS_ERR(new_data))
			return PTR_ERR(new_data);
1062 1063 1064 1065 1066 1067 1068
		change = ue->tlv_data_size != size;
		if (!change)
			change = memcmp(ue->tlv_data, new_data, size);
		kfree(ue->tlv_data);
		ue->tlv_data = new_data;
		ue->tlv_data_size = size;
	} else {
1069 1070
		if (! ue->tlv_data_size || ! ue->tlv_data)
			return -ENXIO;
1071 1072 1073 1074 1075 1076 1077 1078
		if (size < ue->tlv_data_size)
			return -ENOSPC;
		if (copy_to_user(tlv, ue->tlv_data, ue->tlv_data_size))
			return -EFAULT;
	}
	return change;
}

1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112
static int snd_ctl_elem_init_enum_names(struct user_element *ue)
{
	char *names, *p;
	size_t buf_len, name_len;
	unsigned int i;

	if (ue->info.value.enumerated.names_length > 64 * 1024)
		return -EINVAL;

	names = memdup_user(
		(const void __user *)ue->info.value.enumerated.names_ptr,
		ue->info.value.enumerated.names_length);
	if (IS_ERR(names))
		return PTR_ERR(names);

	/* check that there are enough valid names */
	buf_len = ue->info.value.enumerated.names_length;
	p = names;
	for (i = 0; i < ue->info.value.enumerated.items; ++i) {
		name_len = strnlen(p, buf_len);
		if (name_len == 0 || name_len >= 64 || name_len == buf_len) {
			kfree(names);
			return -EINVAL;
		}
		p += name_len + 1;
		buf_len -= name_len + 1;
	}

	ue->priv_data = names;
	ue->info.value.enumerated.names_ptr = 0;

	return 0;
}

1113
static void snd_ctl_elem_user_free(struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
1114
{
1115
	struct user_element *ue = kcontrol->private_data;
1116 1117 1118

	kfree(ue->tlv_data);
	kfree(ue->priv_data);
1119
	kfree(ue);
L
Linus Torvalds 已提交
1120 1121
}

1122 1123
static int snd_ctl_elem_add(struct snd_ctl_file *file,
			    struct snd_ctl_elem_info *info, int replace)
L
Linus Torvalds 已提交
1124
{
1125 1126
	struct snd_card *card = file->card;
	struct snd_kcontrol kctl, *_kctl;
L
Linus Torvalds 已提交
1127 1128 1129 1130
	unsigned int access;
	long private_size;
	struct user_element *ue;
	int idx, err;
L
Lu Guanqun 已提交
1131

1132
	if (!replace && card->user_ctl_count >= MAX_USER_CONTROLS)
L
Linus Torvalds 已提交
1133
		return -ENOMEM;
1134
	if (info->count < 1)
L
Linus Torvalds 已提交
1135 1136
		return -EINVAL;
	access = info->access == 0 ? SNDRV_CTL_ELEM_ACCESS_READWRITE :
1137
		(info->access & (SNDRV_CTL_ELEM_ACCESS_READWRITE|
1138 1139
				 SNDRV_CTL_ELEM_ACCESS_INACTIVE|
				 SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE));
L
Linus Torvalds 已提交
1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159
	info->id.numid = 0;
	memset(&kctl, 0, sizeof(kctl));
	down_write(&card->controls_rwsem);
	_kctl = snd_ctl_find_id(card, &info->id);
	err = 0;
	if (_kctl) {
		if (replace)
			err = snd_ctl_remove(card, _kctl);
		else
			err = -EBUSY;
	} else {
		if (replace)
			err = -ENOENT;
	}
	up_write(&card->controls_rwsem);
	if (err < 0)
		return err;
	memcpy(&kctl.id, &info->id, sizeof(info->id));
	kctl.count = info->owner ? info->owner : 1;
	access |= SNDRV_CTL_ELEM_ACCESS_USER;
1160 1161 1162 1163
	if (info->type == SNDRV_CTL_ELEM_TYPE_ENUMERATED)
		kctl.info = snd_ctl_elem_user_enum_info;
	else
		kctl.info = snd_ctl_elem_user_info;
L
Linus Torvalds 已提交
1164 1165 1166 1167
	if (access & SNDRV_CTL_ELEM_ACCESS_READ)
		kctl.get = snd_ctl_elem_user_get;
	if (access & SNDRV_CTL_ELEM_ACCESS_WRITE)
		kctl.put = snd_ctl_elem_user_put;
1168 1169 1170 1171
	if (access & SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE) {
		kctl.tlv.c = snd_ctl_elem_user_tlv;
		access |= SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK;
	}
L
Linus Torvalds 已提交
1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183
	switch (info->type) {
	case SNDRV_CTL_ELEM_TYPE_BOOLEAN:
	case SNDRV_CTL_ELEM_TYPE_INTEGER:
		private_size = sizeof(long);
		if (info->count > 128)
			return -EINVAL;
		break;
	case SNDRV_CTL_ELEM_TYPE_INTEGER64:
		private_size = sizeof(long long);
		if (info->count > 64)
			return -EINVAL;
		break;
1184 1185 1186 1187 1188
	case SNDRV_CTL_ELEM_TYPE_ENUMERATED:
		private_size = sizeof(unsigned int);
		if (info->count > 128 || info->value.enumerated.items == 0)
			return -EINVAL;
		break;
L
Linus Torvalds 已提交
1189 1190 1191 1192 1193 1194
	case SNDRV_CTL_ELEM_TYPE_BYTES:
		private_size = sizeof(unsigned char);
		if (info->count > 512)
			return -EINVAL;
		break;
	case SNDRV_CTL_ELEM_TYPE_IEC958:
1195
		private_size = sizeof(struct snd_aes_iec958);
L
Linus Torvalds 已提交
1196 1197 1198 1199 1200 1201 1202
		if (info->count != 1)
			return -EINVAL;
		break;
	default:
		return -EINVAL;
	}
	private_size *= info->count;
1203
	ue = kzalloc(sizeof(struct user_element) + private_size, GFP_KERNEL);
L
Linus Torvalds 已提交
1204 1205 1206
	if (ue == NULL)
		return -ENOMEM;
	ue->info = *info;
1207
	ue->info.access = 0;
L
Linus Torvalds 已提交
1208 1209
	ue->elem_data = (char *)ue + sizeof(*ue);
	ue->elem_data_size = private_size;
1210 1211 1212 1213 1214 1215 1216
	if (ue->info.type == SNDRV_CTL_ELEM_TYPE_ENUMERATED) {
		err = snd_ctl_elem_init_enum_names(ue);
		if (err < 0) {
			kfree(ue);
			return err;
		}
	}
L
Linus Torvalds 已提交
1217 1218 1219
	kctl.private_free = snd_ctl_elem_user_free;
	_kctl = snd_ctl_new(&kctl, access);
	if (_kctl == NULL) {
1220
		kfree(ue->priv_data);
1221
		kfree(ue);
L
Linus Torvalds 已提交
1222 1223 1224 1225 1226 1227
		return -ENOMEM;
	}
	_kctl->private_data = ue;
	for (idx = 0; idx < _kctl->count; idx++)
		_kctl->vd[idx].owner = file;
	err = snd_ctl_add(card, _kctl);
1228
	if (err < 0)
L
Linus Torvalds 已提交
1229 1230 1231 1232 1233 1234 1235 1236 1237
		return err;

	down_write(&card->controls_rwsem);
	card->user_ctl_count++;
	up_write(&card->controls_rwsem);

	return 0;
}

1238 1239
static int snd_ctl_elem_add_user(struct snd_ctl_file *file,
				 struct snd_ctl_elem_info __user *_info, int replace)
L
Linus Torvalds 已提交
1240
{
1241
	struct snd_ctl_elem_info info;
L
Linus Torvalds 已提交
1242 1243 1244 1245 1246
	if (copy_from_user(&info, _info, sizeof(info)))
		return -EFAULT;
	return snd_ctl_elem_add(file, &info, replace);
}

1247 1248
static int snd_ctl_elem_remove(struct snd_ctl_file *file,
			       struct snd_ctl_elem_id __user *_id)
L
Linus Torvalds 已提交
1249
{
1250
	struct snd_ctl_elem_id id;
L
Linus Torvalds 已提交
1251 1252 1253

	if (copy_from_user(&id, _id, sizeof(id)))
		return -EFAULT;
1254
	return snd_ctl_remove_user_ctl(file, &id);
L
Linus Torvalds 已提交
1255 1256
}

1257
static int snd_ctl_subscribe_events(struct snd_ctl_file *file, int __user *ptr)
L
Linus Torvalds 已提交
1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277
{
	int subscribe;
	if (get_user(subscribe, ptr))
		return -EFAULT;
	if (subscribe < 0) {
		subscribe = file->subscribed;
		if (put_user(subscribe, ptr))
			return -EFAULT;
		return 0;
	}
	if (subscribe) {
		file->subscribed = 1;
		return 0;
	} else if (file->subscribed) {
		snd_ctl_empty_read_queue(file);
		file->subscribed = 0;
	}
	return 0;
}

1278 1279 1280
static int snd_ctl_tlv_ioctl(struct snd_ctl_file *file,
                             struct snd_ctl_tlv __user *_tlv,
                             int op_flag)
1281
{
1282
	struct snd_card *card = file->card;
1283 1284
	struct snd_ctl_tlv tlv;
	struct snd_kcontrol *kctl;
1285
	struct snd_kcontrol_volatile *vd;
1286 1287 1288 1289 1290
	unsigned int len;
	int err = 0;

	if (copy_from_user(&tlv, _tlv, sizeof(tlv)))
		return -EFAULT;
1291
	if (tlv.length < sizeof(unsigned int) * 2)
1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310
		return -EINVAL;
	down_read(&card->controls_rwsem);
	kctl = snd_ctl_find_numid(card, tlv.numid);
	if (kctl == NULL) {
		err = -ENOENT;
		goto __kctl_end;
	}
	if (kctl->tlv.p == NULL) {
		err = -ENXIO;
		goto __kctl_end;
	}
	vd = &kctl->vd[tlv.numid - kctl->id.numid];
	if ((op_flag == 0 && (vd->access & SNDRV_CTL_ELEM_ACCESS_TLV_READ) == 0) ||
	    (op_flag > 0 && (vd->access & SNDRV_CTL_ELEM_ACCESS_TLV_WRITE) == 0) ||
	    (op_flag < 0 && (vd->access & SNDRV_CTL_ELEM_ACCESS_TLV_COMMAND) == 0)) {
	    	err = -ENXIO;
	    	goto __kctl_end;
	}
	if (vd->access & SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK) {
1311
		if (vd->owner != NULL && vd->owner != file) {
1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333
			err = -EPERM;
			goto __kctl_end;
		}
		err = kctl->tlv.c(kctl, op_flag, tlv.length, _tlv->tlv); 
		if (err > 0) {
			up_read(&card->controls_rwsem);
			snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_TLV, &kctl->id);
			return 0;
		}
	} else {
		if (op_flag) {
			err = -ENXIO;
			goto __kctl_end;
		}
		len = kctl->tlv.p[1] + 2 * sizeof(unsigned int);
		if (tlv.length < len) {
			err = -ENOMEM;
			goto __kctl_end;
		}
		if (copy_to_user(_tlv->tlv, kctl->tlv.p, len))
			err = -EFAULT;
	}
1334
      __kctl_end:
1335 1336
	up_read(&card->controls_rwsem);
	return err;
1337 1338
}

L
Linus Torvalds 已提交
1339 1340
static long snd_ctl_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
{
1341 1342 1343
	struct snd_ctl_file *ctl;
	struct snd_card *card;
	struct snd_kctl_ioctl *p;
L
Linus Torvalds 已提交
1344 1345 1346 1347 1348 1349
	void __user *argp = (void __user *)arg;
	int __user *ip = argp;
	int err;

	ctl = file->private_data;
	card = ctl->card;
1350 1351
	if (snd_BUG_ON(!card))
		return -ENXIO;
L
Linus Torvalds 已提交
1352 1353 1354 1355 1356 1357
	switch (cmd) {
	case SNDRV_CTL_IOCTL_PVERSION:
		return put_user(SNDRV_CTL_VERSION, ip) ? -EFAULT : 0;
	case SNDRV_CTL_IOCTL_CARD_INFO:
		return snd_ctl_card_info(card, ctl, cmd, argp);
	case SNDRV_CTL_IOCTL_ELEM_LIST:
1358
		return snd_ctl_elem_list(card, argp);
L
Linus Torvalds 已提交
1359 1360 1361
	case SNDRV_CTL_IOCTL_ELEM_INFO:
		return snd_ctl_elem_info_user(ctl, argp);
	case SNDRV_CTL_IOCTL_ELEM_READ:
1362
		return snd_ctl_elem_read_user(card, argp);
L
Linus Torvalds 已提交
1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376
	case SNDRV_CTL_IOCTL_ELEM_WRITE:
		return snd_ctl_elem_write_user(ctl, argp);
	case SNDRV_CTL_IOCTL_ELEM_LOCK:
		return snd_ctl_elem_lock(ctl, argp);
	case SNDRV_CTL_IOCTL_ELEM_UNLOCK:
		return snd_ctl_elem_unlock(ctl, argp);
	case SNDRV_CTL_IOCTL_ELEM_ADD:
		return snd_ctl_elem_add_user(ctl, argp, 0);
	case SNDRV_CTL_IOCTL_ELEM_REPLACE:
		return snd_ctl_elem_add_user(ctl, argp, 1);
	case SNDRV_CTL_IOCTL_ELEM_REMOVE:
		return snd_ctl_elem_remove(ctl, argp);
	case SNDRV_CTL_IOCTL_SUBSCRIBE_EVENTS:
		return snd_ctl_subscribe_events(ctl, ip);
1377 1378 1379 1380 1381 1382
	case SNDRV_CTL_IOCTL_TLV_READ:
		return snd_ctl_tlv_ioctl(ctl, argp, 0);
	case SNDRV_CTL_IOCTL_TLV_WRITE:
		return snd_ctl_tlv_ioctl(ctl, argp, 1);
	case SNDRV_CTL_IOCTL_TLV_COMMAND:
		return snd_ctl_tlv_ioctl(ctl, argp, -1);
L
Linus Torvalds 已提交
1383
	case SNDRV_CTL_IOCTL_POWER:
T
Takashi Iwai 已提交
1384
		return -ENOPROTOOPT;
L
Linus Torvalds 已提交
1385 1386 1387 1388 1389 1390 1391 1392
	case SNDRV_CTL_IOCTL_POWER_STATE:
#ifdef CONFIG_PM
		return put_user(card->power_state, ip) ? -EFAULT : 0;
#else
		return put_user(SNDRV_CTL_POWER_D0, ip) ? -EFAULT : 0;
#endif
	}
	down_read(&snd_ioctl_rwsem);
1393
	list_for_each_entry(p, &snd_control_ioctls, list) {
L
Linus Torvalds 已提交
1394 1395 1396 1397 1398 1399 1400
		err = p->fioctl(card, ctl, cmd, arg);
		if (err != -ENOIOCTLCMD) {
			up_read(&snd_ioctl_rwsem);
			return err;
		}
	}
	up_read(&snd_ioctl_rwsem);
T
Takashi Iwai 已提交
1401
	snd_printdd("unknown ioctl = 0x%x\n", cmd);
L
Linus Torvalds 已提交
1402 1403 1404
	return -ENOTTY;
}

1405 1406
static ssize_t snd_ctl_read(struct file *file, char __user *buffer,
			    size_t count, loff_t * offset)
L
Linus Torvalds 已提交
1407
{
1408
	struct snd_ctl_file *ctl;
L
Linus Torvalds 已提交
1409 1410 1411 1412
	int err = 0;
	ssize_t result = 0;

	ctl = file->private_data;
1413 1414
	if (snd_BUG_ON(!ctl || !ctl->card))
		return -ENXIO;
L
Linus Torvalds 已提交
1415 1416
	if (!ctl->subscribed)
		return -EBADFD;
1417
	if (count < sizeof(struct snd_ctl_event))
L
Linus Torvalds 已提交
1418 1419
		return -EINVAL;
	spin_lock_irq(&ctl->read_lock);
1420 1421 1422
	while (count >= sizeof(struct snd_ctl_event)) {
		struct snd_ctl_event ev;
		struct snd_kctl_event *kev;
L
Linus Torvalds 已提交
1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435
		while (list_empty(&ctl->events)) {
			wait_queue_t wait;
			if ((file->f_flags & O_NONBLOCK) != 0 || result > 0) {
				err = -EAGAIN;
				goto __end_lock;
			}
			init_waitqueue_entry(&wait, current);
			add_wait_queue(&ctl->change_sleep, &wait);
			set_current_state(TASK_INTERRUPTIBLE);
			spin_unlock_irq(&ctl->read_lock);
			schedule();
			remove_wait_queue(&ctl->change_sleep, &wait);
			if (signal_pending(current))
1436
				return -ERESTARTSYS;
L
Linus Torvalds 已提交
1437 1438 1439 1440 1441 1442 1443 1444 1445
			spin_lock_irq(&ctl->read_lock);
		}
		kev = snd_kctl_event(ctl->events.next);
		ev.type = SNDRV_CTL_EVENT_ELEM;
		ev.data.elem.mask = kev->mask;
		ev.data.elem.id = kev->id;
		list_del(&kev->list);
		spin_unlock_irq(&ctl->read_lock);
		kfree(kev);
1446
		if (copy_to_user(buffer, &ev, sizeof(struct snd_ctl_event))) {
L
Linus Torvalds 已提交
1447 1448 1449 1450
			err = -EFAULT;
			goto __end;
		}
		spin_lock_irq(&ctl->read_lock);
1451 1452 1453
		buffer += sizeof(struct snd_ctl_event);
		count -= sizeof(struct snd_ctl_event);
		result += sizeof(struct snd_ctl_event);
L
Linus Torvalds 已提交
1454 1455 1456 1457 1458 1459 1460 1461 1462 1463
	}
      __end_lock:
	spin_unlock_irq(&ctl->read_lock);
      __end:
      	return result > 0 ? result : err;
}

static unsigned int snd_ctl_poll(struct file *file, poll_table * wait)
{
	unsigned int mask;
1464
	struct snd_ctl_file *ctl;
L
Linus Torvalds 已提交
1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483

	ctl = file->private_data;
	if (!ctl->subscribed)
		return 0;
	poll_wait(file, &ctl->change_sleep, wait);

	mask = 0;
	if (!list_empty(&ctl->events))
		mask |= POLLIN | POLLRDNORM;

	return mask;
}

/*
 * register the device-specific control-ioctls.
 * called from each device manager like pcm.c, hwdep.c, etc.
 */
static int _snd_ctl_register_ioctl(snd_kctl_ioctl_func_t fcn, struct list_head *lists)
{
1484
	struct snd_kctl_ioctl *pn;
L
Linus Torvalds 已提交
1485

1486
	pn = kzalloc(sizeof(struct snd_kctl_ioctl), GFP_KERNEL);
L
Linus Torvalds 已提交
1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500
	if (pn == NULL)
		return -ENOMEM;
	pn->fioctl = fcn;
	down_write(&snd_ioctl_rwsem);
	list_add_tail(&pn->list, lists);
	up_write(&snd_ioctl_rwsem);
	return 0;
}

int snd_ctl_register_ioctl(snd_kctl_ioctl_func_t fcn)
{
	return _snd_ctl_register_ioctl(fcn, &snd_control_ioctls);
}

1501 1502
EXPORT_SYMBOL(snd_ctl_register_ioctl);

L
Linus Torvalds 已提交
1503 1504 1505 1506 1507
#ifdef CONFIG_COMPAT
int snd_ctl_register_ioctl_compat(snd_kctl_ioctl_func_t fcn)
{
	return _snd_ctl_register_ioctl(fcn, &snd_control_compat_ioctls);
}
1508 1509

EXPORT_SYMBOL(snd_ctl_register_ioctl_compat);
L
Linus Torvalds 已提交
1510 1511 1512 1513 1514
#endif

/*
 * de-register the device-specific control-ioctls.
 */
1515 1516
static int _snd_ctl_unregister_ioctl(snd_kctl_ioctl_func_t fcn,
				     struct list_head *lists)
L
Linus Torvalds 已提交
1517
{
1518
	struct snd_kctl_ioctl *p;
L
Linus Torvalds 已提交
1519

1520 1521
	if (snd_BUG_ON(!fcn))
		return -EINVAL;
L
Linus Torvalds 已提交
1522
	down_write(&snd_ioctl_rwsem);
1523
	list_for_each_entry(p, lists, list) {
L
Linus Torvalds 已提交
1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540
		if (p->fioctl == fcn) {
			list_del(&p->list);
			up_write(&snd_ioctl_rwsem);
			kfree(p);
			return 0;
		}
	}
	up_write(&snd_ioctl_rwsem);
	snd_BUG();
	return -EINVAL;
}

int snd_ctl_unregister_ioctl(snd_kctl_ioctl_func_t fcn)
{
	return _snd_ctl_unregister_ioctl(fcn, &snd_control_ioctls);
}

1541 1542
EXPORT_SYMBOL(snd_ctl_unregister_ioctl);

L
Linus Torvalds 已提交
1543 1544 1545 1546 1547 1548
#ifdef CONFIG_COMPAT
int snd_ctl_unregister_ioctl_compat(snd_kctl_ioctl_func_t fcn)
{
	return _snd_ctl_unregister_ioctl(fcn, &snd_control_compat_ioctls);
}

1549
EXPORT_SYMBOL(snd_ctl_unregister_ioctl_compat);
L
Linus Torvalds 已提交
1550 1551 1552 1553
#endif

static int snd_ctl_fasync(int fd, struct file * file, int on)
{
1554
	struct snd_ctl_file *ctl;
1555

L
Linus Torvalds 已提交
1556
	ctl = file->private_data;
1557
	return fasync_helper(fd, file, on, &ctl->fasync);
L
Linus Torvalds 已提交
1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572
}

/*
 * ioctl32 compat
 */
#ifdef CONFIG_COMPAT
#include "control_compat.c"
#else
#define snd_ctl_ioctl_compat	NULL
#endif

/*
 *  INIT PART
 */

1573
static const struct file_operations snd_ctl_f_ops =
L
Linus Torvalds 已提交
1574 1575 1576 1577 1578
{
	.owner =	THIS_MODULE,
	.read =		snd_ctl_read,
	.open =		snd_ctl_open,
	.release =	snd_ctl_release,
T
Takashi Iwai 已提交
1579
	.llseek =	no_llseek,
L
Linus Torvalds 已提交
1580 1581 1582 1583 1584 1585 1586 1587 1588
	.poll =		snd_ctl_poll,
	.unlocked_ioctl =	snd_ctl_ioctl,
	.compat_ioctl =	snd_ctl_ioctl_compat,
	.fasync =	snd_ctl_fasync,
};

/*
 * registration of the control device
 */
1589
static int snd_ctl_dev_register(struct snd_device *device)
L
Linus Torvalds 已提交
1590
{
1591
	struct snd_card *card = device->device_data;
L
Linus Torvalds 已提交
1592 1593 1594
	int err, cardnum;
	char name[16];

1595 1596
	if (snd_BUG_ON(!card))
		return -ENXIO;
L
Linus Torvalds 已提交
1597
	cardnum = card->number;
1598 1599
	if (snd_BUG_ON(cardnum < 0 || cardnum >= SNDRV_CARDS))
		return -ENXIO;
L
Linus Torvalds 已提交
1600
	sprintf(name, "controlC%i", cardnum);
1601 1602
	if ((err = snd_register_device(SNDRV_DEVICE_TYPE_CONTROL, card, -1,
				       &snd_ctl_f_ops, card, name)) < 0)
L
Linus Torvalds 已提交
1603 1604 1605 1606 1607 1608 1609
		return err;
	return 0;
}

/*
 * disconnection of the control device
 */
1610
static int snd_ctl_dev_disconnect(struct snd_device *device)
L
Linus Torvalds 已提交
1611
{
1612 1613
	struct snd_card *card = device->device_data;
	struct snd_ctl_file *ctl;
1614 1615
	int err, cardnum;

1616 1617
	if (snd_BUG_ON(!card))
		return -ENXIO;
1618
	cardnum = card->number;
1619 1620
	if (snd_BUG_ON(cardnum < 0 || cardnum >= SNDRV_CARDS))
		return -ENXIO;
L
Linus Torvalds 已提交
1621

1622
	read_lock(&card->ctl_files_rwlock);
1623
	list_for_each_entry(ctl, &card->ctl_files, list) {
L
Linus Torvalds 已提交
1624 1625 1626
		wake_up(&ctl->change_sleep);
		kill_fasync(&ctl->fasync, SIGIO, POLL_ERR);
	}
1627
	read_unlock(&card->ctl_files_rwlock);
1628 1629 1630 1631

	if ((err = snd_unregister_device(SNDRV_DEVICE_TYPE_CONTROL,
					 card, -1)) < 0)
		return err;
L
Linus Torvalds 已提交
1632 1633 1634 1635 1636 1637
	return 0;
}

/*
 * free all controls
 */
1638
static int snd_ctl_dev_free(struct snd_device *device)
L
Linus Torvalds 已提交
1639
{
1640 1641
	struct snd_card *card = device->device_data;
	struct snd_kcontrol *control;
L
Linus Torvalds 已提交
1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655

	down_write(&card->controls_rwsem);
	while (!list_empty(&card->controls)) {
		control = snd_kcontrol(card->controls.next);
		snd_ctl_remove(card, control);
	}
	up_write(&card->controls_rwsem);
	return 0;
}

/*
 * create control core:
 * called from init.c
 */
1656
int snd_ctl_create(struct snd_card *card)
L
Linus Torvalds 已提交
1657
{
1658
	static struct snd_device_ops ops = {
L
Linus Torvalds 已提交
1659 1660 1661 1662 1663
		.dev_free = snd_ctl_dev_free,
		.dev_register =	snd_ctl_dev_register,
		.dev_disconnect = snd_ctl_dev_disconnect,
	};

1664 1665
	if (snd_BUG_ON(!card))
		return -ENXIO;
L
Linus Torvalds 已提交
1666 1667
	return snd_device_new(card, SNDRV_DEV_CONTROL, card, &ops);
}
1668 1669

/*
1670
 * Frequently used control callbacks/helpers
1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694
 */
int snd_ctl_boolean_mono_info(struct snd_kcontrol *kcontrol,
			      struct snd_ctl_elem_info *uinfo)
{
	uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
	uinfo->count = 1;
	uinfo->value.integer.min = 0;
	uinfo->value.integer.max = 1;
	return 0;
}

EXPORT_SYMBOL(snd_ctl_boolean_mono_info);

int snd_ctl_boolean_stereo_info(struct snd_kcontrol *kcontrol,
				struct snd_ctl_elem_info *uinfo)
{
	uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
	uinfo->count = 2;
	uinfo->value.integer.min = 0;
	uinfo->value.integer.max = 1;
	return 0;
}

EXPORT_SYMBOL(snd_ctl_boolean_stereo_info);
1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720

/**
 * snd_ctl_enum_info - fills the info structure for an enumerated control
 * @info: the structure to be filled
 * @channels: the number of the control's channels; often one
 * @items: the number of control values; also the size of @names
 * @names: an array containing the names of all control values
 *
 * Sets all required fields in @info to their appropriate values.
 * If the control's accessibility is not the default (readable and writable),
 * the caller has to fill @info->access.
 */
int snd_ctl_enum_info(struct snd_ctl_elem_info *info, unsigned int channels,
		      unsigned int items, const char *const names[])
{
	info->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
	info->count = channels;
	info->value.enumerated.items = items;
	if (info->value.enumerated.item >= items)
		info->value.enumerated.item = items - 1;
	strlcpy(info->value.enumerated.name,
		names[info->value.enumerated.item],
		sizeof(info->value.enumerated.name));
	return 0;
}
EXPORT_SYMBOL(snd_ctl_enum_info);