ishtp_bus_re..._all_clients(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… ishtp_bus_re..._all_clients(9) β€” the Kernel API Manual, bestie edition πŸŽ€

okay so this is a page straight out of the kernel API manual for ishtp β€” the Intel ISHTP situation β€” and the function name got a lil truncated in the header, so yes, it's literally called ishtp_bus_re..._all_clients(9) up there. iykyk. ✨


🌸 NAME 🌸

ishtp_bus_remove_all_clients β€” removes, and i cannot stress this enough, all the clients. all of them. every last one. πŸ’…


🌈 SYNOPSIS 🌈

void ishtp_bus_remove_all_clients (struct ishtp_device *ishtp_dev , bool warm_reset );

like, the whole vibe is right there. void, two args, no return value, no drama. 🫢


πŸ¦‹ ARGUMENTS πŸ¦‹

  • ishtp_dev β€” the ishtp device. that's it, that's the description. she's the ishtp device. the main character, frankly. πŸ‘‘
  • warm_reset β€” a bool that tells you the reset happened because of FW reset due to errors or S3 suspend. so it's a warm reset situation, not a cold one, and the function needs to know which one it's dealing with. πŸ’€

🧚 DESCRIPTION 🧚

okay so context: this function is part of the reset/remove flow. bestie she does not do casual calls β€” the main processing here only targets error processing, like when the FW has forced a reset or thrown an error and the connected clients need to get removed. 😭

and here's the plot twist that actually matters: when it's a warm reset, the client devices are NOT removed. like. they stay. they're fine. they survived. so do NOT expect them gone, okay? that's the whole distinction. lowkey obsessed with how much this one flag changes. πŸ”₯

ngl this whole thing is about reset/remove flow, so if you're not in that flow, maybe go read something else. this is error-processing hours only. πŸ•

⭐ SEE ALSO ⭐

she lives in the kernel file ./drivers/hid/intel-ish-hid/ishtp/bus.c and she's got a LOT of friends. like, an entire friend group. brace yourself. πŸ’–


πŸ“ sign-off πŸ“

that's the whole page, bestie. she comes from ./drivers/hid/intel-ish-hid/ishtp, and this version is stamped October 2026. go forth and remove all clients… unless it's a warm reset, obviously. slay. πŸ’œπŸ¦‹βœ¨

πŸ“¦ where this page comes from