1 /* SPDX-License-Identifier: GPL-2.0 */
12 struct firmware {  struct
16 	/* firmware loader private fields */  argument
21  * enum fw_upload_err - firmware upload error codes  argument
24  * @FW_UPLOAD_ERR_TIMEOUT: SW timed out on handshake with HW/firmware
27  * @FW_UPLOAD_ERR_INVALID_SIZE: invalid firmware image size
29  * @FW_UPLOAD_ERR_WEAROUT: FLASH device is approaching wear-out, wait & retry
46 	void *priv;	 /* firmware loader private fields */
50  * struct fw_upload_ops - device specific operations to support firmware upload
82  * Built-in firmware functionality is only available if FW_LOADER=y, but not
86 bool firmware_request_builtin(struct firmware *fw, const char *name);
88 static inline bool firmware_request_builtin(struct firmware *fw,  in firmware_request_builtin()
89 					    const char *name)  in firmware_request_builtin()  argument
96 int request_firmware(const struct firmware **fw, const char *name,
98 int firmware_request_nowarn(const struct firmware **fw, const char *name,
100 int firmware_request_platform(const struct firmware **fw, const char *name,
104 	const char *name, struct device *device, gfp_t gfp, void *context,
105 	void (*cont)(const struct firmware *fw, void *context));
106 int request_firmware_direct(const struct firmware **fw, const char *name,
108 int request_firmware_into_buf(const struct firmware **firmware_p,
109 	const char *name, struct device *device, void *buf, size_t size);
110 int request_partial_firmware_into_buf(const struct firmware **firmware_p,
111 				      const char *name, struct device *device,
114 void release_firmware(const struct firmware *fw);
116 static inline int request_firmware(const struct firmware **fw,  in request_firmware()
117 				   const char *name,  in request_firmware()  argument
120 	return -EINVAL;  in request_firmware()
123 static inline int firmware_request_nowarn(const struct firmware **fw,  in firmware_request_nowarn()
124 					  const char *name,  in firmware_request_nowarn()  argument
127 	return -EINVAL;  in firmware_request_nowarn()
130 static inline int firmware_request_platform(const struct firmware **fw,  in firmware_request_platform()
131 					    const char *name,  in firmware_request_platform()  argument
134 	return -EINVAL;  in firmware_request_platform()
139 	const char *name, struct device *device, gfp_t gfp, void *context,  in request_firmware_nowait()  argument
140 	void (*cont)(const struct firmware *fw, void *context))  in request_firmware_nowait()
142 	return -EINVAL;  in request_firmware_nowait()
145 static inline void release_firmware(const struct firmware *fw)  in release_firmware()
149 static inline int request_firmware_direct(const struct firmware **fw,  in request_firmware_direct()
150 					  const char *name,  in request_firmware_direct()  argument
153 	return -EINVAL;  in request_firmware_direct()
156 static inline int request_firmware_into_buf(const struct firmware **firmware_p,  in request_firmware_into_buf()
157 	const char *name, struct device *device, void *buf, size_t size)  in request_firmware_into_buf()  argument
159 	return -EINVAL;  in request_firmware_into_buf()
163 					(const struct firmware **firmware_p,  in request_partial_firmware_into_buf()
164 					 const char *name,  in request_partial_firmware_into_buf()  argument
168 	return -EINVAL;  in request_partial_firmware_into_buf()
177 			 const char *name, const struct fw_upload_ops *ops,
185 			 const char *name, const struct fw_upload_ops *ops,  in firmware_upload_register()  argument
188 		return ERR_PTR(-EINVAL);  in firmware_upload_register()
197 int firmware_request_cache(struct device *device, const char *name);