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