ishtp_cl_flush_queues(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… ishtp_cl_flush_queues β€” bestie, we're clearing the queues

okay so this is a page from the Kernel API Manual, and honestly? It's a little one, but it's iconic. Let's get into it 🫢


✨ NAME ✨

ishtp_cl_flush_queues β€” flush all queues for a client, fr fr 🌸


πŸŽ€ SYNOPSIS πŸŽ€

int ishtp_cl_flush_queues (struct ishtp_cl *cl );

That's it. One function, one argument, zero drama. ✨


πŸ¦‹ ARGUMENTS πŸ¦‹

  • cl β€” the ishtp client instance. like, the actual client we're about to clean up πŸ’…

πŸ‘‘ DESCRIPTION πŸ‘‘

So what does it do? It's used to remove all queues for a client. That's the whole vibe.

When does it get called, you ask? Bestie, it shows up in some very specific moments:

  • when a client device needs a reset because of an error 😭
  • on S3 resume 🌈
  • during module removal 🧚

So basically it's the "okay we're done here, clear the queues" moment. Not me being obsessed with a cleanup function but here we are πŸ’–


⭐ RETURN ⭐

  • 0 on success β€” slay βœ…
  • -EINVAL if the device is NULL β€” yeah that's the error case, no cap πŸ’€

πŸ”₯ SEE ALSO πŸ”₯

Kernel file: ./drivers/hid/intel-ish-hid/ishtp/client.c

And the whole friend group of related calls β€” all of them, in order, no skipping:

iykyk, that's a lot of siblings πŸ’œ


🫢 quick vibe check: it returns 0 on success, and -EINVAL if the device is NULL. that's the whole return contract, don't @ me.

and that's the page!! this one lives under ./drivers/hid/intel-ish-hid/ishtp, dated October 2026, and it's part of the Kernel API Manual β€” mwah, sending you off with a little kiss from the kernel πŸ’‹πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from