STRUCT OCS_HCU_DMA_LIST(9)

💖 NAME 💖

Hiii bestie, welcome to the struct ocs_hcu_dma_list(9) page in the Kernel API Manual! ✨ Ok so the name is struct ocs_hcu_dma_list, and it is an OCS-specific DMA linked list. That's the whole vibe, no cap 🫶.

✨ SYNOPSIS ✨

Here is the struct in all its exact glory, bestie:

       struct ocs_hcu_dma_list {
           struct ocs_hcu_dma_entry        *head;
           struct ocs_hcu_dma_entry        *tail;
           dma_addr_t dma_addr;
           size_t max_nents;
        };

🎀 Members 🎀

• head — the head of the list; it points to the array backing the list 👑.
• tail — the current tail of the list; it is NULL if the list is empty 🌸.
• dma_addr — the DMA address of head (i.e., the DMA address of the backing array) ✨.
• max_nents — maximum number of entries in the list (i.e., the number of elements in the backing array) 🔥.

🌈 Description 🌈

So the OCS DMA list is an array-backed list of OCS DMA descriptors 💅. The array backing the list is allocated with dma_alloc_coherent and pointed by head — yes, head is holding that backing-array pointer, main character energy 🎀.

🔥 SEE ALSO 🔥

Kernel file ./drivers/crypto/intel/keembay/ocs-hcu.c is the spot to peek at, bestie 👀. Also go say hi to these exact pages:

• struct ocs_hcu_dma_entry(9)
• ocs_hcu_wait_busy(9)
• ocs_hcu_get_intermediate_data(9)
• ocs_hcu_set_intermediate_data(9)
• ocs_hcu_hw_cfg(9)
• ocs_hcu_clear_key(9)
• ocs_hcu_write_key(9)
• ocs_hcu_ll_dma_start(9)
• ocs_hcu_hash_init(9)
• ocs_hcu_hash_update(9)
• ocs_hcu_hash_finup(9)
• ocs_hcu_hash_final(9)
• ocs_hcu_digest(9)
• ocs_hcu_hmac(9)

Signed off from ./drivers/crypto/intel/keembay in October 2026, for struct ocs_hcu_dma_list(9) — mwah, love you, bye! 💖🦋