1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __FIRMWARE_FALLBACK_H
3 #define __FIRMWARE_FALLBACK_H
4
5 #include <linux/firmware.h>
6 #include <linux/device.h>
7
8 #include "firmware.h"
9
10 /**
11 * struct firmware_fallback_config - firmware fallback configuration settings
12 *
13 * Helps describe and fine tune the fallback mechanism.
14 *
15 * @force_sysfs_fallback: force the sysfs fallback mechanism to be used
16 * as if one had enabled CONFIG_FW_LOADER_USER_HELPER_FALLBACK=y.
17 * Useful to help debug a CONFIG_FW_LOADER_USER_HELPER_FALLBACK=y
18 * functionality on a kernel where that config entry has been disabled.
19 * @ignore_sysfs_fallback: force to disable the sysfs fallback mechanism.
20 * This emulates the behaviour as if we had set the kernel
21 * config CONFIG_FW_LOADER_USER_HELPER=n.
22 * @old_timeout: for internal use
23 * @loading_timeout: the timeout to wait for the fallback mechanism before
24 * giving up, in seconds.
25 */
26 struct firmware_fallback_config {
27 unsigned int force_sysfs_fallback;
28 unsigned int ignore_sysfs_fallback;
29 int old_timeout;
30 int loading_timeout;
31 };
32
33 #ifdef CONFIG_FW_LOADER_USER_HELPER
34 int firmware_fallback_sysfs(struct firmware *fw, const char *name,
35 struct device *device,
36 u32 opt_flags,
37 int ret);
38 void kill_pending_fw_fallback_reqs(bool only_kill_custom);
39
40 void fw_fallback_set_cache_timeout(void);
41 void fw_fallback_set_default_timeout(void);
42
43 int register_sysfs_loader(void);
44 void unregister_sysfs_loader(void);
45 #else /* CONFIG_FW_LOADER_USER_HELPER */
firmware_fallback_sysfs(struct firmware * fw,const char * name,struct device * device,u32 opt_flags,int ret)46 static inline int firmware_fallback_sysfs(struct firmware *fw, const char *name,
47 struct device *device,
48 u32 opt_flags,
49 int ret)
50 {
51 /* Keep carrying over the same error */
52 return ret;
53 }
54
kill_pending_fw_fallback_reqs(bool only_kill_custom)55 static inline void kill_pending_fw_fallback_reqs(bool only_kill_custom) { }
fw_fallback_set_cache_timeout(void)56 static inline void fw_fallback_set_cache_timeout(void) { }
fw_fallback_set_default_timeout(void)57 static inline void fw_fallback_set_default_timeout(void) { }
58
register_sysfs_loader(void)59 static inline int register_sysfs_loader(void)
60 {
61 return 0;
62 }
63
unregister_sysfs_loader(void)64 static inline void unregister_sysfs_loader(void)
65 {
66 }
67 #endif /* CONFIG_FW_LOADER_USER_HELPER */
68
69 #ifdef CONFIG_EFI_EMBEDDED_FIRMWARE
70 int firmware_fallback_platform(struct fw_priv *fw_priv);
71 #else
firmware_fallback_platform(struct fw_priv * fw_priv)72 static inline int firmware_fallback_platform(struct fw_priv *fw_priv)
73 {
74 return -ENOENT;
75 }
76 #endif
77
78 #endif /* __FIRMWARE_FALLBACK_H */
79