STRUCT DRM_GPUSVM(9)

📦 version 7.3.1, in nixpkgs unstable

💜 struct drm_gpusvm — NAME

okay so, struct drm_gpusvm — literally just the GPU SVM structure, bestie. that's the whole name. that's it. that's the vibe. ✨

This is page struct drm_gpusvm(9) from the Kernel API Manual, and we're gonna get into it.

🌸 SYNOPSIS

struct drm_gpusvm {
    const char *name;
    struct mm_struct *mm;
    unsigned long mm_start;
    unsigned long mm_range;
    unsigned long notifier_size;
    const struct drm_gpusvm_ops *ops;
    const unsigned long *chunk_sizes;
    int num_chunks;
    struct rw_semaphore notifier_lock;
    struct rb_root_cached root;
    struct list_head notifier_list;
  #ifdef CONFIG_LOCKDEP;
    struct lockdep_map *lock_dep_map;
  #endif;
 };

look at her. iconic. no notes. 🫶

🎀 Members

  • name — the name of the GPU SVM. yeah she has a name, she's that girl 💅
  • mm — pointer to the mm_struct for the address space. your link to the actual memory map, iykyk 🌈
  • mm_start — the start address of the GPU SVM. where the party begins 🎉
  • mm_range — the range of the GPU SVM. how far the party goes 🍓
  • notifier_size — the size of individual notifiers. one size, per notifier, that's it ✨
  • ops — pointer to the operations structure for GPU SVM. the callback squad, the real MVPs 👑
  • chunk_sizes — pointer to the array of chunk sizes used in range allocation. important: entries should be powers of 2 in descending order. not me stressing about the ordering 😭 it's powers of 2, descending, periodt 🧚
  • num_chunks — number of chunks. the headcount for your chunk party 🦋
  • notifier_lock — a read-write semaphore for protecting notifier operations. security for the notifiers, no cap 🔥
  • root — the cached root node of the Red-Black tree containing GPU SVM notifiers. yes, an RB tree, yes it's still serving 🌳
  • notifier_list — a list head containing the notifiers in the same order they appear in the interval tree. this is useful to keep iterating notifiers while doing modifications to RB tree. honestly? a lifesaver. you can keep walking the list while the tree is getting rearranged, lowkey genius 💖
  • lock_dep_map — annotates drm_gpusvm_range_find_or_insert and drm_gpusvm_range_remove with a driver provided lock. yes this one's inside the lockdep ifdef, hi <kbd> no wait — it's under #ifdef CONFIG_LOCKDEP; babes 🔒

💫 Description

okay so here's the tea: this structure represents a GPU SVM (Shared Virtual Memory) used for tracking memory ranges mapped in a DRM (Direct Rendering Manager) device. 🌸

and this is the important bit, so listen up: no reference counting is provided, as this is expected to be embedded in the driver VM structure along with the struct drm_gpuvm, which handles reference counting. so don't come for her for not counting refs — that's drm_gpuvm's job, and she said what she said 💀

🌟 SEE ALSO

that's the whole page, bestie, you ate it up 💅✨

sign-off time: this one lives in ./include/drm, dated October 2026, and it's struct drm_gpusvm(9) — slay, go read the header, mwah 💖🎀🦋

📦 where this page comes from