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
30  * @FW_UPLOAD_ERR_FW_INVALID: invalid firmware file
48 	void *priv;	 /* firmware loader private fields */
52  * struct fw_upload_ops - device specific operations to support firmware upload
84  * Built-in firmware functionality is only available if FW_LOADER=y, but not
88 bool firmware_request_builtin(struct firmware *fw, const char *name);
90 static inline bool firmware_request_builtin(struct firmware *fw,  in firmware_request_builtin()
91 					    const char *name)  in firmware_request_builtin()  argument
98 int request_firmware(const struct firmware **fw, const char *name,
100 int firmware_request_nowarn(const struct firmware **fw, const char *name,
102 int firmware_request_platform(const struct firmware **fw, const char *name,
106 	const char *name, struct device *device, gfp_t gfp, void *context,
107 	void (*cont)(const struct firmware *fw, void *context));
108 int request_firmware_direct(const struct firmware **fw, const char *name,
110 int request_firmware_into_buf(const struct firmware **firmware_p,
111 	const char *name, struct device *device, void *buf, size_t size);
112 int request_partial_firmware_into_buf(const struct firmware **firmware_p,
113 				      const char *name, struct device *device,
116 void release_firmware(const struct firmware *fw);
118 static inline int request_firmware(const struct firmware **fw,  in request_firmware()
119 				   const char *name,  in request_firmware()  argument
122 	return -EINVAL;  in request_firmware()
125 static inline int firmware_request_nowarn(const struct firmware **fw,  in firmware_request_nowarn()
126 					  const char *name,  in firmware_request_nowarn()  argument
129 	return -EINVAL;  in firmware_request_nowarn()
132 static inline int firmware_request_platform(const struct firmware **fw,  in firmware_request_platform()
133 					    const char *name,  in firmware_request_platform()  argument
136 	return -EINVAL;  in firmware_request_platform()
141 	const char *name, struct device *device, gfp_t gfp, void *context,  in request_firmware_nowait()  argument
142 	void (*cont)(const struct firmware *fw, void *context))  in request_firmware_nowait()
144 	return -EINVAL;  in request_firmware_nowait()
147 static inline void release_firmware(const struct firmware *fw)  in release_firmware()
151 static inline int request_firmware_direct(const struct firmware **fw,  in request_firmware_direct()
152 					  const char *name,  in request_firmware_direct()  argument
155 	return -EINVAL;  in request_firmware_direct()
158 static inline int request_firmware_into_buf(const struct firmware **firmware_p,  in request_firmware_into_buf()
159 	const char *name, struct device *device, void *buf, size_t size)  in request_firmware_into_buf()  argument
161 	return -EINVAL;  in request_firmware_into_buf()
165 					(const struct firmware **firmware_p,  in request_partial_firmware_into_buf()
166 					 const char *name,  in request_partial_firmware_into_buf()  argument
170 	return -EINVAL;  in request_partial_firmware_into_buf()
179 			 const char *name, const struct fw_upload_ops *ops,
187 			 const char *name, const struct fw_upload_ops *ops,  in firmware_upload_register()  argument
190 		return ERR_PTR(-EINVAL);  in firmware_upload_register()
199 int firmware_request_cache(struct device *device, const char *name);