UNION LOADER_MSG_HEADER(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… union loader_msg_header(9) β€” bestie edition ✨

okay so you're reading a Kernel API Manual page, and the star of the show is union loader_msg_header, aka the ISHTP firmware loader message header. That's it, that's the whole vibe. It's the little header that says what an ISHTP firmware loader message is. πŸŽ€


🌸 NAME 🌸

union loader_msg_header β€” ISHTP firmware loader message header. no cap, that's literally what it is 🫢


✨ SYNOPSIS ✨

here's the whole thing, bestie, look at her:

union loader_msg_header {
    struct {
      __u32 command:7;
      __u32 is_response:1;
      __u32 has_next:1;
      __u32 reserved:15;
      __u32 status:8;
    };
    __u32 val32;
 };

she's a union, she's got an anonymous struct tucked inside, and she's doing bitfields. main character energy fr fr πŸ”₯


πŸ¦‹ Members πŸ¦‹

okay, meet the cast, one by one, no skipping πŸ‘‘

  • {unnamed_struct} β€” an anonymous struct. it's just... there. no name. mysterious. we love an enigma πŸ™ˆ
  • command β€” the command type. tells you what kind of message this is πŸ’«
  • is_response β€” indicates if the message is a response. yep, that's the whole job 🫑
  • has_next β€” indicates if there is a next message. so you know whether to keep scrolling, basically πŸ’…
  • reserved β€” reserved for future use. it's saving a seat for someone, we don't know who yet πŸŽ€
  • status β€” the status of the message. the vibe check, if you will ⭐
  • val32 β€” the entire header as a 32-bit value. like the whole squad in one group photo, iconic 🌈

πŸ’œ SEE ALSO πŸ’œ

go look at these, they're all in the Kernel file ./drivers/hid/intel-ish-hid/ishtp/loader.h:

  • 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 fragment_dscrpt(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 the whole friend group. go say hi 🧚


real talk: reserved is reserved for future use β€” don't go filling it in with your own little experiments, bestie, it's not yours πŸ’€

and that's the page! πŸ“ brought to you from ./drivers/hid/intel-ish-hid/ishtp, dated October 2026, and yes this is union loader_msg_header(9) signing off. mwah πŸ’–βœ¨

πŸ“¦ where this page comes from