1 #ifndef _LINUX_FIRMWARE_H
2 #define _LINUX_FIRMWARE_H
4 #include <linux/types.h>
5 #include <linux/compiler.h>
8 #define FW_ACTION_NOHOTPLUG 0
9 #define FW_ACTION_HOTPLUG 1
16 /* firmware loader private fields */
29 /* We have to play tricks here much like stringify() to get the
30 __COUNTER__ macro to be expanded as we want it */
31 #define __fw_concat1(x, y) x##y
32 #define __fw_concat(x, y) __fw_concat1(x, y)
34 #define DECLARE_BUILTIN_FIRMWARE(name, blob) \
35 DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))
37 #define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size) \
38 static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
39 __used __section(.builtin_fw) = { name, blob, size }
41 #if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
42 int request_firmware(const struct firmware **fw, const char *name,
43 struct device *device);
44 int request_firmware_nowait(
45 struct module *module, bool uevent,
46 const char *name, struct device *device, gfp_t gfp, void *context,
47 void (*cont)(const struct firmware *fw, void *context));
48 int request_firmware_direct(const struct firmware **fw, const char *name,
49 struct device *device);
50 int request_firmware_into_buf(const struct firmware **firmware_p,
51 const char *name, struct device *device, void *buf, size_t size);
53 void release_firmware(const struct firmware *fw);
55 static inline int request_firmware(const struct firmware **fw,
57 struct device *device)
61 static inline int request_firmware_nowait(
62 struct module *module, bool uevent,
63 const char *name, struct device *device, gfp_t gfp, void *context,
64 void (*cont)(const struct firmware *fw, void *context))
69 static inline void release_firmware(const struct firmware *fw)
73 static inline int request_firmware_direct(const struct firmware **fw,
75 struct device *device)
80 static inline int request_firmware_into_buf(const struct firmware **firmware_p,
81 const char *name, struct device *device, void *buf, size_t size)
87 #ifndef _LINUX_LIBRE_FIRMWARE_H
88 #define _LINUX_LIBRE_FIRMWARE_H
90 #include <linux/device.h>
92 #define NONFREE_FIRMWARE "/*(DEBLOBBED)*/"
95 is_nonfree_firmware(const char *name)
97 return strstr(name, NONFREE_FIRMWARE) != 0;
101 report_missing_free_firmware(const char *name, const char *what)
103 printk(KERN_ERR "%s: Missing Free %s (non-Free firmware loading is disabled)\n", name,
104 what ? what : "firmware");
108 reject_firmware(const struct firmware **fw,
109 const char *name, struct device *device)
111 const struct firmware *xfw = NULL;
113 retval0 = report_missing_free_firmware(dev_name(device), NULL);
114 retval = request_firmware(&xfw, NONFREE_FIRMWARE, device);
116 release_firmware(xfw);
122 maybe_reject_firmware(const struct firmware **fw,
123 const char *name, struct device *device)
125 if (is_nonfree_firmware(name))
126 return reject_firmware(fw, name, device);
128 return request_firmware(fw, name, device);
131 reject_firmware_direct(const struct firmware **fw,
132 const char *name, struct device *device)
134 const struct firmware *xfw = NULL;
137 retval0 = report_missing_free_firmware(dev_name(device), NULL);
138 retval = request_firmware_direct(&xfw, NONFREE_FIRMWARE, device);
140 release_firmware(xfw);
146 reject_firmware_nowait(struct module *module, int uevent,
147 const char *name, struct device *device,
148 gfp_t gfp, void *context,
149 void (*cont)(const struct firmware *fw,
152 report_missing_free_firmware(dev_name(device), NULL);
153 /* We assume NONFREE_FIRMWARE will not be found; how could it? */
154 return request_firmware_nowait(module, uevent, NONFREE_FIRMWARE,
155 device, gfp, context, cont);
158 maybe_reject_firmware_nowait(struct module *module, int uevent,
159 const char *name, struct device *device,
160 gfp_t gfp, void *context,
161 void (*cont)(const struct firmware *fw,
164 if (is_nonfree_firmware(name))
165 return reject_firmware_nowait(module, uevent, name,
166 device, gfp, context, cont);
168 return request_firmware_nowait(module, uevent, name,
169 device, gfp, context, cont);
172 #endif /* _LINUX_LIBRE_FIRMWARE_H */