STRUCT SND_COMPR_RUNTIME(9)

💖 NAME 💖

okay bestie, this is struct snd_compr_runtime(9) from the Kernel API Manual ✨ and it's literally the runtime stream description — core-struct main character energy, no cap 👑💅

🌸 SYNOPSIS 🌸

here's the whole struct exactly as it appears — do not paraphrase this one, bestie, copy it character for character 😭🫶

       struct snd_compr_runtime {
           snd_pcm_state_t state;
           struct snd_compr_ops *ops;
           void *buffer;
           u64 buffer_size;
           u32 fragment_size;
           u32 fragments;
           u64 total_bytes_available;
           u64 total_bytes_transferred;
           wait_queue_head_t sleep;
           void *private_data;
           unsigned char *dma_area;
           dma_addr_t dma_addr;
           size_t dma_bytes;
           struct snd_dma_buffer *dma_buffer_p;
         #if IS_ENABLED(CONFIG_SND_COMPRESS_ACCEL);
           u32 active_tasks;
           u32 total_tasks;
           u64 task_seqno;
           struct list_head tasks;
         #endif;
        };

💅 Members 💅

vibe check on every field, one by one 🦋

• state — stream state 🌈
• ops — pointer to DSP callbacks 🎀
• buffer — pointer to kernel buffer, valid only when not in mmap mode or DSP doesn't implement copy 💖
• buffer_size — size of the above buffer ✨
• fragment_size — size of buffer fragment in bytes 🍓
• fragments — number of such fragments 🧚
• total_bytes_available — cumulative number of bytes made available in the ring buffer 🔥
• total_bytes_transferred — cumulative bytes transferred by offload DSP ⭐
• sleep — poll sleep 💤
• private_data — driver private data pointer 🔐
• dma_area — virtual buffer address 🦋
• dma_addr — physical buffer address (not accessible from main CPU) 👀
• dma_bytes — size of DMA area 📏
• dma_buffer_p — runtime dma buffer pointer 🎯
• active_tasks — count of active tasks ⚡
• total_tasks — count of all tasks 🗂️
• task_seqno — last task sequence number (!= 0) 🔢
• tasks — list of all tasks 📋

tiny heads-up bestie: the active_tasks, total_tasks, task_seqno, and tasks fields are sitting inside the #if IS_ENABLED(CONFIG_SND_COMPRESS_ACCEL); block, and the #endif; is exactly as shown 💅

🦋 SEE ALSO 🦋

go read these next, bestie 🫶💜

• Kernel file ./include/sound/compress_driver.h struct snd_compr_task_runtime(9)
• struct snd_compr_stream(9)
• struct snd_compr_ops(9)
• struct snd_compr(9)
• snd_compr_use_pause_in_draining(9)
• snd_compr_set_runtime_buffer(9)

okay that's the whole page, bestie — source ./include/sound, date October 2026, title struct snd_compr_runtime(9) — slay and bye 💋✨💖