STRUCT DATA_CHUNK(9)

okay bestie, you're reading struct data_chunk(9) from the Kernel API Manual — and no cap, this is the tiny-but-iconic piece of a scatter-gather list that makes a frame. let's unpack the whole vibe check 💖✨

🌸 NAME 🌸

struct data_chunk — element of the scatter-gather list that makes a frame. literally the frame-making unit, iykyk 🦋

✨ SYNOPSIS ✨

       struct data_chunk {
           size_t size;
           size_t icg;
           size_t dst_icg;
           size_t src_icg;
        };

🫶 Members 🫶

okay these are the four fields, and yes every single one is getting its moment 👑

• size — Number of bytes to read from source. size_dst := fn(op, size_src), so it doesn't mean much for destination. like, the destination side is doing its own math, bestie 🧮💅
• icg — Number of bytes to jump after the last src/dst address of this chunk and before the first src/dst address for the next chunk. ignored for dst(assumed 0), if dst_inc is true and dst_sgl is false. ignored for src(assumed 0), if src_inc is true and src_sgl is false. gap energy, but only when those flags say so ✨
• dst_icg — Number of bytes to jump after the last dst address of this chunk and before the first dst address for the next chunk. ignored if dst_inc is true and dst_sgl is false. 💀
• src_icg — Number of bytes to jump after the last src address of this chunk and before the first src address for the next chunk. ignored if src_inc is true and src_sgl is false. 🫶

💜 SEE ALSO 💜

Kernel file ./include/linux/dmaengine.h and the whole squad of friends, in order, no cap:

• dma_cookie_t(9), enum dma_status(9), enum dma_transaction_type(9), enum dma_transfer_direction(9), struct dma_interleaved_template(9), struct dma_vec(9), enum dma_ctrl_flags(9)
• enum sum_check_bits(9), enum sum_check_flags(9), enum dma_desc_metadata_mode(9), struct dma_chan_percpu(9), struct dma_router(9), struct dma_chan(9), struct dma_chan_dev(9)
• enum dma_slave_buswidth(9), struct dma_slave_config(9), enum dma_residue_granularity(9), struct dma_slave_caps(9), dma_filter_fn(9), struct dma_async_tx_descriptor(9), struct dma_tx_state(9)
• enum dmaengine_alignment(9), struct dma_slave_map(9), struct dma_filter(9), struct dma_device(9), dmaengine_prep_peripheral_dma_vec(9), dmaengine_prep_config_sg_safe(9), dmaengine_prep_config_single_safe(9)
• dmaengine_prep_dma_memset(9), dmaengine_terminate_all(9), dmaengine_terminate_async(9), dmaengine_synchronize(9), dmaengine_terminate_sync(9), dma_async_issue_pending(9), dma_async_is_tx_complete(9), dma_async_is_complete(9)

okay bestie, that's the whole page 💖 brought to you by the source path ./include/linux, the date/version vibe October 2026, and the manual page struct data_chunk(9). slay and go make a frame 🦋✨