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 */
26struct 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
34int firmware_fallback_sysfs(struct firmware *fw, const char *name,
35			    struct device *device,
36			    u32 opt_flags,
37			    int ret);
38void kill_pending_fw_fallback_reqs(bool only_kill_custom);
39
40void fw_fallback_set_cache_timeout(void);
41void fw_fallback_set_default_timeout(void);
42
43int register_sysfs_loader(void);
44void unregister_sysfs_loader(void);
45#else /* CONFIG_FW_LOADER_USER_HELPER */
46static 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
55static inline void kill_pending_fw_fallback_reqs(bool only_kill_custom) { }
56static inline void fw_fallback_set_cache_timeout(void) { }
57static inline void fw_fallback_set_default_timeout(void) { }
58
59static inline int register_sysfs_loader(void)
60{
61	return 0;
62}
63
64static inline void unregister_sysfs_loader(void)
65{
66}
67#endif /* CONFIG_FW_LOADER_USER_HELPER */
68
69#ifdef CONFIG_EFI_EMBEDDED_FIRMWARE
70int firmware_fallback_platform(struct fw_priv *fw_priv, u32 opt_flags);
71#else
72static inline int firmware_fallback_platform(struct fw_priv *fw_priv,
73					     u32 opt_flags)
74{
75	return -ENOENT;
76}
77#endif
78
79#endif /* __FIRMWARE_FALLBACK_H */

 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#include "sysfs.h"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
11#ifdef CONFIG_FW_LOADER_USER_HELPER
12int firmware_fallback_sysfs(struct firmware *fw, const char *name,
13			    struct device *device,
14			    u32 opt_flags,
15			    int ret);
16void kill_pending_fw_fallback_reqs(bool kill_all);
17
18void fw_fallback_set_cache_timeout(void);
19void fw_fallback_set_default_timeout(void);
20
 
 
21#else /* CONFIG_FW_LOADER_USER_HELPER */
22static inline int firmware_fallback_sysfs(struct firmware *fw, const char *name,
23					  struct device *device,
24					  u32 opt_flags,
25					  int ret)
26{
27	/* Keep carrying over the same error */
28	return ret;
29}
30
31static inline void kill_pending_fw_fallback_reqs(bool kill_all) { }
32static inline void fw_fallback_set_cache_timeout(void) { }
33static inline void fw_fallback_set_default_timeout(void) { }
 
 
 
 
 
 
 
 
 
34#endif /* CONFIG_FW_LOADER_USER_HELPER */
35
36#ifdef CONFIG_EFI_EMBEDDED_FIRMWARE
37int firmware_fallback_platform(struct fw_priv *fw_priv);
38#else
39static inline int firmware_fallback_platform(struct fw_priv *fw_priv)
 
40{
41	return -ENOENT;
42}
43#endif
44
45#endif /* __FIRMWARE_FALLBACK_H */