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);
51 void release_firmware(const struct firmware *fw);
53 static inline int request_firmware(const struct firmware **fw,
55 struct device *device)
59 static inline int request_firmware_nowait(
60 struct module *module, bool uevent,
61 const char *name, struct device *device, gfp_t gfp, void *context,
62 void (*cont)(const struct firmware *fw, void *context))
67 static inline void release_firmware(const struct firmware *fw)
71 static inline int request_firmware_direct(const struct firmware **fw,
73 struct device *device)
79 #ifndef _LINUX_LIBRE_FIRMWARE_H
80 #define _LINUX_LIBRE_FIRMWARE_H
82 #include <linux/device.h>
84 #define NONFREE_FIRMWARE "/*(DEBLOBBED)*/"
87 is_nonfree_firmware(const char *name)
89 return strstr(name, NONFREE_FIRMWARE) != 0;
93 report_missing_free_firmware(const char *name, const char *what)
95 printk(KERN_ERR "%s: Missing Free %s (non-Free firmware loading is disabled)\n", name,
96 what ? what : "firmware");
100 reject_firmware(const struct firmware **fw,
101 const char *name, struct device *device)
103 const struct firmware *xfw = NULL;
105 report_missing_free_firmware(dev_name(device), NULL);
106 retval = request_firmware(&xfw, NONFREE_FIRMWARE, device);
108 release_firmware(xfw);
112 maybe_reject_firmware(const struct firmware **fw,
113 const char *name, struct device *device)
115 if (is_nonfree_firmware(name))
116 return reject_firmware(fw, name, device);
118 return request_firmware(fw, name, device);
121 reject_firmware_direct(const struct firmware **fw,
122 const char *name, struct device *device)
124 const struct firmware *xfw = NULL;
126 report_missing_free_firmware(dev_name(device), NULL);
127 retval = request_firmware_direct(&xfw, NONFREE_FIRMWARE, device);
129 release_firmware(xfw);
133 discard_rejected_firmware(const struct firmware *fw, void *context)
135 release_firmware(fw);
138 reject_firmware_nowait(struct module *module, int uevent,
139 const char *name, struct device *device,
140 gfp_t gfp, void *context,
141 void (*cont)(const struct firmware *fw,
145 report_missing_free_firmware(dev_name(device), NULL);
146 retval = request_firmware_nowait(module, uevent, NONFREE_FIRMWARE,
148 discard_rejected_firmware);
154 maybe_reject_firmware_nowait(struct module *module, int uevent,
155 const char *name, struct device *device,
156 gfp_t gfp, void *context,
157 void (*cont)(const struct firmware *fw,
160 if (is_nonfree_firmware(name))
161 return reject_firmware_nowait(module, uevent, name,
162 device, gfp, context, cont);
164 return request_firmware_nowait(module, uevent, name,
165 device, gfp, context, cont);
168 #endif /* _LINUX_LIBRE_FIRMWARE_H */