sci_controll..._coalescence(9)

💅 sci_controller_set_interrupt_coalescence 💅

okay so welcome to the sci_controll..._coalescence(9) Kernel API Manual page, bestie. This function is literally the “configure the interrupt coalescence” main character, and we’re gonna go through it with zero skips. No cap. ✨

🌸 NAME 🌸

sci_controller_set_interrupt_coalescence — This method allows the user to configure the interrupt coalescence. That’s the whole assignment, and it ate. 💅

🎀 SYNOPSIS 🎀

the whole signature, character for character, because we do not freestyle code here:

enum sci_status sci_controller_set_interrupt_coalescence (struct
       isci_host *ihost , u32 coalesce_number , u32 coalesce_timeout );

🦋 ARGUMENTS 🦋

• ihost — This parameter represents the handle to the controller object for which its interrupt coalesce register is overridden. So like, this is the controller handle getting the override treatment. 🫶
• coalesce_number — used to control the number of entries in the Completion Queue before an interrupt is generated. If the number of entries exceed this number, an interrupt will be generated. The valid range of the input is [0, 256]. A setting of 0 results in coalescing being disabled. Zero is literally the off switch here, iykyk.
• coalesce_timeout — timeout value in microseconds. The valid range of the input is [0, 2700000]. A setting of 0 is allowed and results in no interrupt coalescing timeout. Yes, zero is legal and it’s giving “timeout who?” energy 😌

💖 DESCRIPTION 💖

the description is giving receipt energy: it indicates if the user successfully set the interrupt coalesce parameters. Here’s the status tea:

• SCI_SUCCESS — the user successfully updated the interrutp coalescence. (Yes, interrutp — og typo preserved, because lore is lore 💀)
• SCI_FAILURE_INVALID_PARAMETER_VALUE — the user input value is out of range.

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/isci/host.c is the source file in question, and the whole SEE ALSO bestie squad is:

• isci_host_start_complete(9)
• sci_controller_get_suggested_start_timeout(9)
• sci_controller_start_next_phy(9)
• isci_host_completion_routine(9)
• sci_controller_stop(9)
• sci_controller_reset(9)
• isci_host_deinit(9)
• isci_host_init(9)
• sci_controller_allocate_remote_node_context(9)
• sci_controller_complete_io(9)
• sci_controller_start_task(9)

Signed off from the ./drivers/scsi/isci source, October 2026 dated, on the sci_controll..._coalescence(9) page — mwah 💖