ish_disable_dma(9)
π
ish_disable_dma (9) β from the Kernel API Manual, bestie
okay so picture this: it's giving kernel-internal, it's giving Intel ISH energy, and the manual page name is literally ish_disable_dma. Welcome to the Kernel API Manual glow-up, bestie β this one's short, sweet, and does exactly one job. π
β¨ NAME β¨
ish_disable_dma β shuts down the dma communication between the host and ISHFW, no cap π«Ά
So likeβ¦ the host and ISHFW have been chatting over dma, and this function is the "okay bye bestie, we're done here" moment. π
πΈ SYNOPSIS πΈ
int ish_disable_dma (struct ishtp_device *dev );
yeah that's it. one argument, one int coming back atcha. iconic minimalism honestly. β
π¦ ARGUMENTS π¦
devβ the ishtp device pointer. that's the whole argument list. one (1) pointer, the main character of this story. π
π DESCRIPTION π
okay so here's the entire vibe: it clears the dma enable bit and then it waits for dma to go inactive. that's the whole thing. π§
clear the enable bit β wait for inactive β done.
it's literally the "turning the lights off and making sure everyone actually left the party" of kernel functions. no extra steps, no notes. β¨
π₯ RETURN π₯
0for success π- else an error code π (like, not zero, soβ¦ something went sideways, bestie)
fr fr: 0 = slay, anything else = check your error codes.
π SEE ALSO π
this is the part where the manpage gets social β it's all "you may also know me fromβ¦" and honestly the friend group is HUGE. π«Ά
Kernel file ./drivers/hid/intel-ish-hid/ipc/ipc.c plus:
ish_reg_read(9)ish_reg_write(9)_ish_read_fw_sts_reg(9)check_generated_interrupt(9)ish_is_input_ready(9)set_host_ready(9)ishtp_fw_is_ready(9)ish_set_host_rdy(9)ish_clr_host_rdy(9)ish_set_host_ready(9)_ishtp_read_hdr(9)_ishtp_read(9)write_ipc_from_queue(9)write_ipc_to_queue(9)ipc_send_mng_msg(9)timed_wait_for_timeout(9)ish_fw_reset_handler(9)fw_reset_work_fn(9)_ish_sync_fw_clock(9)recv_ipc(9)ish_irq_handler(9)ish_wakeup(9)_ish_hw_reset(9)_ish_ipc_reset(9)ish_hw_start(9)ish_ipc_get_header(9)_dma_no_cache_snooping(9)ish_dev_init(9)ish_device_disable(9)
like I said. big friend group. iykyk. π
seriously though β if you're poking around the Intel ISH IPC code, read the ones above too, they're all in the same ./drivers/hid/intel-ish-hid/ipc/ipc.c situation and they all reference each other. π
and that's the whole page, bestie β no more sections hiding at the bottom. π
sign-off time β¨ this little gem lives under ./drivers/hid/intel-ish-hid/ipc, dated October 2026, and it's page ish_disable_dma(9). go forth and disable that dma. slay. ππ
π¦ 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