STRUCT FRAGMENT_DSCRPT(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… struct fragment_dscrpt β€” NAME ✨

okay so bestie, gather round: struct fragment_dscrpt is the ISHTP firmware loader fragment descriptor. that's it, that's the whole vibe β€” it's the little struct that describes one fragment for the firmware loader. and yes, it's from the Kernel API Manual, we're doing kernel stuff today, look at us go πŸŽ€


🌸 SYNOPSIS 🌸

like, here's literally the whole thing, no cap:

struct fragment_dscrpt {
    __le64 ddr_adrs;
    __le32 fw_off;
    __le32 length;
 };

that's the entire struct. three fields. immaculate. main character energy honestly πŸ’œ


πŸ¦‹ Members πŸ¦‹

okay so let's meet the squad, one by one:

  • ddr_adrs β€” the address in host DDR. that's where it lives, bestie πŸ“
  • fw_off β€” the offset of the fragment in the fw image. so like, where in the image this fragment starts 🎯
  • length β€” the length of the fragment. how long it is. iconic of it honestly πŸ“
ngl these three are the whole struct, so if you blink you'll miss it. but they're everything to the loader 🫢

πŸ”₯ SEE ALSO πŸ”₯

go read these next, i'm obsessed, they're all in the kernel file ./drivers/hid/intel-ish-hid/ishtp/loader.h:

  • union loader_msg_header(9)
  • struct loader_xfer_query(9)
  • struct loader_version(9)
  • struct loader_capability(9)
  • struct loader_xfer_query_ack(9)
  • struct loader_xfer_fragment(9)
  • struct loader_xfer_fragment_ack(9)
  • struct loader_xfer_dma_fragment(9)
  • struct loader_start(9)
  • struct loader_start_ack(9)
  • struct ish_firmware_variant(9)
  • ishtp_loader_work(9)
  • struct ish_global_manifest(9)

like, that's a whole friend group right there πŸ’€ read them all, iykyk 🌈


🧚 sign-off 🧚

this page lives at ./drivers/hid/intel-ish-hid/ishtp, it's dated October 2026, and it's the manual page for struct fragment_dscrpt(9) β€” slay, go describe some fragments, bestie πŸ‘‘πŸ’–

πŸ“¦ where this page comes from