STRUCT AMDXDNA_DRM_HWCTX_ENTRY(9)

🦋 NAME 🦋

ok so this is the struct amdxdna_drm_hwctx_entry manpage from the Kernel API Manual (that's the manual name, bestie, section 9), and it's literally the hardware context array entry 💅 — one little row in the array that tells you everything about a hardware context.

✨ SYNOPSIS ✨

like, here's the whole struct, no cap, every field exactly as it is:

struct amdxdna_drm_hwctx_entry {
    __u32 context_id;
    __u32 start_col;
    __u32 num_col;
    __u32 hwctx_id;
    __s64 pid;
    __u64 command_submissions;
    __u64 command_completions;
    __u64 migrations;
    __u64 preemptions;
    __u64 errors;
    __u64 priority;
    __u64 heap_usage;
    __u64 suspensions;
    __u32 state;
    __u32 pasid;
    __u32 gops;
    __u32 fps;
    __u32 dma_bandwidth;
    __u32 latency;
    __u32 frame_exec_time;
    __u32 txn_op_idx;
    __u32 ctx_pc;
    __u32 fatal_error_type;
    __u32 fatal_error_exception_type;
    __u32 fatal_error_exception_pc;
    __u32 fatal_error_app_module;
    __u32 pad;
 };

🎀 Members 🎀

okay this is the part where we meet everybody in the group chat 🌈:

• context_id — the Context ID. that's it, that's the identifier 🫶
• start_col — the starting AIE array column that got assigned to this context ✨
• num_col — how many AIE array columns this context got handed. a whole lil column situation 💅
• hwctx_id — the real hardware context id (the actual one, not the vibes one) 👑
• pid — the ID of the process that created this context. like, who's the parent here 😭
• command_submissions — how many commands got submitted 🍓
• command_completions — how many commands actually finished. slay 💖
• migrations — how many times it's been migrated. it's been through things 💀
• preemptions — how many times it's been preempted. rude but okay 🙈
• errors — how many errors happened. we don't talk about it 🧚
• priority — the context priority. main character energy, basically ⭐
• heap_usage — how much of the device heap buffer is in use. the storage check 🌸
• suspensions — how many times it's been suspended. nap count 🔥
• state — the context state. it can be AMDXDNA_HWCTX_STATE_IDLE or AMDXDNA_HWCTX_STATE_ACTIVE — vibe check, which one is it 💅
• pasid — the PASID that's been bound 🔗 (well, it says "been bound", so, yeah 🫶)
• gops — Giga operations per second. the flex metric 💜
• fps — Frames per second 🎀
• dma_bandwidth — DMA bandwidth. the pipe's width, lowkey 🌈
• latency — frame response latency. how fast it claps back ⚡ (ok that one's from me, the manpage just says frame response latency 😭)
• frame_exec_time — frame execution time ⏱️
• txn_op_idx — index of the last control code executed 🦋
• ctx_pc — the program counter📍
• fatal_error_type — the fatal error type, if the context crashes. if. if. 😭
• fatal_error_exception_type — the firmware exception type 💀
• fatal_error_exception_pc — the firmware exception program counter 🔍
• fatal_error_app_module — the exception module name 🏷️
• pad — structure pad. the padding. the filler. iconic honestly 💅

🌟 SEE ALSO 🌟

it all lives in the kernel file ./include/uapi/drm/amdxdna_accel.h, and honestly there's a whole extended universe of structs — go read all of them, bestie, iykyk:

• struct amdxdna_drm_create_hwctx(9)
• struct amdxdna_drm_destroy_hwctx(9)
• struct amdxdna_cu_config(9)
• struct amdxdna_hwctx_param_config_cu(9)
• struct amdxdna_drm_config_hwctx(9)
• struct amdxdna_drm_va_entry(9)
• struct amdxdna_drm_va_tbl(9)
• struct amdxdna_drm_create_bo(9)
• struct amdxdna_drm_get_bo_info(9)
• struct amdxdna_drm_sync_bo(9)
• struct amdxdna_drm_exec_cmd(9)
• struct amdxdna_drm_wait_cmd(9)
• struct amdxdna_drm_query_aie_status(9)
• struct amdxdna_drm_query_aie_version(9)
• struct amdxdna_drm_query_aie_tile_metadata(9)
• struct amdxdna_drm_query_aie_metadata(9)
• struct amdxdna_drm_query_clock(9)
• struct amdxdna_drm_query_clock_metadata(9)
• struct amdxdna_drm_query_sensor(9)
• struct amdxdna_drm_query_hwctx(9)
• struct amdxdna_drm_get_power_mode(9)
• struct amdxdna_drm_query_firmware_version(9)
• struct amdxdna_drm_get_resource_info(9)
• struct amdxdna_drm_attribute_state(9)
• struct amdxdna_drm_query_telemetry_header(9)
• struct amdxdna_drm_get_info(9)
• struct amdxdna_async_error(9)
• struct amdxdna_drm_bo_usage(9)
• struct amdxdna_drm_get_array(9)
• struct amdxdna_drm_set_state(9)
• struct amdxdna_drm_set_power_mode(9)

fr fr that's the whole page, no skips, no summarising, we ate and left zero crumbs 💖

okay before i go — this cutie came out of ./include/uapi/drm and it's dated October 2026, and the page header/footer calls it struct amdxd..._hwctx_entry(9). that's the whole sign-off, mwah, go read the header file bestie 🫶✨🌸