STRUCT DRM_IVPU_SUBMIT(9)

💅 struct drm_ivpu_submit(9) — submit commands to the VPU 💅

okay bestie, welcome to the Kernel API Manual corner 💖 today’s main character is struct drm_ivpu_submit, and the whole vibe is Submit commands to the VPU. periodt.

✨ NAME ✨

• struct drm_ivpu_submit — Submit commands to the VPU

🎀 SYNOPSIS 🎀

struct drm_ivpu_submit {
    __u64 buffers_ptr;
    __u32 buffer_count;
    __u32 engine;
    __u32 flags;
    __u32 commands_offset;
    __u32 priority;
};

🫶 Members 🫶

• buffers_ptr — A pointer to an u32 array of GEM handles of the BOs required for this job. The number of elements in the array must be equal to the value given by buffer_count.

The first BO is the command buffer. The rest of array has to contain all BOs referenced from the command buffer.

• buffer_count — Number of elements in the buffers_ptr
• engine — Select the engine this job should be executed on
  • DRM_IVPU_ENGINE_COMPUTE — Performs Deep Learning Neural Compute Inference Operations
• flags — Reserved for future use - must be zero
• commands_offset — Offset inside the first buffer in buffers_ptr containing commands to be executed. The offset has to be 8-byte aligned.
• priority — Priority to be set for related job command queue, can be one of the following:
  • DRM_IVPU_JOB_PRIORITY_DEFAULT
  • DRM_IVPU_JOB_PRIORITY_IDLE
  • DRM_IVPU_JOB_PRIORITY_NORMAL
  • DRM_IVPU_JOB_PRIORITY_FOCUS
  • DRM_IVPU_JOB_PRIORITY_REALTIME

🦋 Description 🦋

Execute a single command buffer on a given VPU engine. Handles to all referenced buffer objects have to be provided in buffers_ptr.

User space may wait on job completion using DRM_IVPU_BO_WAIT ioctl.

🌈 SEE ALSO 🌈

• Kernel file ./include/uapi/drm/ivpu_accel.h
• contexts(9)
• DRM_IVPU_CAP_METRIC_STREAMER(9)
• DRM_IVPU_CAP_DMA_MEMORY_RANGE(9)
• DRM_IVPU_CAP_MANAGE_CMDQ(9)
• DRM_IVPU_CAP_BO_CREATE_FROM_USERPTR(9)
• struct drm_ivpu_param(9)
• struct drm_ivpu_bo_create(9)
• struct drm_ivpu_bo_create_from_userptr(9)
• struct drm_ivpu_bo_info(9)
• struct drm_ivpu_cmdq_submit(9)
• struct drm_ivpu_bo_wait(9)
• struct drm_ivpu_metric_streamer_start(9)
• struct drm_ivpu_metric_streamer_get_data(9)
• struct drm_ivpu_cmdq_create(9)
• struct drm_ivpu_cmdq_destroy(9)
• struct drm_ivpu_metric_streamer_stop(9)

signed, sealed, slayed by ./include/uapi/drm, dated October 2026, all for struct drm_ivpu_submit(9) 🫶💖