Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
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#ifdef CONFIG_SYSCTL
46extern int register_firmware_config_sysctl(void);
47extern void unregister_firmware_config_sysctl(void);
48#else
49static inline int register_firmware_config_sysctl(void)
50{
51 return 0;
52}
53static inline void unregister_firmware_config_sysctl(void) { }
54#endif /* CONFIG_SYSCTL */
55
56#else /* CONFIG_FW_LOADER_USER_HELPER */
57static inline int firmware_fallback_sysfs(struct firmware *fw, const char *name,
58 struct device *device,
59 u32 opt_flags,
60 int ret)
61{
62 /* Keep carrying over the same error */
63 return ret;
64}
65
66static inline void kill_pending_fw_fallback_reqs(bool only_kill_custom) { }
67static inline void fw_fallback_set_cache_timeout(void) { }
68static inline void fw_fallback_set_default_timeout(void) { }
69
70static inline int register_sysfs_loader(void)
71{
72 return 0;
73}
74
75static inline void unregister_sysfs_loader(void)
76{
77}
78#endif /* CONFIG_FW_LOADER_USER_HELPER */
79
80#ifdef CONFIG_EFI_EMBEDDED_FIRMWARE
81int firmware_fallback_platform(struct fw_priv *fw_priv);
82#else
83static inline int firmware_fallback_platform(struct fw_priv *fw_priv)
84{
85 return -ENOENT;
86}
87#endif
88
89#endif /* __FIRMWARE_FALLBACK_H */