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
 *
 *
 *   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>
24
#include <linux/module.h>
L
Linus Torvalds 已提交
25 26 27 28 29 30 31 32 33 34
#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
35
#define MAX_CONTROL_COUNT	1028
L
Linus Torvalds 已提交
36

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

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;
51 52
	struct snd_card *card;
	struct snd_ctl_file *ctl;
L
Linus Torvalds 已提交
53 54
	int err;

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

59
	card = snd_lookup_minor_data(iminor(inode), SNDRV_DEVICE_TYPE_CONTROL);
L
Linus Torvalds 已提交
60 61 62 63 64 65 66 67 68 69 70 71 72
	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;
	}
73
	ctl = kzalloc(sizeof(*ctl), GFP_KERNEL);
L
Linus Torvalds 已提交
74 75 76 77 78 79 80 81
	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;
82 83
	ctl->prefer_pcm_subdevice = -1;
	ctl->prefer_rawmidi_subdevice = -1;
84
	ctl->pid = get_pid(task_pid(current));
L
Linus Torvalds 已提交
85 86 87 88 89 90 91 92 93 94 95 96 97 98
	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;
}

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

static int snd_ctl_release(struct inode *inode, struct file *file)
{
	unsigned long flags;
116 117 118
	struct snd_card *card;
	struct snd_ctl_file *ctl;
	struct snd_kcontrol *control;
L
Linus Torvalds 已提交
119 120 121 122 123 124 125 126 127
	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);
128
	list_for_each_entry(control, &card->controls, list)
L
Linus Torvalds 已提交
129 130 131 132 133
		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);
134
	put_pid(ctl->pid);
L
Linus Torvalds 已提交
135 136 137 138 139 140
	kfree(ctl);
	module_put(card->module);
	snd_card_file_remove(card, file);
	return 0;
}

141 142
void snd_ctl_notify(struct snd_card *card, unsigned int mask,
		    struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
143 144
{
	unsigned long flags;
145 146
	struct snd_ctl_file *ctl;
	struct snd_kctl_event *ev;
L
Linus Torvalds 已提交
147
	
148 149
	if (snd_BUG_ON(!card || !id))
		return;
L
Linus Torvalds 已提交
150 151 152 153
	read_lock(&card->ctl_files_rwlock);
#if defined(CONFIG_SND_MIXER_OSS) || defined(CONFIG_SND_MIXER_OSS_MODULE)
	card->mixer_oss_change_count++;
#endif
154
	list_for_each_entry(ctl, &card->ctl_files, list) {
L
Linus Torvalds 已提交
155 156 157
		if (!ctl->subscribed)
			continue;
		spin_lock_irqsave(&ctl->read_lock, flags);
158
		list_for_each_entry(ev, &ctl->events, list) {
L
Linus Torvalds 已提交
159 160 161 162 163
			if (ev->id.numid == id->numid) {
				ev->mask |= mask;
				goto _found;
			}
		}
164
		ev = kzalloc(sizeof(*ev), GFP_ATOMIC);
L
Linus Torvalds 已提交
165 166 167 168 169 170 171 172 173 174 175 176 177 178 179
		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);
}

180 181
EXPORT_SYMBOL(snd_ctl_notify);

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

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

204
	kctl = kzalloc(sizeof(*kctl) + sizeof(struct snd_kcontrol_volatile) * control->count, GFP_KERNEL);
T
Takashi Iwai 已提交
205 206
	if (kctl == NULL) {
		snd_printk(KERN_ERR "Cannot allocate control instance\n");
L
Linus Torvalds 已提交
207
		return NULL;
T
Takashi Iwai 已提交
208
	}
L
Linus Torvalds 已提交
209 210 211 212 213 214 215 216 217 218 219
	*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
 *
220
 * Allocates a new struct snd_kcontrol instance and initialize from the given 
L
Linus Torvalds 已提交
221 222 223 224 225
 * 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.
 */
226 227
struct snd_kcontrol *snd_ctl_new1(const struct snd_kcontrol_new *ncontrol,
				  void *private_data)
L
Linus Torvalds 已提交
228
{
229
	struct snd_kcontrol kctl;
L
Linus Torvalds 已提交
230 231
	unsigned int access;
	
232 233
	if (snd_BUG_ON(!ncontrol || !ncontrol->info))
		return NULL;
L
Linus Torvalds 已提交
234 235 236 237
	memset(&kctl, 0, sizeof(kctl));
	kctl.id.iface = ncontrol->iface;
	kctl.id.device = ncontrol->device;
	kctl.id.subdevice = ncontrol->subdevice;
238
	if (ncontrol->name) {
L
Linus Torvalds 已提交
239
		strlcpy(kctl.id.name, ncontrol->name, sizeof(kctl.id.name));
240 241 242 243 244
		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 已提交
245 246 247
	kctl.id.index = ncontrol->index;
	kctl.count = ncontrol->count ? ncontrol->count : 1;
	access = ncontrol->access == 0 ? SNDRV_CTL_ELEM_ACCESS_READWRITE :
248 249
		 (ncontrol->access & (SNDRV_CTL_ELEM_ACCESS_READWRITE|
				      SNDRV_CTL_ELEM_ACCESS_INACTIVE|
250 251 252
				      SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE|
				      SNDRV_CTL_ELEM_ACCESS_TLV_COMMAND|
				      SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK));
L
Linus Torvalds 已提交
253 254 255
	kctl.info = ncontrol->info;
	kctl.get = ncontrol->get;
	kctl.put = ncontrol->put;
256
	kctl.tlv.p = ncontrol->tlv.p;
L
Linus Torvalds 已提交
257 258 259 260 261
	kctl.private_value = ncontrol->private_value;
	kctl.private_data = private_data;
	return snd_ctl_new(&kctl, access);
}

262 263
EXPORT_SYMBOL(snd_ctl_new1);

L
Linus Torvalds 已提交
264 265 266 267 268 269 270 271
/**
 * 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.
 */
272
void snd_ctl_free_one(struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
273 274 275 276 277 278 279 280
{
	if (kcontrol) {
		if (kcontrol->private_free)
			kcontrol->private_free(kcontrol);
		kfree(kcontrol);
	}
}

281 282
EXPORT_SYMBOL(snd_ctl_free_one);

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

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

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

302
	while (snd_ctl_remove_numid_conflict(card, count)) {
L
Linus Torvalds 已提交
303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
		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.
 */
325
int snd_ctl_add(struct snd_card *card, struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
326
{
327
	struct snd_ctl_elem_id id;
L
Linus Torvalds 已提交
328
	unsigned int idx;
329
	int err = -EINVAL;
L
Linus Torvalds 已提交
330

T
Takashi Iwai 已提交
331
	if (! kcontrol)
332
		return err;
333 334
	if (snd_BUG_ON(!card || !kcontrol->info))
		goto error;
L
Linus Torvalds 已提交
335 336 337 338 339 340 341 342 343 344
	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);
345 346
		err = -EBUSY;
		goto error;
L
Linus Torvalds 已提交
347 348 349
	}
	if (snd_ctl_find_hole(card, kcontrol->count) < 0) {
		up_write(&card->controls_rwsem);
350 351
		err = -ENOMEM;
		goto error;
L
Linus Torvalds 已提交
352 353 354 355 356 357 358 359 360
	}
	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;
361 362 363 364

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

367 368
EXPORT_SYMBOL(snd_ctl_add);

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 432
/**
 * 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 已提交
433 434 435 436 437 438 439 440 441 442 443
/**
 * 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.
 */
444
int snd_ctl_remove(struct snd_card *card, struct snd_kcontrol *kcontrol)
L
Linus Torvalds 已提交
445
{
446
	struct snd_ctl_elem_id id;
L
Linus Torvalds 已提交
447 448
	unsigned int idx;

449 450
	if (snd_BUG_ON(!card || !kcontrol))
		return -EINVAL;
L
Linus Torvalds 已提交
451 452 453 454 455 456 457 458 459
	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;
}

460 461
EXPORT_SYMBOL(snd_ctl_remove);

L
Linus Torvalds 已提交
462 463 464 465 466 467 468 469 470 471
/**
 * 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.
 */
472
int snd_ctl_remove_id(struct snd_card *card, struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
473
{
474
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
475 476 477 478 479 480 481 482 483 484 485 486 487
	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;
}

488 489
EXPORT_SYMBOL(snd_ctl_remove_id);

L
Linus Torvalds 已提交
490
/**
491
 * snd_ctl_remove_user_ctl - remove and release the unlocked user control
L
Linus Torvalds 已提交
492 493 494 495 496 497 498 499
 * @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.
 */
500 501
static int snd_ctl_remove_user_ctl(struct snd_ctl_file * file,
				   struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
502
{
503 504
	struct snd_card *card = file->card;
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
505 506 507 508 509
	int idx, ret;

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

T
Takashi Iwai 已提交
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 576
/**
 * 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 已提交
577 578 579 580 581 582 583 584 585 586 587
/**
 * 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.
 */
588 589
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 已提交
590
{
591
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
592 593 594 595 596 597 598 599 600 601 602 603 604 605

	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;
}

606 607
EXPORT_SYMBOL(snd_ctl_rename_id);

L
Linus Torvalds 已提交
608 609 610 611 612 613 614 615 616 617 618 619
/**
 * 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).
 */
620
struct snd_kcontrol *snd_ctl_find_numid(struct snd_card *card, unsigned int numid)
L
Linus Torvalds 已提交
621
{
622
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
623

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

633 634
EXPORT_SYMBOL(snd_ctl_find_numid);

L
Linus Torvalds 已提交
635 636 637 638 639 640 641 642 643 644 645 646
/**
 * 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).
 */
647 648
struct snd_kcontrol *snd_ctl_find_id(struct snd_card *card,
				     struct snd_ctl_elem_id *id)
L
Linus Torvalds 已提交
649
{
650
	struct snd_kcontrol *kctl;
L
Linus Torvalds 已提交
651

652 653
	if (snd_BUG_ON(!card || !id))
		return NULL;
L
Linus Torvalds 已提交
654 655
	if (id->numid != 0)
		return snd_ctl_find_numid(card, id->numid);
656
	list_for_each_entry(kctl, &card->controls, list) {
L
Linus Torvalds 已提交
657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673
		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;
}

674 675
EXPORT_SYMBOL(snd_ctl_find_id);

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

681
	info = kzalloc(sizeof(*info), GFP_KERNEL);
L
Linus Torvalds 已提交
682 683 684 685 686 687 688 689 690 691 692
	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);
693
	if (copy_to_user(arg, info, sizeof(struct snd_ctl_card_info))) {
L
Linus Torvalds 已提交
694 695 696 697 698 699 700
		kfree(info);
		return -EFAULT;
	}
	kfree(info);
	return 0;
}

701 702
static int snd_ctl_elem_list(struct snd_card *card,
			     struct snd_ctl_elem_list __user *_list)
L
Linus Torvalds 已提交
703 704
{
	struct list_head *plist;
705 706 707
	struct snd_ctl_elem_list list;
	struct snd_kcontrol *kctl;
	struct snd_ctl_elem_id *dst, *id;
708
	unsigned int offset, space, jidx;
L
Linus Torvalds 已提交
709 710 711 712 713 714 715 716 717 718
	
	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 */
719
		dst = vmalloc(space * sizeof(struct snd_ctl_elem_id));
L
Linus Torvalds 已提交
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 747
		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);
748 749 750
		if (list.used > 0 &&
		    copy_to_user(list.pids, dst,
				 list.used * sizeof(struct snd_ctl_elem_id))) {
L
Linus Torvalds 已提交
751 752 753 754 755 756 757 758 759 760 761 762 763 764
			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;
}

765 766
static int snd_ctl_elem_info(struct snd_ctl_file *ctl,
			     struct snd_ctl_elem_info *info)
L
Linus Torvalds 已提交
767
{
768 769 770
	struct snd_card *card = ctl->card;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
771 772 773 774 775 776 777 778 779 780 781 782 783 784
	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) {
785
		snd_BUG_ON(info->access);
L
Linus Torvalds 已提交
786 787 788 789 790 791 792 793
		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;
794
			info->owner = pid_vnr(vd->owner->pid);
L
Linus Torvalds 已提交
795 796 797 798 799 800 801 802
		} else {
			info->owner = -1;
		}
	}
	up_read(&card->controls_rwsem);
	return result;
}

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

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

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

	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];
837 838 839 840 841 842
		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 已提交
843 844 845 846 847
	}
	up_read(&card->controls_rwsem);
	return result;
}

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

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

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

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

	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];
885 886 887 888
		if (!(vd->access & SNDRV_CTL_ELEM_ACCESS_WRITE) ||
		    kctl->put == NULL ||
		    (file && vd->owner && vd->owner != file)) {
			result = -EPERM;
L
Linus Torvalds 已提交
889
		} else {
890 891 892 893 894 895 896 897
			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 已提交
898 899 900 901 902 903
		}
	}
	up_read(&card->controls_rwsem);
	return result;
}

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

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

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

928 929
static int snd_ctl_elem_lock(struct snd_ctl_file *file,
			     struct snd_ctl_elem_id __user *_id)
L
Linus Torvalds 已提交
930
{
931 932 933 934
	struct snd_card *card = file->card;
	struct snd_ctl_elem_id id;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955
	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;
}

956 957
static int snd_ctl_elem_unlock(struct snd_ctl_file *file,
			       struct snd_ctl_elem_id __user *_id)
L
Linus Torvalds 已提交
958
{
959 960 961 962
	struct snd_card *card = file->card;
	struct snd_ctl_elem_id id;
	struct snd_kcontrol *kctl;
	struct snd_kcontrol_volatile *vd;
L
Linus Torvalds 已提交
963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986
	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 {
987
	struct snd_ctl_elem_info info;
L
Linus Torvalds 已提交
988 989
	void *elem_data;		/* element data */
	unsigned long elem_data_size;	/* size of element data in bytes */
990 991
	void *tlv_data;			/* TLV data */
	unsigned long tlv_data_size;	/* TLV data size */
L
Linus Torvalds 已提交
992 993 994
	void *priv_data;		/* private data (like strings for enumerated type) */
};

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

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

1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025
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;
}

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

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

1035 1036
static int snd_ctl_elem_user_put(struct snd_kcontrol *kcontrol,
				 struct snd_ctl_elem_value *ucontrol)
L
Linus Torvalds 已提交
1037 1038 1039 1040 1041 1042 1043 1044 1045 1046
{
	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;
}

1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058
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 已提交
1059 1060 1061 1062

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

1080 1081 1082 1083 1084
static int snd_ctl_elem_init_enum_names(struct user_element *ue)
{
	char *names, *p;
	size_t buf_len, name_len;
	unsigned int i;
1085
	const uintptr_t user_ptrval = ue->info.value.enumerated.names_ptr;
1086 1087 1088 1089

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

1090
	names = memdup_user((const void __user *)user_ptrval,
1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113
		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;
}

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

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

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

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

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

	return 0;
}

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

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

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

1258
static int snd_ctl_subscribe_events(struct snd_ctl_file *file, int __user *ptr)
L
Linus Torvalds 已提交
1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278
{
	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;
}

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

	if (copy_from_user(&tlv, _tlv, sizeof(tlv)))
		return -EFAULT;
1292
	if (tlv.length < sizeof(unsigned int) * 2)
1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311
		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) {
1312
		if (vd->owner != NULL && vd->owner != file) {
1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334
			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;
	}
1335
      __kctl_end:
1336 1337
	up_read(&card->controls_rwsem);
	return err;
1338 1339
}

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

	ctl = file->private_data;
	card = ctl->card;
1351 1352
	if (snd_BUG_ON(!card))
		return -ENXIO;
L
Linus Torvalds 已提交
1353 1354 1355 1356 1357 1358
	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:
1359
		return snd_ctl_elem_list(card, argp);
L
Linus Torvalds 已提交
1360 1361 1362
	case SNDRV_CTL_IOCTL_ELEM_INFO:
		return snd_ctl_elem_info_user(ctl, argp);
	case SNDRV_CTL_IOCTL_ELEM_READ:
1363
		return snd_ctl_elem_read_user(card, argp);
L
Linus Torvalds 已提交
1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377
	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);
1378 1379 1380 1381 1382 1383
	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 已提交
1384
	case SNDRV_CTL_IOCTL_POWER:
T
Takashi Iwai 已提交
1385
		return -ENOPROTOOPT;
L
Linus Torvalds 已提交
1386 1387 1388 1389 1390 1391 1392 1393
	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);
1394
	list_for_each_entry(p, &snd_control_ioctls, list) {
L
Linus Torvalds 已提交
1395 1396 1397 1398 1399 1400 1401
		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 已提交
1402
	snd_printdd("unknown ioctl = 0x%x\n", cmd);
L
Linus Torvalds 已提交
1403 1404 1405
	return -ENOTTY;
}

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

	ctl = file->private_data;
1414 1415
	if (snd_BUG_ON(!ctl || !ctl->card))
		return -ENXIO;
L
Linus Torvalds 已提交
1416 1417
	if (!ctl->subscribed)
		return -EBADFD;
1418
	if (count < sizeof(struct snd_ctl_event))
L
Linus Torvalds 已提交
1419 1420
		return -EINVAL;
	spin_lock_irq(&ctl->read_lock);
1421 1422 1423
	while (count >= sizeof(struct snd_ctl_event)) {
		struct snd_ctl_event ev;
		struct snd_kctl_event *kev;
L
Linus Torvalds 已提交
1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436
		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))
1437
				return -ERESTARTSYS;
L
Linus Torvalds 已提交
1438 1439 1440 1441 1442 1443 1444 1445 1446
			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);
1447
		if (copy_to_user(buffer, &ev, sizeof(struct snd_ctl_event))) {
L
Linus Torvalds 已提交
1448 1449 1450 1451
			err = -EFAULT;
			goto __end;
		}
		spin_lock_irq(&ctl->read_lock);
1452 1453 1454
		buffer += sizeof(struct snd_ctl_event);
		count -= sizeof(struct snd_ctl_event);
		result += sizeof(struct snd_ctl_event);
L
Linus Torvalds 已提交
1455 1456 1457 1458 1459 1460 1461 1462 1463 1464
	}
      __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;
1465
	struct snd_ctl_file *ctl;
L
Linus Torvalds 已提交
1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484

	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)
{
1485
	struct snd_kctl_ioctl *pn;
L
Linus Torvalds 已提交
1486

1487
	pn = kzalloc(sizeof(struct snd_kctl_ioctl), GFP_KERNEL);
L
Linus Torvalds 已提交
1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501
	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);
}

1502 1503
EXPORT_SYMBOL(snd_ctl_register_ioctl);

L
Linus Torvalds 已提交
1504 1505 1506 1507 1508
#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);
}
1509 1510

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

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

1521 1522
	if (snd_BUG_ON(!fcn))
		return -EINVAL;
L
Linus Torvalds 已提交
1523
	down_write(&snd_ioctl_rwsem);
1524
	list_for_each_entry(p, lists, list) {
L
Linus Torvalds 已提交
1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541
		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);
}

1542 1543
EXPORT_SYMBOL(snd_ctl_unregister_ioctl);

L
Linus Torvalds 已提交
1544 1545 1546 1547 1548 1549
#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);
}

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

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

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

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

/*
 *  INIT PART
 */

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

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

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

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

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

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

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

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

	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
 */
1657
int snd_ctl_create(struct snd_card *card)
L
Linus Torvalds 已提交
1658
{
1659
	static struct snd_device_ops ops = {
L
Linus Torvalds 已提交
1660 1661 1662 1663 1664
		.dev_free = snd_ctl_dev_free,
		.dev_register =	snd_ctl_dev_register,
		.dev_disconnect = snd_ctl_dev_disconnect,
	};

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

/*
1671
 * Frequently used control callbacks/helpers
1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695
 */
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);
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 1721

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