1 // SPDX-License-Identifier: GPL-2.0-or-later
54 	struct snd_info_entry *entry;  member
59 static void snd_info_clear_entries(struct snd_info_entry *entry);
73 static int alloc_info_private(struct snd_info_entry *entry,  in alloc_info_private()  argument
78 	if (!entry || !entry->p)  in alloc_info_private()
79 		return -ENODEV;  in alloc_info_private()
80 	if (!try_module_get(entry->module))  in alloc_info_private()
81 		return -EFAULT;  in alloc_info_private()
84 		module_put(entry->module);  in alloc_info_private()
85 		return -ENOMEM;  in alloc_info_private()
87 	data->entry = entry;  in alloc_info_private()
107 	struct snd_info_entry *entry;  in snd_info_entry_llseek()  local
108 	loff_t ret = -EINVAL, size;  in snd_info_entry_llseek()
110 	data = file->private_data;  in snd_info_entry_llseek()
111 	entry = data->entry;  in snd_info_entry_llseek()
112 	mutex_lock(&entry->access);  in snd_info_entry_llseek()
113 	if (entry->c.ops->llseek) {  in snd_info_entry_llseek()
114 		ret = entry->c.ops->llseek(entry,  in snd_info_entry_llseek()
115 					   data->file_private_data,  in snd_info_entry_llseek()
120 	size = entry->size;  in snd_info_entry_llseek()
125 		offset += file->f_pos;  in snd_info_entry_llseek()
139 	file->f_pos = offset;  in snd_info_entry_llseek()
142 	mutex_unlock(&entry->access);  in snd_info_entry_llseek()
149 	struct snd_info_private_data *data = file->private_data;  in snd_info_entry_read()
150 	struct snd_info_entry *entry = data->entry;  in snd_info_entry_read()  local
156 		return -EIO;  in snd_info_entry_read()
157 	if (pos >= entry->size)  in snd_info_entry_read()
159 	size = entry->size - pos;  in snd_info_entry_read()
161 	size = entry->c.ops->read(entry, data->file_private_data,  in snd_info_entry_read()
171 	struct snd_info_private_data *data = file->private_data;  in snd_info_entry_write()
172 	struct snd_info_entry *entry = data->entry;  in snd_info_entry_write()  local
178 		return -EIO;  in snd_info_entry_write()
180 		size_t maxsize = entry->size - pos;  in snd_info_entry_write()
182 		size = entry->c.ops->write(entry, data->file_private_data,  in snd_info_entry_write()
192 	struct snd_info_private_data *data = file->private_data;  in snd_info_entry_poll()
193 	struct snd_info_entry *entry = data->entry;  in snd_info_entry_poll()  local
196 	if (entry->c.ops->poll)  in snd_info_entry_poll()
197 		return entry->c.ops->poll(entry,  in snd_info_entry_poll()
198 					  data->file_private_data,  in snd_info_entry_poll()
200 	if (entry->c.ops->read)  in snd_info_entry_poll()
202 	if (entry->c.ops->write)  in snd_info_entry_poll()
210 	struct snd_info_private_data *data = file->private_data;  in snd_info_entry_ioctl()
211 	struct snd_info_entry *entry = data->entry;  in snd_info_entry_ioctl()  local
213 	if (!entry->c.ops->ioctl)  in snd_info_entry_ioctl()
214 		return -ENOTTY;  in snd_info_entry_ioctl()
215 	return entry->c.ops->ioctl(entry, data->file_private_data,  in snd_info_entry_ioctl()
223 	struct snd_info_entry *entry;  in snd_info_entry_mmap()  local
225 	data = file->private_data;  in snd_info_entry_mmap()
228 	entry = data->entry;  in snd_info_entry_mmap()
229 	if (!entry->c.ops->mmap)  in snd_info_entry_mmap()
230 		return -ENXIO;  in snd_info_entry_mmap()
231 	return entry->c.ops->mmap(entry, data->file_private_data,  in snd_info_entry_mmap()
237 	struct snd_info_entry *entry = pde_data(inode);  in snd_info_entry_open()  local
242 	err = alloc_info_private(entry, &data);  in snd_info_entry_open()
246 	mode = file->f_flags & O_ACCMODE;  in snd_info_entry_open()
247 	if (((mode == O_RDONLY || mode == O_RDWR) && !entry->c.ops->read) ||  in snd_info_entry_open()
248 	    ((mode == O_WRONLY || mode == O_RDWR) && !entry->c.ops->write)) {  in snd_info_entry_open()
249 		err = -ENODEV;  in snd_info_entry_open()
253 	if (entry->c.ops->open) {  in snd_info_entry_open()
254 		err = entry->c.ops->open(entry, mode, &data->file_private_data);  in snd_info_entry_open()
259 	file->private_data = data;  in snd_info_entry_open()
265 	module_put(entry->module);  in snd_info_entry_open()
273 	struct snd_info_private_data *data = file->private_data;  in snd_info_entry_release()
274 	struct snd_info_entry *entry = data->entry;  in snd_info_entry_release()  local
276 	if (entry->c.ops->release)  in snd_info_entry_release()
277 		entry->c.ops->release(entry, file->f_flags & O_ACCMODE,  in snd_info_entry_release()
278 				      data->file_private_data);  in snd_info_entry_release()
279 	module_put(entry->module);  in snd_info_entry_release()
303 	struct seq_file *m = file->private_data;  in snd_info_text_entry_write()
304 	struct snd_info_private_data *data = m->private;  in snd_info_text_entry_write()
305 	struct snd_info_entry *entry = data->entry;  in snd_info_text_entry_write()  local
311 	if (!entry->c.text.write)  in snd_info_text_entry_write()
312 		return -EIO;  in snd_info_text_entry_write()
315 		return -EIO;  in snd_info_text_entry_write()
319 		return -EIO;  in snd_info_text_entry_write()
320 	mutex_lock(&entry->access);  in snd_info_text_entry_write()
321 	buf = data->wbuffer;  in snd_info_text_entry_write()
323 		data->wbuffer = buf = kzalloc(sizeof(*buf), GFP_KERNEL);  in snd_info_text_entry_write()
325 			err = -ENOMEM;  in snd_info_text_entry_write()
329 	if (next > buf->len) {  in snd_info_text_entry_write()
332 			err = -ENOMEM;  in snd_info_text_entry_write()
335 		kvfree(buf->buffer);  in snd_info_text_entry_write()
336 		buf->buffer = nbuf;  in snd_info_text_entry_write()
337 		buf->len = PAGE_ALIGN(next);  in snd_info_text_entry_write()
339 	if (copy_from_user(buf->buffer + pos, buffer, count)) {  in snd_info_text_entry_write()
340 		err = -EFAULT;  in snd_info_text_entry_write()
343 	buf->size = next;  in snd_info_text_entry_write()
345 	mutex_unlock(&entry->access);  in snd_info_text_entry_write()
354 	struct snd_info_private_data *data = seq->private;  in snd_info_seq_show()
355 	struct snd_info_entry *entry = data->entry;  in snd_info_seq_show()  local
357 	if (!entry->c.text.read) {  in snd_info_seq_show()
358 		return -EIO;  in snd_info_seq_show()
360 		data->rbuffer->buffer = (char *)seq; /* XXX hack! */  in snd_info_seq_show()
361 		entry->c.text.read(entry, data->rbuffer);  in snd_info_seq_show()
368 	struct snd_info_entry *entry = pde_data(inode);  in snd_info_text_entry_open()  local
373 	err = alloc_info_private(entry, &data);  in snd_info_text_entry_open()
377 	data->rbuffer = kzalloc(sizeof(*data->rbuffer), GFP_KERNEL);  in snd_info_text_entry_open()
378 	if (!data->rbuffer) {  in snd_info_text_entry_open()
379 		err = -ENOMEM;  in snd_info_text_entry_open()
382 	if (entry->size)  in snd_info_text_entry_open()
384 				       entry->size);  in snd_info_text_entry_open()
393 	kfree(data->rbuffer);  in snd_info_text_entry_open()
395 	module_put(entry->module);  in snd_info_text_entry_open()
403 	struct seq_file *m = file->private_data;  in snd_info_text_entry_release()
404 	struct snd_info_private_data *data = m->private;  in snd_info_text_entry_release()
405 	struct snd_info_entry *entry = data->entry;  in snd_info_text_entry_release()  local
407 	if (data->wbuffer && entry->c.text.write)  in snd_info_text_entry_release()
408 		entry->c.text.write(entry, data->wbuffer);  in snd_info_text_entry_release()
411 	kfree(data->rbuffer);  in snd_info_text_entry_release()
412 	if (data->wbuffer) {  in snd_info_text_entry_release()
413 		kvfree(data->wbuffer->buffer);  in snd_info_text_entry_release()
414 		kfree(data->wbuffer);  in snd_info_text_entry_release()
417 	module_put(entry->module);  in snd_info_text_entry_release()
432 					    const char *name)  in create_subdir()  argument
434 	struct snd_info_entry *entry;  in create_subdir()  local
436 	entry = snd_info_create_module_entry(mod, name, NULL);  in create_subdir()
437 	if (!entry)  in create_subdir()
439 	entry->mode = S_IFDIR | 0555;  in create_subdir()
440 	if (snd_info_register(entry) < 0) {  in create_subdir()
441 		snd_info_free_entry(entry);  in create_subdir()
444 	return entry;  in create_subdir()
448 snd_info_create_entry(const char *name, struct snd_info_entry *parent,
455 		return -ENOMEM;  in snd_info_init()
456 	snd_proc_root->mode = S_IFDIR | 0555;  in snd_info_init()
457 	snd_proc_root->p = proc_mkdir("asound", NULL);  in snd_info_init()
458 	if (!snd_proc_root->p)  in snd_info_init()
480 	return -ENOMEM;  in snd_info_init()
489 static void snd_card_id_read(struct snd_info_entry *entry,  in snd_card_id_read()  argument
492 	struct snd_card *card = entry->private_data;  in snd_card_id_read()
494 	snd_iprintf(buffer, "%s\n", card->id);  in snd_card_id_read()
504 	struct snd_info_entry *entry;  in snd_info_card_create()  local
507 		return -ENXIO;  in snd_info_card_create()
509 	sprintf(str, "card%i", card->number);  in snd_info_card_create()
510 	entry = create_subdir(card->module, str);  in snd_info_card_create()
511 	if (!entry)  in snd_info_card_create()
512 		return -ENOMEM;  in snd_info_card_create()
513 	card->proc_root = entry;  in snd_info_card_create()
529 		return -ENXIO;  in snd_info_card_register()
531 	err = snd_info_register(card->proc_root);  in snd_info_card_register()
535 	if (!strcmp(card->id, card->proc_root->name))  in snd_info_card_register()
538 	if (card->proc_root_link)  in snd_info_card_register()
540 	p = proc_symlink(card->id, snd_proc_root->p, card->proc_root->name);  in snd_info_card_register()
542 		return -ENOMEM;  in snd_info_card_register()
543 	card->proc_root_link = p;  in snd_info_card_register()
548  * called on card->id change
553 	if (card->proc_root_link) {  in snd_info_card_id_change()
554 		proc_remove(card->proc_root_link);  in snd_info_card_id_change()
555 		card->proc_root_link = NULL;  in snd_info_card_id_change()
557 	if (strcmp(card->id, card->proc_root->name))  in snd_info_card_id_change()
558 		card->proc_root_link = proc_symlink(card->id,  in snd_info_card_id_change()
559 						    snd_proc_root->p,  in snd_info_card_id_change()
560 						    card->proc_root->name);  in snd_info_card_id_change()
565  * de-register the card proc file
573 	proc_remove(card->proc_root_link);  in snd_info_card_disconnect()
574 	if (card->proc_root)  in snd_info_card_disconnect()
575 		proc_remove(card->proc_root->p);  in snd_info_card_disconnect()
578 	if (card->proc_root)  in snd_info_card_disconnect()
579 		snd_info_clear_entries(card->proc_root);  in snd_info_card_disconnect()
580 	card->proc_root_link = NULL;  in snd_info_card_disconnect()
581 	card->proc_root = NULL;  in snd_info_card_disconnect()
593 	snd_info_free_entry(card->proc_root);  in snd_info_card_free()
594 	card->proc_root = NULL;  in snd_info_card_free()
600  * snd_info_get_line - read one line from the procfs buffer
615 	if (!buffer->buffer)  in snd_info_get_line()
617 	if (len <= 0 || buffer->stop || buffer->error)  in snd_info_get_line()
619 	while (!buffer->stop) {  in snd_info_get_line()
620 		c = buffer->buffer[buffer->curr++];  in snd_info_get_line()
621 		if (buffer->curr >= buffer->size)  in snd_info_get_line()
622 			buffer->stop = 1;  in snd_info_get_line()
626 			len--;  in snd_info_get_line()
636  * snd_info_get_str - parse a string token
639  * @len: the max. length of token - 1
655 		while (--len > 0 && *src && *src != c) {  in snd_info_get_str()
661 		while (--len > 0 && *src && *src != ' ' && *src != '\t') {  in snd_info_get_str()
673  * snd_info_create_entry - create an info entry
674  * @name: the proc file name
677  * Creates an info entry with the given file name and initializes as
686 snd_info_create_entry(const char *name, struct snd_info_entry *parent,  in snd_info_create_entry()  argument
689 	struct snd_info_entry *entry;  in snd_info_create_entry()  local
690 	entry = kzalloc(sizeof(*entry), GFP_KERNEL);  in snd_info_create_entry()
691 	if (entry == NULL)  in snd_info_create_entry()
693 	entry->name = kstrdup(name, GFP_KERNEL);  in snd_info_create_entry()
694 	if (entry->name == NULL) {  in snd_info_create_entry()
695 		kfree(entry);  in snd_info_create_entry()
698 	entry->mode = S_IFREG | 0444;  in snd_info_create_entry()
699 	entry->content = SNDRV_INFO_CONTENT_TEXT;  in snd_info_create_entry()
700 	mutex_init(&entry->access);  in snd_info_create_entry()
701 	INIT_LIST_HEAD(&entry->children);  in snd_info_create_entry()
702 	INIT_LIST_HEAD(&entry->list);  in snd_info_create_entry()
703 	entry->parent = parent;  in snd_info_create_entry()
704 	entry->module = module;  in snd_info_create_entry()
706 		mutex_lock(&parent->access);  in snd_info_create_entry()
707 		list_add_tail(&entry->list, &parent->children);  in snd_info_create_entry()
708 		mutex_unlock(&parent->access);  in snd_info_create_entry()
710 	return entry;  in snd_info_create_entry()
714  * snd_info_create_module_entry - create an info entry for the given module
716  * @name: the file name
719  * Creates a new info entry and assigns it to the given module.
724 					       const char *name,  in snd_info_create_module_entry()  argument
729 	return snd_info_create_entry(name, parent, module);  in snd_info_create_module_entry()
734  * snd_info_create_card_entry - create an info entry for the given card
736  * @name: the file name
739  * Creates a new info entry and assigns it to the given card.
744 					     const char *name,  in snd_info_create_card_entry()  argument
748 		parent = card->proc_root;  in snd_info_create_card_entry()
749 	return snd_info_create_entry(name, parent, card->module);  in snd_info_create_card_entry()
753 static void snd_info_clear_entries(struct snd_info_entry *entry)  in snd_info_clear_entries()  argument
757 	if (!entry->p)  in snd_info_clear_entries()
759 	list_for_each_entry(p, &entry->children, list)  in snd_info_clear_entries()
761 	entry->p = NULL;  in snd_info_clear_entries()
765  * snd_info_free_entry - release the info entry
766  * @entry: the info entry
768  * Releases the info entry.
770 void snd_info_free_entry(struct snd_info_entry * entry)  in snd_info_free_entry()  argument
774 	if (!entry)  in snd_info_free_entry()
776 	if (entry->p) {  in snd_info_free_entry()
777 		proc_remove(entry->p);  in snd_info_free_entry()
779 		snd_info_clear_entries(entry);  in snd_info_free_entry()
784 	list_for_each_entry_safe(p, n, &entry->children, list)  in snd_info_free_entry()
787 	p = entry->parent;  in snd_info_free_entry()
789 		mutex_lock(&p->access);  in snd_info_free_entry()
790 		list_del(&entry->list);  in snd_info_free_entry()
791 		mutex_unlock(&p->access);  in snd_info_free_entry()
793 	kfree(entry->name);  in snd_info_free_entry()
794 	if (entry->private_free)  in snd_info_free_entry()
795 		entry->private_free(entry);  in snd_info_free_entry()
796 	kfree(entry);  in snd_info_free_entry()
800 static int __snd_info_register(struct snd_info_entry *entry)  in __snd_info_register()  argument
804 	if (snd_BUG_ON(!entry))  in __snd_info_register()
805 		return -ENXIO;  in __snd_info_register()
806 	root = entry->parent == NULL ? snd_proc_root->p : entry->parent->p;  in __snd_info_register()
808 	if (entry->p || !root)  in __snd_info_register()
810 	if (S_ISDIR(entry->mode)) {  in __snd_info_register()
811 		p = proc_mkdir_mode(entry->name, entry->mode, root);  in __snd_info_register()
814 			return -ENOMEM;  in __snd_info_register()
818 		if (entry->content == SNDRV_INFO_CONTENT_DATA)  in __snd_info_register()
822 		p = proc_create_data(entry->name, entry->mode, root,  in __snd_info_register()
823 				     ops, entry);  in __snd_info_register()
826 			return -ENOMEM;  in __snd_info_register()
828 		proc_set_size(p, entry->size);  in __snd_info_register()
830 	entry->p = p;  in __snd_info_register()
837  * snd_info_register - register the info entry
838  * @entry: the info entry
840  * Registers the proc info entry.
845 int snd_info_register(struct snd_info_entry *entry)  in snd_info_register()  argument
850 	if (!entry->p) {  in snd_info_register()
851 		err = __snd_info_register(entry);  in snd_info_register()
856 	list_for_each_entry(p, &entry->children, list) {  in snd_info_register()
867  * snd_card_rw_proc_new - Create a read/write text proc file entry for the card
869  * @name: the file name
872  * @write: the write callback, NULL for read-only
874  * This proc file entry will be registered via snd_card_register() call, and
879 int snd_card_rw_proc_new(struct snd_card *card, const char *name,  in snd_card_rw_proc_new()  argument
883 			 void (*write)(struct snd_info_entry *entry,  in snd_card_rw_proc_new()  argument
886 	struct snd_info_entry *entry;  in snd_card_rw_proc_new()  local
888 	entry = snd_info_create_card_entry(card, name, card->proc_root);  in snd_card_rw_proc_new()
889 	if (!entry)  in snd_card_rw_proc_new()
890 		return -ENOMEM;  in snd_card_rw_proc_new()
891 	snd_info_set_text_ops(entry, private_data, read);  in snd_card_rw_proc_new()
893 		entry->mode |= 0200;  in snd_card_rw_proc_new()
894 		entry->c.text.write = write;  in snd_card_rw_proc_new()
904 static void snd_info_version_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)  in snd_info_version_read()  argument
908 		    init_utsname()->release);  in snd_info_version_read()
913 	struct snd_info_entry *entry;  in snd_info_version_init()  local
915 	entry = snd_info_create_module_entry(THIS_MODULE, "version", NULL);  in snd_info_version_init()
916 	if (entry == NULL)  in snd_info_version_init()
917 		return -ENOMEM;  in snd_info_version_init()
918 	entry->c.text.read = snd_info_version_read;  in snd_info_version_init()
919 	return snd_info_register(entry); /* freed in error path */  in snd_info_version_init()