ishtp_cl_flush_queues(9)
π 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 β
0on success β slay β-EINVALif the device isNULLβ 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:
ishtp_read_list_flush(9)ishtp_cl_init(9)ishtp_cl_allocate(9)ishtp_cl_free(9)ishtp_cl_link(9)ishtp_cl_unlink(9)ishtp_cl_disconnect(9)ishtp_cl_is_other_connecting(9)ishtp_cl_connect_to_fw(9)ishtp_cl_connect(9)ishtp_cl_establish_connection(9)ishtp_cl_destroy_connection(9)ishtp_cl_read_start(9)ishtp_cl_send(9)ishtp_cl_read_complete(9)ipc_tx_send(9)ishtp_cl_send_msg_ipc(9)ishtp_cl_send_msg_dma(9)ishtp_cl_send_msg(9)recv_ishtp_cl_msg(9)recv_ishtp_cl_msg_dma(9)
iykyk, that's a lot of siblings π
π«Ά quick vibe check: it returns0on success, and-EINVALif the device isNULL. 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
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms