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); 71#else 72static inline int firmware_fallback_platform(struct fw_priv *fw_priv) 73{ 74 return -ENOENT; 75} 76#endif 77 78#endif /* __FIRMWARE_FALLBACK_H */ 79