STRUCT HVA_CTX_DBG(9)

💖 NAME 💖

okay so bestie, this is struct hva_ctx_dbg(9) from the Kernel API Manual — literally the instance context debug info struct, and it's giving “debug stats but make it a whole struct” main character energy. no cap. 💅

✨ SYNOPSIS ✨

here's the whole struct exactly as it appears, bestie — don't let the alignment jumpscare you:

       struct hva_ctx_dbg {
           struct dentry   *debugfs_entry;
           bool is_valid_period;
           ktime_t begin;
           u32 total_duration;
           u32 cnt_duration;
           u32 min_duration;
           u32 max_duration;
           u32 avg_duration;
           u32 max_fps;
           u32 total_period;
           u32 cnt_period;
           u32 min_period;
           u32 max_period;
           u32 avg_period;
           u32 total_stream_size;
           u32 avg_fps;
           u32 window_duration;
           u32 cnt_window;
           u32 window_stream_size;
           u32 last_bitrate;
           u32 min_bitrate;
           u32 max_bitrate;
           u32 avg_bitrate;
        };

🎀 Members 🎀

the struct's members, aka the little besties inside — obsessed:

• debugfs_entry — debugfs entry. iconic.
• is_valid_period — true if the sequence is valid for performance.
• begin — start time of last HW task.
• total_duration — total HW processing durations in 0.1ms.
• cnt_duration — number of HW processings.
• min_duration — minimum HW processing duration in 0.1ms.
• max_duration — maximum HW processing duration in 0.1ms.
• avg_duration — average HW processing duration in 0.1ms.
• max_fps — maximum frames encoded per second (in 0.1Hz).
• total_period — total encoding periods in 0.1ms.
• cnt_period — number of periods.
• min_period — minimum encoding period in 0.1ms.
• max_period — maximum encoding period in 0.1ms.
• avg_period — average encoding period in 0.1ms.
• total_stream_size — total number of encoded bytes.
• avg_fps — average frames encoded per second (in 0.1Hz).
• window_duration — duration of the sampling window in 0.1ms.
• cnt_window — number of samples in the window.
• window_stream_size — number of encoded bytes upon the sampling window — yes, upon, that's the word, no cap.
• last_bitrate — bitrate upon the last sampling window.
• min_bitrate — minimum bitrate in kbps.
• max_bitrate — maximum bitrate in kbps.
• avg_bitrate — average bitrate in kbps.

🌈 SEE ALSO 🌈

check out the Kernel file ./drivers/media/platform/st/sti/hva/hva.h and its struct besties: struct hva_frameinfo(9), struct hva_streaminfo(9), struct hva_controls(9), struct hva_frame(9), struct hva_stream(9), struct hva_ctx(9), struct hva_dev_dbg(9), struct hva_dev(9), and struct hva_enc(9). yeah, it's a whole friend group, iykyk 💅

okay bye bestie 🫶 this page lives at ./drivers/media/platform/st/st..., dated October 2026, and it's all about struct hva_ctx_dbg(9) — slay, mwah 💖