Lines Matching full:firmware
3 * main.c - Multi purpose firmware loading support
7 * Please see Documentation/driver-api/firmware/ for more information.
25 #include <linux/firmware.h>
42 #include "firmware.h"
46 MODULE_DESCRIPTION("Multi purpose firmware loading support");
57 * Names of firmware images which have been cached successfully
59 * helper can trace which firmware images have been cached
95 /* Builtin firmware support */
102 static bool fw_copy_to_prealloc_buf(struct firmware *fw, in fw_copy_to_prealloc_buf()
113 static bool fw_get_builtin_firmware(struct firmware *fw, const char *name, in fw_get_builtin_firmware()
129 static bool fw_is_builtin_firmware(const struct firmware *fw) in fw_is_builtin_firmware()
140 #else /* Module case - no builtin firmware support */
142 static inline bool fw_get_builtin_firmware(struct firmware *fw, in fw_get_builtin_firmware()
149 static inline bool fw_is_builtin_firmware(const struct firmware *fw) in fw_is_builtin_firmware()
224 /* Returns 1 for batching firmware requests with the same name */
367 * XZ-compressed firmware support
465 /* direct firmware loading support */
469 "/lib/firmware/updates/" UTS_RELEASE,
470 "/lib/firmware/updates",
471 "/lib/firmware/" UTS_RELEASE,
472 "/lib/firmware"
481 MODULE_PARM_DESC(path, "customized firmware image search path with a higher priority than default p…
528 * firmware was not completely loaded. in fw_get_filesystem_firmware()
533 /* load firmware files from the mount namespace of init */ in fw_get_filesystem_firmware()
550 dev_dbg(device, "Loading firmware from %s\n", path); in fw_get_filesystem_firmware()
577 /* firmware holds the ownership of pages */
578 static void firmware_free_data(const struct firmware *fw) in firmware_free_data()
588 /* store the pages buffer info firmware from buf */
589 static void fw_set_page_data(struct fw_priv *fw_priv, struct firmware *fw) in fw_set_page_data()
641 /* add firmware name into devres list */
676 int assign_fw(struct firmware *fw, struct device *device) in assign_fw()
688 * add firmware name into devres list so that we can auto cache in assign_fw()
689 * and uncache firmware for device. in assign_fw()
694 /* don't cache firmware handled without uevent */ in assign_fw()
705 * After caching firmware image is started, let it piggyback in assign_fw()
706 * on request firmware. in assign_fw()
718 /* prepare firmware and firmware_buf structs;
719 * return 0 if a firmware is already assigned, 1 if need to load one,
723 _request_firmware_prepare(struct firmware **firmware_p, const char *name, in _request_firmware_prepare()
727 struct firmware *firmware; in _request_firmware_prepare() local
731 *firmware_p = firmware = kzalloc(sizeof(*firmware), GFP_KERNEL); in _request_firmware_prepare()
732 if (!firmware) { in _request_firmware_prepare()
733 dev_err(device, "%s: kmalloc(struct firmware) failed\n", in _request_firmware_prepare()
738 if (fw_get_builtin_firmware(firmware, name, dbuf, size)) { in _request_firmware_prepare()
748 * of requesting firmware. in _request_firmware_prepare()
750 firmware->priv = fw_priv; in _request_firmware_prepare()
755 fw_set_page_data(fw_priv, firmware); in _request_firmware_prepare()
774 static void fw_abort_batch_reqs(struct firmware *fw) in fw_abort_batch_reqs()
791 _request_firmware(const struct firmware **firmware_p, const char *name, in _request_firmware()
795 struct firmware *fw = NULL; in _request_firmware()
829 "Direct firmware load for %s failed with error %d\n", in _request_firmware()
849 * request_firmware() - send firmware request and wait for it
850 * @firmware_p: pointer to firmware image
851 * @name: name of firmware file
852 * @device: device for which firmware is being loaded
854 * @firmware_p will be used to return a firmware image by the name
859 * @name will be used as $FIRMWARE in the uevent environment and
861 * firmware image for this or any other device.
869 request_firmware(const struct firmware **firmware_p, const char *name, in request_firmware()
885 * @firmware: pointer to firmware image
886 * @name: name of firmware file
887 * @device: device for which firmware is being loaded
892 * failures to find the firmware file with it are still suppressed. It is
896 int firmware_request_nowarn(const struct firmware **firmware, const char *name, in firmware_request_nowarn() argument
903 ret = _request_firmware(firmware, name, device, NULL, 0, 0, in firmware_request_nowarn()
911 * request_firmware_direct() - load firmware directly without usermode helper
912 * @firmware_p: pointer to firmware image
913 * @name: name of firmware file
914 * @device: device for which firmware is being loaded
917 * fall back to usermode helper even if the firmware couldn't be loaded
921 int request_firmware_direct(const struct firmware **firmware_p, in request_firmware_direct()
936 * firmware_request_platform() - request firmware with platform-fw fallback
937 * @firmware: pointer to firmware image
938 * @name: name of firmware file
939 * @device: device for which firmware is being loaded
943 * requested firmware embedded in the platform's main (e.g. UEFI) firmware.
945 int firmware_request_platform(const struct firmware **firmware, in firmware_request_platform() argument
952 ret = _request_firmware(firmware, name, device, NULL, 0, 0, in firmware_request_platform()
960 * firmware_request_cache() - cache firmware for suspend so resume can use it
961 * @name: name of firmware file
962 * @device: device for which firmware should be cached for
965 * require loading firmware on system reboot. This optimization may still
966 * require the firmware present on resume from suspend. This routine can be
967 * used to ensure the firmware is present on resume from suspend in these
984 * request_firmware_into_buf() - load firmware into a previously allocated buffer
985 * @firmware_p: pointer to firmware image
986 * @name: name of firmware file
987 * @device: device for which firmware is being loaded and DMA region allocated
988 * @buf: address of buffer to load firmware into
992 * allocate a buffer to hold the firmware data. Instead, the firmware
996 * This function doesn't cache firmware either.
999 request_firmware_into_buf(const struct firmware **firmware_p, const char *name, in request_firmware_into_buf()
1016 * request_partial_firmware_into_buf() - load partial firmware into a previously allocated buffer
1017 * @firmware_p: pointer to firmware image
1018 * @name: name of firmware file
1019 * @device: device for which firmware is being loaded and DMA region allocated
1020 * @buf: address of buffer to load firmware into
1028 request_partial_firmware_into_buf(const struct firmware **firmware_p, in request_partial_firmware_into_buf()
1047 * release_firmware() - release the resource associated with a firmware image
1048 * @fw: firmware resource to release
1050 void release_firmware(const struct firmware *fw) in release_firmware()
1067 void (*cont)(const struct firmware *fw, void *context);
1074 const struct firmware *fw; in request_firmware_work_func()
1090 * @module: module requesting the firmware
1091 * @uevent: sends uevent to copy the firmware image if this flag
1092 * is non-zero else the firmware copy must be done manually.
1093 * @name: name of firmware file
1094 * @device: device for which firmware is being loaded
1097 * @fw may be %NULL if firmware request fails.
1098 * @cont: function will be called asynchronously when the firmware
1106 * requesting firmware in their ->probe() methods, if
1115 void (*cont)(const struct firmware *fw, void *context)) in request_firmware_nowait()
1158 * cache_firmware() - cache one firmware image in kernel memory space
1159 * @fw_name: the firmware image name
1161 * Cache firmware in kernel memory so that drivers can use it when
1162 * system isn't ready for them to request firmware image from userspace.
1164 * nowait version to get the cached firmware without any interacting
1167 * Return 0 if the firmware image has been cached successfully
1174 const struct firmware *fw; in cache_firmware()
1200 * uncache_firmware() - remove one cached firmware image
1201 * @fw_name: the firmware image name
1203 * Uncache one firmware image which has been cached successfully
1206 * Return 0 if the firmware cache has been removed successfully
1213 struct firmware fw; in uncache_firmware()
1338 /* only one cache entry for one firmware */ in dev_cache_fw_image()
1375 * device_cache_fw_images() - cache devices' firmware
1378 * successfully before, the firmware names are recored into the
1382 * time when system is not ready to complete loading firmware.
1401 /* wait for completion of caching firmware for all devices */ in device_cache_fw_images()
1408 * device_uncache_fw_images() - uncache devices' firmware
1470 /* stop caching firmware once syscore_suspend is reached */