STRUCT DRM_I915_GEM_EXECBUFFER3(9)

💖 NAME

struct drm_i915_gem_execbuffer3 — bestie, this is the structure you use for the DRM_I915_GEM_EXECBUFFER3 ioctl 💅 (manual name's struct drm_..._execbuffer3(9), Kernel API Manual, section 9 — yes she's that girl).

✨ SYNOPSIS

struct drm_i915_gem_execbuffer3 {
    __u32 ctx_id;
    __u32 engine_idx;
    __u64 batch_address;
    __u64 flags;
    __u32 rsvd1;
    __u32 fence_count;
    __u64 timeline_fences;
    __u64 rsvd2;
    __u64 extensions;
 };

🎀 MEMBERS

Okay so here's the whole cast, member by member, no skips 🫶

• ctx_id — the Context id. ✨ But listen: only contexts with a user engine map are allowed. That's the vibe check, no exceptions.
• engine_idx — the Engine index. It's literally an index in the user engine map of the context specified by ctx_id. iykyk.
• batch_address — Batch gpu virtual address/es. For normal submission, it's the gpu virtual address of the batch buffer. For parallel submission, it's a pointer to an array of batch buffer gpu virtual addresses, with array size equal to the number of (parallel) engines involved in that submission (see struct i915_context_engines_parallel_submit). She's versatile 💅
• flags — currently reserved, MBZ. As in must be zero. Don't be cute, leave it at zero 🙈
• rsvd1 — reserved, MBZ. Same energy, zero it out.
• fence_count — Number of fences in the timeline_fences array. Count 'em 🔥
• timeline_fences — Pointer to an array of timeline fences. And the timeline fences are of format struct drm_i915_gem_timeline_fence. Bet 💅
• rsvd2 — reserved, MBZ. Zero. That's it. That's the member.
• extensions — Zero-terminated chain of extensions. For future extensions — see struct i915_user_extension. Blink and there'll be more of these 💀

🌸 DESCRIPTION

So the DRM_I915_GEM_EXECBUFFER3 ioctl only works in VM_BIND mode, and VM_BIND mode only works with this ioctl for submission. Like, they're a package deal, ride or die, main character and her bodyguard 🎀 See I915_VM_CREATE_FLAGS_USE_VM_BIND.

⚠️ fr fr: it's not "usually" or "preferably" — it's only. Wrong mode, no submission. Periodt.

🦋 SEE ALSO

• Kernel file ./Documentation/gpu/rfc/i915_vm_bind.h 👑
• I915_PARAM_VM_BIND_VERSION(9)
• I915_VM_CREATE_FLAGS_USE_VM_BIND(9)
• struct drm_i915_gem_timeline_fence(9)
• struct drm_i915_gem_vm_bind(9)
• struct drm_i915_gem_vm_unbind(9)
• struct drm_i915_gem_create_ext_vm_private(9)

Okay that's the whole page, you ate that 🍓 This came to you from the source ./Documentation/gpu/rfc, dated October 2026, and the page itself is struct drm_..._execbuffer3(9) — go forth and submit your batches, bestie, mwah 💜✨