xref: /linux/sound/core/misc.c (revision 413d6ed3eac387a2876893c337174f0c5b99d01d)
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 <sound/core.h>
14 
15 #ifdef CONFIG_SND_DEBUG
16 
17 #ifdef CONFIG_SND_DEBUG_VERBOSE
18 #define DEFAULT_DEBUG_LEVEL	2
19 #else
20 #define DEFAULT_DEBUG_LEVEL	1
21 #endif
22 
23 static int debug = DEFAULT_DEBUG_LEVEL;
24 module_param(debug, int, 0644);
25 MODULE_PARM_DESC(debug, "Debug level (0 = disable)");
26 
27 #endif /* CONFIG_SND_DEBUG */
28 
29 void release_and_free_resource(struct resource *res)
30 {
31 	if (res) {
32 		release_resource(res);
33 		kfree(res);
34 	}
35 }
36 EXPORT_SYMBOL(release_and_free_resource);
37 
38 #ifdef CONFIG_SND_VERBOSE_PRINTK
39 /* strip the leading path if the given path is absolute */
40 static const char *sanity_file_name(const char *path)
41 {
42 	if (*path == '/')
43 		return strrchr(path, '/') + 1;
44 	else
45 		return path;
46 }
47 #endif
48 
49 #if defined(CONFIG_SND_DEBUG) || defined(CONFIG_SND_VERBOSE_PRINTK)
50 void __snd_printk(unsigned int level, const char *path, int line,
51 		  const char *format, ...)
52 {
53 	va_list args;
54 #ifdef CONFIG_SND_VERBOSE_PRINTK
55 	int kern_level;
56 	struct va_format vaf;
57 	char verbose_fmt[] = KERN_DEFAULT "ALSA %s:%d %pV";
58 	bool level_found = false;
59 #endif
60 
61 #ifdef CONFIG_SND_DEBUG
62 	if (debug < level)
63 		return;
64 #endif
65 
66 	va_start(args, format);
67 #ifdef CONFIG_SND_VERBOSE_PRINTK
68 	vaf.fmt = format;
69 	vaf.va = &args;
70 
71 	while ((kern_level = printk_get_level(vaf.fmt)) != 0) {
72 		const char *end_of_header = printk_skip_level(vaf.fmt);
73 
74 		/* Ignore KERN_CONT. We print filename:line for each piece. */
75 		if (kern_level >= '0' && kern_level <= '7') {
76 			memcpy(verbose_fmt, vaf.fmt, end_of_header - vaf.fmt);
77 			level_found = true;
78 		}
79 
80 		vaf.fmt = end_of_header;
81 	}
82 
83 	if (!level_found && level)
84 		memcpy(verbose_fmt, KERN_DEBUG, sizeof(KERN_DEBUG) - 1);
85 
86 	printk(verbose_fmt, sanity_file_name(path), line, &vaf);
87 #else
88 	vprintk(format, args);
89 #endif
90 	va_end(args);
91 }
92 EXPORT_SYMBOL_GPL(__snd_printk);
93 #endif
94 
95 #ifdef CONFIG_PCI
96 #include <linux/pci.h>
97 /**
98  * snd_pci_quirk_lookup_id - look up a PCI SSID quirk list
99  * @vendor: PCI SSV id
100  * @device: PCI SSD id
101  * @list: quirk list, terminated by a null entry
102  *
103  * Look through the given quirk list and finds a matching entry
104  * with the same PCI SSID.  When subdevice is 0, all subdevice
105  * values may match.
106  *
107  * Returns the matched entry pointer, or NULL if nothing matched.
108  */
109 const struct snd_pci_quirk *
110 snd_pci_quirk_lookup_id(u16 vendor, u16 device,
111 			const struct snd_pci_quirk *list)
112 {
113 	const struct snd_pci_quirk *q;
114 
115 	for (q = list; q->subvendor; q++) {
116 		if (q->subvendor != vendor)
117 			continue;
118 		if (!q->subdevice ||
119 		    (device & q->subdevice_mask) == q->subdevice)
120 			return q;
121 	}
122 	return NULL;
123 }
124 EXPORT_SYMBOL(snd_pci_quirk_lookup_id);
125 
126 /**
127  * snd_pci_quirk_lookup - look up a PCI SSID quirk list
128  * @pci: pci_dev handle
129  * @list: quirk list, terminated by a null entry
130  *
131  * Look through the given quirk list and finds a matching entry
132  * with the same PCI SSID.  When subdevice is 0, all subdevice
133  * values may match.
134  *
135  * Returns the matched entry pointer, or NULL if nothing matched.
136  */
137 const struct snd_pci_quirk *
138 snd_pci_quirk_lookup(struct pci_dev *pci, const struct snd_pci_quirk *list)
139 {
140 	if (!pci)
141 		return NULL;
142 	return snd_pci_quirk_lookup_id(pci->subsystem_vendor,
143 				       pci->subsystem_device,
144 				       list);
145 }
146 EXPORT_SYMBOL(snd_pci_quirk_lookup);
147 #endif
148