STRUCT DRM_IVPU_BO_CREATE(9)

Hiii bestie! 💖 This is struct drm_ivpu_bo_create(9) from the Kernel API Manual — the page that’s literally all about creating a BO backed by SHMEM. Let’s get into it ✨

🎀 NAME 🎀

struct drm_ivpu_bo_create — Create BO backed by SHMEM 🫶

✨ SYNOPSIS ✨

       struct drm_ivpu_bo_create {
           __u64 size;
           __u32 flags;
           __u32 handle;
           __u64 vpu_addr;
        };

💅 Members 💅

• size — The size in bytes of the allocated memory 📏
• flags — Supported flags:
  • DRM_IVPU_BO_HIGH_MEM — Allocate VPU address from >4GB range. Buffer object with vpu address >4GB can be always accessed by the VPU DMA engine, but some HW generation may not be able to access this memory from then firmware running on the VPU management processor 😭 Suitable for input, output and some scratch buffers.
  • DRM_IVPU_BO_MAPPABLE — Buffer object can be mapped using mmap 🗺️
  • DRM_IVPU_BO_CACHED — Allocated BO will be cached on host side (WB) and snooped on the VPU side. This is the default caching mode ✨
  • DRM_IVPU_BO_UNCACHED — Not supported. Use DRM_IVPU_BO_WC instead 💀
  • DRM_IVPU_BO_WC — Allocated BO will use write combining buffer for writes but reads will be uncached 🧚
• handle — Returned GEM object handle 🎀
• vpu_addr — Returned VPU virtual address 🌸

🌈 Description 🌈

The whole vibe: create GEM buffer object allocated in SHMEM memory. Periodt. 💅

🦋 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_from_userptr(9)
• struct drm_ivpu_bo_info(9)
• struct drm_ivpu_submit(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)

This page’s source/version is ./include/uapi/drm, dated October 2026 — mwah, bestie 💋