xref: /dragonfly/sys/dev/drm/include/linux/firmware.h (revision d8082429)
1 /*
2  * Copyright (c) 2015 Michael Neumann
3  * Copyright (c) 2016 François Tigeot
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice unmodified, this list of conditions, and the following
11  *    disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef _LINUX_FIRMWARE_H_
29 #define _LINUX_FIRMWARE_H_
30 
31 #include <sys/bus.h>
32 #include <sys/firmware.h>
33 #include <linux/types.h>
34 #include <linux/compiler.h>
35 #include <linux/gfp.h>
36 #include <linux/device.h>
37 
38 static inline int
39 request_firmware(const struct firmware **fw, const char *name, __unused struct device *dev) {
40 	*fw = firmware_get(name);
41 	if (*fw) {
42 		return 0;
43 	}
44 	return -ENOENT;
45 }
46 
47 static inline int
48 request_firmware_nowait(struct module *module, bool uevent,
49     const char *name, struct device *device, gfp_t gfp, void *context,
50     void (*cont)(const struct firmware *fw, void *context))
51 {
52 	const struct firmware *fw;
53 
54 	fw = firmware_get(name);
55 	if (fw == NULL) {
56 		return -ENOENT;
57 	}
58 
59 	cont(fw, context);
60 
61 	return 0;
62 }
63 
64 static inline void
65 release_firmware(const struct firmware *fw) {
66 	if (fw != NULL) {
67 		firmware_put(fw, FIRMWARE_UNLOAD);
68 	}
69 }
70 
71 #endif	/* _LINUX_FIRMWARE_H_ */
72