STRUCT DRM_ASAHI_VM_CREATE(9)

✨ struct drm_asahi_vm_create(9) ✨

okay so bestie, buckle up — this is a page from the Kernel API Manual, and it's literally all about the struct drm_asahi_vm_create situation. it's the arguments you pass to DRM_IOCTL_ASAHI_VM_CREATE, i.e. the lil' bundle of info that tells the kernel "hey, make me a VM bestie 💖". it's giving paperwork but make it iconic.

🎀 SYNOPSIS 🎀

struct drm_asahi_vm_create {
    __u64 kernel_start;
    __u64 kernel_end;
    __u32 vm_id;
    __u32 pad;
 };

🌸 Members 🌸

• kernel_start — where the kernel-reserved address range starts. see drm_asahi_params_global::vm_kernel_min_size for the deets.

okay so this next bit is important, bestie, don't scroll past it 🙈 — both kernel_start and kernel_end have to land inside the range of valid VAs that drm_asahi_params_global::vm_start and drm_asahi_params_global::vm_end give you. and the size of the kernel range (kernel_end - kernel_start) has to be at least drm_asahi_params_global::vm_kernel_min_size. no cap. 💅

🚨 and listen — userspace must not bind any memory on this VM into this reserved range. it's for kernel use only, periodt. that range is not yours, it's the kernel's main character energy. don't touch. 🔥

• kernel_end — where the kernel-reserved address range ends. see kernel_start above, they're a matched set 🫶.
• vm_id — the returned VM ID ✨ (yes, this one comes back to you, it's the whole point).
• pad — MBZ. (that's "must be zero", bestie — not "maybe zero", not "zero if you feel like it". zero it. 💀)

👑 SEE ALSO 👑

• Kernel file ./include/uapi/drm/asahi_drm.h
• Introduction to the Asahi UAPI(9)
• enum drm_asahi_ioctl_id(9)
• struct drm_asahi_params_global(9)
• enum drm_asahi_feature(9)
• struct drm_asahi_get_params(9)
• struct drm_asahi_vm_destroy(9)
• enum drm_asahi_gem_flags(9)
• struct drm_asahi_gem_create(9)
• struct drm_asahi_gem_mmap_offset(9)
• enum drm_asahi_bind_flags(9)
• struct drm_asahi_gem_bind_op(9)
• struct drm_asahi_vm_bind(9)
• enum drm_asahi_bind_object_op(9)
• enum drm_asahi_bind_object_flags(9)
• struct drm_asahi_gem_bind_object(9)
• enum drm_asahi_cmd_type(9)
• enum drm_asahi_priority(9)
• struct drm_asahi_queue_create(9)
• struct drm_asahi_queue_destroy(9)
• enum drm_asahi_sync_type(9)
• struct drm_asahi_sync(9)
• DRM_ASAHI_BARRIER_NONE(9)
• struct drm_asahi_cmd_header(9)
• struct drm_asahi_submit(9)
• struct drm_asahi_attachment(9)
• struct drm_asahi_zls_buffer(9)
• struct drm_asahi_timestamp(9)
• struct drm_asahi_timestamps(9)
• struct drm_asahi_helper_program(9)
• struct drm_asahi_bg_eot(9)
• struct drm_asahi_cmd_render(9)
• struct drm_asahi_cmd_compute(9)
• struct drm_asahi_get_time(9)
• DRM_IOCTL_ASAHI(9)

that's the whole vibe check, bestie — go forth and create your VMs responsibly 🦋💜

this lil' page lives in ./include/uapi/drm, dated October 2026, and it's filed under struct drm_asahi_vm_create(9) — mwah, sending you off with a 🎀 and a ⭐, iykyk 🌈