STRUCT HAM_SETUP_SHARED_MEMORY_REQ(9)

🌸 struct ham_setup_shared_memory_req — NAME 🎀

okay bestie, welcome to the Kernel API Manual ✨ — this page is literally all about struct ham_setup_shared_memory_req, aka the shared memory setup request. that's it, that's the vibe. it's the lil message you send when you want shared memory set up, and we're gonna go through every single field together, no skipping 💅

✨ SYNOPSIS ✨

struct ham_setup_shared_memory_req {
    u32 msg_id;
    u16 ver;
    u16 reserved;
    u64 buffer_physical_address;
    u32 host_to_fw_section_length;
    u32 fw_to_host_section_length;
    u32 control_length;
 };

like, look at her. seven fields. she's iconic, she's compact, she's ready to be filled in 🫶

🦋 Members — yes every single one, i would never gatekeep

• msg_id — the message id, and it should be HAM_CB_MESSAGE_ID_REQ. not "could be", not "maybe" — should. ok? 😌
• ver — the message version, which is HAM_CB_MESSAGE_VER. that's the one. don't come at me with a different number 🙈
• reserved — reserved. like, it's reserved bestie. leave it alone. it's not your moment 💀
• buffer_physical_address — the physical address of the DMA buffer. like the actual physical one, fr fr 🔥
• host_to_fw_section_length — the memory size for host to fw communication. host ➡️ fw, one direction, one size 🌈
• fw_to_host_section_length — the memory size for fw to host communication. fw ➡️ host, the other direction, its own size 🎀
• control_length — the memory size for the control buffer. yep, the control stuff gets its own length too 👑

👀 SEE ALSO

this is where the whole friend group shows up, so let's give them their shoutouts 💖 the kernel file is ./drivers/misc/issei/hw_msg.h, and it's bringing all of these along:

• struct ham_setup_shared_memory_res(9)
• struct control_buffer(9)
• struct ham_message_header(9)
• struct ham_bus_message(9)
• struct ham_start_message_req(9)
• struct ham_start_message_res(9)
• struct ham_get_clients_req(9)
• struct ham_client_properties(9)
• struct ham_get_clients_res(9)

go read them too, i'm literally begging 🧚

reminder that the reserved field is reserved. i'm saying it twice because someone always tries something 🙈

and that's the page!! 🍓 sign-off time: this lives over in ./drivers/misc/issei, dated October 2026, and it's struct ham_s...d_memory_req(9) — ok love u bye, go set up some shared memory responsibly 💜✨