ishtp_cl_send(9)

💅 ishtp_cl_send — bestie's guide to the Kernel API Manual 🎀

okay so picture this: it's giving kernel API manual, it's giving ishtp_cl_send(9), and bestie we are diving in. no cap, this is the one that actually pushes your message out to firmware. let's go ✨

---

🌸 NAME 🌸

ishtp_cl_send — send a message to firmware. that's it. that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

int ishtp_cl_send (struct ishtp_cl *cl , uint8_t *buf , size_t length );

look at her. iconic signature. three args, one int coming back at you. 🔥

---

🫶 ARGUMENTS 🫶

• cl — the client device instance. like, the actual client you're working with, your main character 🎀
• buf — the message buffer. this is where your message lives, literally holding the content 📨
• length — length of message. how many bytes we're dealing with, no guessing allowed 💅

---

💖 DESCRIPTION 💖

okay so here's the tea ☕ — if the client is in the correct state to send a message (and that "if" is doing so much work, bestie, it's the whole vibe check of this function), then this function does three things in order:

1. it gets a buffer from the tx ring buffers 🎯
2. it copies the message data into it 📋
3. it calls to send the message using ishtp_cl_send_msg 🚀

so yeah, it's a little pipeline. ring buffer ➡️ copy ➡️ ishtp_cl_send_msg. and if the client isn't in the right state? it does not send. periodt. 💀

---

🌈 RETURN 🌈

0 if successful, or an error code on failure. that's the whole story — zero means slay, anything else means something went sideways 😭

---

👑 SEE ALSO 👑

the kernel file lives right here, bestie, go read the source it's lowkey fascinating:

./drivers/hid/intel-ish-hid/ishtp/client.c

and here's the whole friend group — every single one of them, not skipping a single one 🫶:

• ishtp_read_list_flush(9)
• ishtp_cl_flush_queues(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_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)

---

ok that's the whole page 💜 go forth and send messages responsibly, bestie — remember the state check is not optional, it's the moment 🙈

sourced from ./drivers/hid/intel-ish-hid/ishtp, dated October 2026, and yes the footer still says ishtp_cl_send(9) because we keep it real around here ✨🎀💅