Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * Misc and compatibility things
4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
5 */
6
7#include <linux/init.h>
8#include <linux/export.h>
9#include <linux/moduleparam.h>
10#include <linux/time.h>
11#include <linux/slab.h>
12#include <linux/ioport.h>
13#include <linux/fs.h>
14#include <sound/core.h>
15
16void release_and_free_resource(struct resource *res)
17{
18 if (res) {
19 release_resource(res);
20 kfree(res);
21 }
22}
23EXPORT_SYMBOL(release_and_free_resource);
24
25#ifdef CONFIG_PCI
26#include <linux/pci.h>
27/**
28 * snd_pci_quirk_lookup_id - look up a PCI SSID quirk list
29 * @vendor: PCI SSV id
30 * @device: PCI SSD id
31 * @list: quirk list, terminated by a null entry
32 *
33 * Look through the given quirk list and finds a matching entry
34 * with the same PCI SSID. When subdevice is 0, all subdevice
35 * values may match.
36 *
37 * Returns the matched entry pointer, or NULL if nothing matched.
38 */
39const struct snd_pci_quirk *
40snd_pci_quirk_lookup_id(u16 vendor, u16 device,
41 const struct snd_pci_quirk *list)
42{
43 const struct snd_pci_quirk *q;
44
45 for (q = list; q->subvendor || q->subdevice; q++) {
46 if (q->subvendor != vendor)
47 continue;
48 if (!q->subdevice ||
49 (device & q->subdevice_mask) == q->subdevice)
50 return q;
51 }
52 return NULL;
53}
54EXPORT_SYMBOL(snd_pci_quirk_lookup_id);
55
56/**
57 * snd_pci_quirk_lookup - look up a PCI SSID quirk list
58 * @pci: pci_dev handle
59 * @list: quirk list, terminated by a null entry
60 *
61 * Look through the given quirk list and finds a matching entry
62 * with the same PCI SSID. When subdevice is 0, all subdevice
63 * values may match.
64 *
65 * Returns the matched entry pointer, or NULL if nothing matched.
66 */
67const struct snd_pci_quirk *
68snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list)
69{
70 if (!pci)
71 return NULL;
72 return snd_pci_quirk_lookup_id(pci->subsystem_vendor,
73 pci->subsystem_device,
74 list);
75}
76EXPORT_SYMBOL(snd_pci_quirk_lookup);
77#endif
78
79/*
80 * Deferred async signal helpers
81 *
82 * Below are a few helper functions to wrap the async signal handling
83 * in the deferred work. The main purpose is to avoid the messy deadlock
84 * around tasklist_lock and co at the kill_fasync() invocation.
85 * fasync_helper() and kill_fasync() are replaced with snd_fasync_helper()
86 * and snd_kill_fasync(), respectively. In addition, snd_fasync_free() has
87 * to be called at releasing the relevant file object.
88 */
89struct snd_fasync {
90 struct fasync_struct *fasync;
91 int signal;
92 int poll;
93 int on;
94 struct list_head list;
95};
96
97static DEFINE_SPINLOCK(snd_fasync_lock);
98static LIST_HEAD(snd_fasync_list);
99
100static void snd_fasync_work_fn(struct work_struct *work)
101{
102 struct snd_fasync *fasync;
103
104 spin_lock_irq(&snd_fasync_lock);
105 while (!list_empty(&snd_fasync_list)) {
106 fasync = list_first_entry(&snd_fasync_list, struct snd_fasync, list);
107 list_del_init(&fasync->list);
108 spin_unlock_irq(&snd_fasync_lock);
109 if (fasync->on)
110 kill_fasync(&fasync->fasync, fasync->signal, fasync->poll);
111 spin_lock_irq(&snd_fasync_lock);
112 }
113 spin_unlock_irq(&snd_fasync_lock);
114}
115
116static DECLARE_WORK(snd_fasync_work, snd_fasync_work_fn);
117
118int snd_fasync_helper(int fd, struct file *file, int on,
119 struct snd_fasync **fasyncp)
120{
121 struct snd_fasync *fasync = NULL;
122
123 if (on) {
124 fasync = kzalloc(sizeof(*fasync), GFP_KERNEL);
125 if (!fasync)
126 return -ENOMEM;
127 INIT_LIST_HEAD(&fasync->list);
128 }
129
130 spin_lock_irq(&snd_fasync_lock);
131 if (*fasyncp) {
132 kfree(fasync);
133 fasync = *fasyncp;
134 } else {
135 if (!fasync) {
136 spin_unlock_irq(&snd_fasync_lock);
137 return 0;
138 }
139 *fasyncp = fasync;
140 }
141 fasync->on = on;
142 spin_unlock_irq(&snd_fasync_lock);
143 return fasync_helper(fd, file, on, &fasync->fasync);
144}
145EXPORT_SYMBOL_GPL(snd_fasync_helper);
146
147void snd_kill_fasync(struct snd_fasync *fasync, int signal, int poll)
148{
149 unsigned long flags;
150
151 if (!fasync || !fasync->on)
152 return;
153 spin_lock_irqsave(&snd_fasync_lock, flags);
154 fasync->signal = signal;
155 fasync->poll = poll;
156 list_move(&fasync->list, &snd_fasync_list);
157 schedule_work(&snd_fasync_work);
158 spin_unlock_irqrestore(&snd_fasync_lock, flags);
159}
160EXPORT_SYMBOL_GPL(snd_kill_fasync);
161
162void snd_fasync_free(struct snd_fasync *fasync)
163{
164 if (!fasync)
165 return;
166 fasync->on = 0;
167 flush_work(&snd_fasync_work);
168 kfree(fasync);
169}
170EXPORT_SYMBOL_GPL(snd_fasync_free);
1/*
2 * Misc and compatibility things
3 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
4 *
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 *
20 */
21
22#include <linux/init.h>
23#include <linux/export.h>
24#include <linux/moduleparam.h>
25#include <linux/time.h>
26#include <linux/slab.h>
27#include <linux/ioport.h>
28#include <sound/core.h>
29
30#ifdef CONFIG_SND_DEBUG
31
32#ifdef CONFIG_SND_DEBUG_VERBOSE
33#define DEFAULT_DEBUG_LEVEL 2
34#else
35#define DEFAULT_DEBUG_LEVEL 1
36#endif
37
38static int debug = DEFAULT_DEBUG_LEVEL;
39module_param(debug, int, 0644);
40MODULE_PARM_DESC(debug, "Debug level (0 = disable)");
41
42#endif /* CONFIG_SND_DEBUG */
43
44void release_and_free_resource(struct resource *res)
45{
46 if (res) {
47 release_resource(res);
48 kfree(res);
49 }
50}
51EXPORT_SYMBOL(release_and_free_resource);
52
53#ifdef CONFIG_SND_VERBOSE_PRINTK
54/* strip the leading path if the given path is absolute */
55static const char *sanity_file_name(const char *path)
56{
57 if (*path == '/')
58 return strrchr(path, '/') + 1;
59 else
60 return path;
61}
62#endif
63
64#if defined(CONFIG_SND_DEBUG) || defined(CONFIG_SND_VERBOSE_PRINTK)
65void __snd_printk(unsigned int level, const char *path, int line,
66 const char *format, ...)
67{
68 va_list args;
69#ifdef CONFIG_SND_VERBOSE_PRINTK
70 int kern_level;
71 struct va_format vaf;
72 char verbose_fmt[] = KERN_DEFAULT "ALSA %s:%d %pV";
73 bool level_found = false;
74#endif
75
76#ifdef CONFIG_SND_DEBUG
77 if (debug < level)
78 return;
79#endif
80
81 va_start(args, format);
82#ifdef CONFIG_SND_VERBOSE_PRINTK
83 vaf.fmt = format;
84 vaf.va = &args;
85
86 while ((kern_level = printk_get_level(vaf.fmt)) != 0) {
87 const char *end_of_header = printk_skip_level(vaf.fmt);
88
89 /* Ignore KERN_CONT. We print filename:line for each piece. */
90 if (kern_level >= '0' && kern_level <= '7') {
91 memcpy(verbose_fmt, vaf.fmt, end_of_header - vaf.fmt);
92 level_found = true;
93 }
94
95 vaf.fmt = end_of_header;
96 }
97
98 if (!level_found && level)
99 memcpy(verbose_fmt, KERN_DEBUG, sizeof(KERN_DEBUG) - 1);
100
101 printk(verbose_fmt, sanity_file_name(path), line, &vaf);
102#else
103 vprintk(format, args);
104#endif
105 va_end(args);
106}
107EXPORT_SYMBOL_GPL(__snd_printk);
108#endif
109
110#ifdef CONFIG_PCI
111#include <linux/pci.h>
112/**
113 * snd_pci_quirk_lookup_id - look up a PCI SSID quirk list
114 * @vendor: PCI SSV id
115 * @device: PCI SSD id
116 * @list: quirk list, terminated by a null entry
117 *
118 * Look through the given quirk list and finds a matching entry
119 * with the same PCI SSID. When subdevice is 0, all subdevice
120 * values may match.
121 *
122 * Returns the matched entry pointer, or NULL if nothing matched.
123 */
124const struct snd_pci_quirk *
125snd_pci_quirk_lookup_id(u16 vendor, u16 device,
126 const struct snd_pci_quirk *list)
127{
128 const struct snd_pci_quirk *q;
129
130 for (q = list; q->subvendor; q++) {
131 if (q->subvendor != vendor)
132 continue;
133 if (!q->subdevice ||
134 (device & q->subdevice_mask) == q->subdevice)
135 return q;
136 }
137 return NULL;
138}
139EXPORT_SYMBOL(snd_pci_quirk_lookup_id);
140
141/**
142 * snd_pci_quirk_lookup - look up a PCI SSID quirk list
143 * @pci: pci_dev handle
144 * @list: quirk list, terminated by a null entry
145 *
146 * Look through the given quirk list and finds a matching entry
147 * with the same PCI SSID. When subdevice is 0, all subdevice
148 * values may match.
149 *
150 * Returns the matched entry pointer, or NULL if nothing matched.
151 */
152const struct snd_pci_quirk *
153snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list)
154{
155 if (!pci)
156 return NULL;
157 return snd_pci_quirk_lookup_id(pci->subsystem_vendor,
158 pci->subsystem_device,
159 list);
160}
161EXPORT_SYMBOL(snd_pci_quirk_lookup);
162#endif