pldmfw_flash_image(9)

💖 pldmfw_flash_image(9) 💖 — bestie, this page is from the Kernel API Manual, and it's the whole glowing guide to flashing a PLDM firmware image. 🎀

🌸 NAME 🌸

pldmfw_flash_image — write a PLDM-formatted firmware image to the device. That's the name, and yes it ate. 💅

✨ SYNOPSIS ✨

the signature is literally this, no edits:

int pldmfw_flash_image (struct pldmfw *context , const struct firmware
       *fw );

🫶 ARGUMENTS 🫶

the two args are giving main character energy:

• context — ops and data for firmware update. it's the context bestie for the update ops and data.
• fw — firmware object pointing to the relevant firmware file to program. it points at the actual firmware file you're gonna program.

💅 DESCRIPTION 💅

okay so here's the plot: it parses the data for a given firmware file, verifying that it's a valid PLDM formatted image that matches this device. 🦋

then it extracts the device record Package Data and Component Tables and sends them to the device firmware. after that, it extracts and writes the flash data for each of the components indicated in the firmware file. slay. ✨

🔥 RETURN 🔥

zero on success, or a negative error code on failure. so: success = zero, failure = negative error code. periodt. 💀

🦋 SEE ALSO 🦋

the cross-reference haul is huge and iconic:

• Kernel file ./lib/pldmfw/pldmfw.c
• pldm_check_fw_space(9)
• pldm_move_fw_offset(9)
• pldm_parse_header(9)
• pldm_check_desc_tlv_len(9)
• pldm_parse_desc_tlvs(9)
• pldm_parse_one_record(9)
• pldm_parse_records(9)
• pldm_parse_components(9)
• pldm_verify_header_crc(9)
• pldmfw_free_priv(9)
• pldm_parse_image(9)
• pldmfw_op_pci_match_record(9)
• pldm_find_matching_record(9)
• pldm_send_package_data(9)
• pldm_send_component_tables(9)
• pldm_flash_components(9)
• pldm_finalize_update(9)

🎀 cute sign-off: source/version line is ./lib/pldmfw, date is October 2026, and this page is pldmfw_flash_image(9). byeee bestie 🎀