STRUCT SEC_HW_SGL(9)

💖 NAME 💖

okay bestie, meet struct sec_hw_sgl(9) from the Kernel API Manual — she is literally one hardware SGL entry, and we are going to get into every single field together. no skipping, no cap. 💅

✨ SYNOPSIS ✨

here’s the shape of her, exactly as she is:

struct sec_hw_sgl {
    dma_addr_t next_sgl;
    u16 entry_sum_in_chain;
    u16 entry_sum_in_sgl;
    u32 flag;
    u64 serial_num;
    u32 cpuid;
    u32 data_bytes_in_sgl;
    struct sec_hw_sgl *next;
    u64 reserved;
    struct sec_hw_sge  sge_entries[SEC_MAX_SGE_NUM];
    u8 node[16];
 };

🎀 Members 🎀

vibe check on every member, one by one:

• next_sgl — the next entry if we need to chain a dma address. it’s Null if last. 🫶
• entry_sum_in_chain — the full count of SGEs — only matters for first SGL. noted, bestie.
• entry_sum_in_sgl — the number of SGEs in this SGL element.
• flag — unused in skciphers. periodt.
• serial_num — also unused in skciphers (the original spells it “Unsued in skciphers” 😭 iconic typo energy, but the meaning is still “unused”).
• cpuid — currently unused.
• data_bytes_in_sgl — count of bytes from all SGEs in this SGL.
• next — virtual address used to stash the next sgl — useful in completion.
• reserved — a reserved field not currently used.
• sge_entries — the (up to) 64 Scatter Gather Entries, representing IOVs. she ate.
• node — currently unused.

🔎 SEE ALSO 🔎

kernel file ./drivers/crypto/hisilicon/sec/sec_drv.h — go peek at these cuties:

• struct sec_queue_ring_cmd(9)
• struct sec_alg_tfm_ctx(9)
• struct sec_request(9)
• struct sec_request_el(9)
• struct sec_queue(9)
• struct sec_hw_sge(9)
• struct sec_dev_info(9)

okay that’s the whole page, bestie 💖 — source/version vibe: ./drivers/crypto/hisilicon/sec, October 2026, struct sec_hw_sgl(9). byeee 👑✨