xref: /linux/sound/core/misc.c (revision bd628c1bed7902ec1f24ba0fe70758949146abbe)
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 
38 static int debug = DEFAULT_DEBUG_LEVEL;
39 module_param(debug, int, 0644);
40 MODULE_PARM_DESC(debug, "Debug level (0 = disable)");
41 
42 #endif /* CONFIG_SND_DEBUG */
43 
44 void release_and_free_resource(struct resource *res)
45 {
46 	if (res) {
47 		release_resource(res);
48 		kfree(res);
49 	}
50 }
51 EXPORT_SYMBOL(release_and_free_resource);
52 
53 #ifdef CONFIG_SND_VERBOSE_PRINTK
54 /* strip the leading path if the given path is absolute */
55 static 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)
65 void __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 }
107 EXPORT_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  */
124 const struct snd_pci_quirk *
125 snd_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 }
139 EXPORT_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  */
152 const struct snd_pci_quirk *
153 snd_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 }
161 EXPORT_SYMBOL(snd_pci_quirk_lookup);
162 #endif
163