Register device memory for poison handling
Subsystems (6)
[email protected]
maintainerv2 cover Register device memory for poison handling
From: Ankit Agrawal <[email protected]>
Linux MM provides interfaces to allow a driver to [un]register device memory not backed by struct page for poison handling through memory_failure.
The device memory on NVIDIA Grace based systems are not added to the kernel and are not backed by struct pages. So nvgrace-gpu module which manages the device memory can make use of these interfaces to get the benefit of poison handling. Make nvgrace-gpu register the device memory with the MM on open.
Moreover, the stubs are added to accommodate for CONFIG_MEMORY_FAILURE being disabled.
Patch 1/2 introduces stubs for CONFIG_MEMORY_FAILURE disabled. Patch 2/2 registers the device memory at the time of open instead of mmap.
Note that this is a reposting of an earlier series [1] which is partly (patch 1/3) merged to v6.19-rc4. This one addresses the leftover patching. Many thanks to Jason Gunthorpe ([email protected]) and Alex Williamson ([email protected]) for valuable suggestions.
Changelog:
v2:
- Fixed nit to cleanup nvgrace_gpu_vfio_pci_register_pfn_range (Thanks Jiaqi Yan)
Ankit Agrawal (2):
mm: add stubs for PFNMAP memory failure registration functions vfio/nvgrace-gpu: register device memory for poison handling
drivers/vfio/pci/nvgrace-gpu/main.c | 113 +++++++++++++++++++++++++++- include/linux/memory-failure.h | 13 +++- 2 files changed, 120 insertions(+), 6 deletions(-)
Signature · 1 line
2.34.1
[email protected]
maintainerPATCH v2 1/2 mm: add stubs for PFNMAP memory failure registration functions
From: Ankit Agrawal <[email protected]>
Add stubs to address CONFIG_MEMORY_FAILURE disabled.
--- include/linux/memory-failure.h | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-)
include/linux/memory-failure.h +11 -2
@@ -4,8 +4,6 @@#include <linux/interval_tree.h> -struct pfn_address_space ; -struct pfn_address_space {struct interval_tree_node node;struct address_space *mapping;
@@ -13,7 +11,18 @@ struct pfn_address_space { unsigned long pfn, pgoff_t *pgoff); }; +#ifdef CONFIG_MEMORY_FAILURE int register_pfn_address_space (struct pfn_address_space *pfn_space);void unregister_pfn_address_space (struct pfn_address_space *pfn_space); +#else +static inline int register_pfn_address_space (struct pfn_address_space *pfn_space) +{ +return -EOPNOTSUPP ; +} + +static inline void unregister_pfn_address_space (struct pfn_address_space *pfn_space) +{ +} +#endif /* CONFIG_MEMORY_FAILURE */ #endif /* _LINUX_MEMORY_FAILURE_H */
Signature · 1 line
2.34.1
[email protected]
maintainerPATCH v2 2/2 vfio/nvgrace-gpu: register device memory for poison handling
In reply to [email protected]From: Ankit Agrawal <[email protected]>
The nvgrace-gpu module [1] maps the device memory to the user VA (Qemu) without adding the memory to the kernel. The device memory pages are PFNMAP and not backed by struct page. The module can thus utilize the MM's PFNMAP memory_failure mechanism that handles ECC/poison on regions with no struct pages.
The kernel MM code exposes register/unregister APIs allowing modules to register the device memory for memory_failure handling. Make nvgrace-gpu register the GPU memory with the MM on open.
The module registers its memory region, the address_space with the kernel MM for ECC handling and implements a callback function to convert the PFN to the file page offset. The callback functions checks if the PFN belongs to the device memory region and is also contained in the VMA range, an error is returned otherwise.
--- drivers/vfio/pci/nvgrace-gpu/main.c | 113 +++++++++++++++++++++++++++- 1 file changed, 109 insertions(+), 4 deletions(-)
drivers/vfio/pci/nvgrace-gpu/main.c +109 -4
@@ -9,6 +9,7 @@#include <linux/jiffies.h> #include <linux/pci-p2pdma.h> #include <linux/pm_runtime.h> +#include <linux/memory-failure.h> /* * The device memory usable to the workloads running in the VM is cached
@@ -49,6 +50,7 @@ struct mem_region {void *memaddr;void __iomem *ioaddr; };/* Base virtual address of the region */ +struct pfn_address_space pfn_address_space; };struct nvgrace_gpu_pci_core_device {
@@ -88,6 +90,80 @@ nvgrace_gpu_memregion(int index,return NULL ; } +static int pfn_memregion_offset (struct nvgrace_gpu_pci_core_device *nvdev, +unsigned int index, +unsigned long pfn, +pgoff_t *pfn_offset_in_region) +{ +struct mem_region *region; +unsigned long start_pfn, num_pages; + + region =nvgrace_gpu_memregion (index, nvdev); +if (!region) +return -EINVAL ; + + start_pfn =PHYS_PFN (region->memphys); + num_pages = region->memlength >>PAGE_SHIFT ; + +if (pfn < start_pfn || pfn >= start_pfn + num_pages) +return -EFAULT ; + + *pfn_offset_in_region = pfn - start_pfn; + +return 0 ; +} + +static inline +struct nvgrace_gpu_pci_core_device *vma_to_nvdev (struct vm_area_struct *vma); + +static int nvgrace_gpu_pfn_to_vma_pgoff (struct vm_area_struct *vma, +unsigned long pfn, +pgoff_t *pgoff) +{ +struct nvgrace_gpu_pci_core_device *nvdev; +unsigned int index = + vma->vm_pgoff >> (VFIO_PCI_OFFSET_SHIFT -PAGE_SHIFT ); +pgoff_t vma_offset_in_region = vma->vm_pgoff & + ((1U << (VFIO_PCI_OFFSET_SHIFT -PAGE_SHIFT )) -1 ); +pgoff_t pfn_offset_in_region; +int ret; + + nvdev =vma_to_nvdev (vma); +if (!nvdev) +return -ENOENT ; + + ret =pfn_memregion_offset (nvdev, index, pfn, &pfn_offset_in_region); +if (ret) +return ret; + +/* Ensure PFN is not before VMA's start within the region */ +if (pfn_offset_in_region < vma_offset_in_region) +return -EFAULT ; + +/* Calculate offset from VMA start */ + *pgoff = vma->vm_pgoff + + (pfn_offset_in_region - vma_offset_in_region); + +return 0 ; +} + +static int +nvgrace_gpu_vfio_pci_register_pfn_range (struct vfio_device *core_vdev, +struct mem_region *region) +{ +unsigned long pfn, nr_pages; + + pfn =PHYS_PFN (region->memphys); + nr_pages = region->memlength >>PAGE_SHIFT ; + + region->pfn_address_space.node.start = pfn; + region->pfn_address_space.node.last = pfn + nr_pages -1 ; + region->pfn_address_space.mapping = core_vdev->inode->i_mapping; + region->pfn_address_space.pfn_to_vma_pgoff = nvgrace_gpu_pfn_to_vma_pgoff; + +return register_pfn_address_space (®ion->pfn_address_space); +} +static int nvgrace_gpu_open_device (struct vfio_device *core_vdev) { struct vfio_pci_core_device *vdev =
@@ -114,14 +190,28 @@ static int nvgrace_gpu_open_device(struct vfio_device *core_vdev)* memory mapping. */ ret =vfio_pci_core_setup_barmap (vdev,0 ); -if (ret) { -vfio_pci_core_disable (vdev); -return ret; +if (ret) + goto error_exit; + +if (nvdev->resmem.memlength) { + ret =nvgrace_gpu_vfio_pci_register_pfn_range (core_vdev, &nvdev->resmem); +if (ret && ret != -EOPNOTSUPP ) + goto error_exit; } -vfio_pci_core_finish_enable (vdev); + ret =nvgrace_gpu_vfio_pci_register_pfn_range (core_vdev, &nvdev->usemem); +if (ret && ret != -EOPNOTSUPP ) + goto register_mem_failed; +vfio_pci_core_finish_enable (vdev);return 0 ; + +register_mem_failed: +if (nvdev->resmem.memlength) +unregister_pfn_address_space (&nvdev->resmem.pfn_address_space); +error_exit: +vfio_pci_core_disable (vdev); +return ret; }static void nvgrace_gpu_close_device (struct vfio_device *core_vdev)
@@ -130,6 +220,11 @@ static void nvgrace_gpu_close_device(struct vfio_device *core_vdev) container_of(core_vdev, struct nvgrace_gpu_pci_core_device, core_device.vdev); +if (nvdev->resmem.memlength) +unregister_pfn_address_space (&nvdev->resmem.pfn_address_space); + +unregister_pfn_address_space (&nvdev->usemem.pfn_address_space); +/* Unmap the mapping to the device memory cached region */ if (nvdev->usemem.memaddr) {memunmap (nvdev->usemem.memaddr);
@@ -247,6 +342,16 @@ static const struct vm_operations_struct nvgrace_gpu_vfio_pci_mmap_ops = {#endif }; +static inline +struct nvgrace_gpu_pci_core_device *vma_to_nvdev (struct vm_area_struct *vma) +{ +/* Check if this VMA belongs to us */ +if (vma->vm_ops != &nvgrace_gpu_vfio_pci_mmap_ops) +return NULL ; + +return vma->vm_private_data; +} +static int nvgrace_gpu_mmap (struct vfio_device *core_vdev,struct vm_area_struct *vma) {
Signature · 1 line
2.34.1
Re: [PATCH v2 2/2] vfio/nvgrace-gpu: register device memory for poison handling
Quoted 192 lines · On Thu, Jan 15, 2026 at 12:29 PM <[email protected]> wrote:
From: Ankit Agrawal <[email protected]>
The nvgrace-gpu module [1] maps the device memory to the user VA (Qemu) without adding the memory to the kernel. The device memory pages are PFNMAP and not backed by struct page. The module can thus utilize the MM's PFNMAP
memory_failuremechanism that handles ECC/poison on regions with no struct pages.The kernel MM code exposes register/unregister APIs allowing modules to register the device memory for
memory_failurehandling. Make nvgrace-gpu register the GPU memory with the MM on open.The module registers its memory region, the
address_spacewith the kernel MM for ECC handling and implements a callback function to convert the PFN to the file page offset. The callback functions checks if the PFN belongs to the device memory region and is also contained in the VMA range, an error is returned otherwise.Suggested-by Alex Williamson <[email protected]>Suggested-by Jason Gunthorpe <[email protected]>Signed-off-by Ankit Agrawal <[email protected]>--- drivers/vfio/pci/nvgrace-gpu/main.c | 113 +++++++++++++++++++++++++++- 1 file changed, 109 insertions(+), 4 deletions(-)drivers/vfio/pci/nvgrace-gpu/main.c +109
-5@@ -9,6 +9,7 @@#include <linux/jiffies.h> #include <linux/pci-p2pdma.h> #include <linux/pm_runtime.h> +#include <linux/memory-failure.h> /* * The device memory usable to the workloads running in the VM is cached @@ -49,6 +50,7 @@ struct mem_region {void *memaddr;void __iomem *ioaddr; };/* Base virtual address of the region */ +struct pfn_address_space pfn_address_space; };struct nvgrace_gpu_pci_core_device {@@ -88,6 +90,80 @@ nvgrace_gpu_memregion(int index,return NULL ; } +static int pfn_memregion_offset (struct nvgrace_gpu_pci_core_device *nvdev, +unsigned int index, +unsigned long pfn, +pgoff_t *pfn_offset_in_region) +{ +struct mem_region *region; +unsigned long start_pfn, num_pages; + + region =nvgrace_gpu_memregion (index, nvdev); +if (!region) +return -EINVAL ; + + start_pfn =PHYS_PFN (region->memphys); + num_pages = region->memlength >>PAGE_SHIFT ; + +if (pfn < start_pfn || pfn >= start_pfn + num_pages) +return -EFAULT ; + + *pfn_offset_in_region = pfn - start_pfn; + +return 0 ; +} + +static inline +struct nvgrace_gpu_pci_core_device *vma_to_nvdev (struct vm_area_struct *vma); + +static int nvgrace_gpu_pfn_to_vma_pgoff (struct vm_area_struct *vma, +unsigned long pfn, +pgoff_t *pgoff) +{ +struct nvgrace_gpu_pci_core_device *nvdev; +unsigned int index = + vma->vm_pgoff >> (VFIO_PCI_OFFSET_SHIFT -PAGE_SHIFT ); +pgoff_t vma_offset_in_region = vma->vm_pgoff & + ((1U << (VFIO_PCI_OFFSET_SHIFT -PAGE_SHIFT )) -1 ); +pgoff_t pfn_offset_in_region; +int ret; + + nvdev =vma_to_nvdev (vma); +if (!nvdev) +return -ENOENT ; + + ret =pfn_memregion_offset (nvdev, index, pfn, &pfn_offset_in_region); +if (ret) +return ret; + +/* Ensure PFN is not before VMA's start within the region */ +if (pfn_offset_in_region < vma_offset_in_region) +return -EFAULT ; + +/* Calculate offset from VMA start */ + *pgoff = vma->vm_pgoff + + (pfn_offset_in_region - vma_offset_in_region); + +return 0 ; +} + +static int +nvgrace_gpu_vfio_pci_register_pfn_range (struct vfio_device *core_vdev, +struct mem_region *region) +{ +unsigned long pfn, nr_pages; + + pfn =PHYS_PFN (region->memphys); + nr_pages = region->memlength >>PAGE_SHIFT ; + + region->pfn_address_space.node.start = pfn; + region->pfn_address_space.node.last = pfn + nr_pages -1 ; + region->pfn_address_space.mapping = core_vdev->inode->i_mapping; + region->pfn_address_space.pfn_to_vma_pgoff = nvgrace_gpu_pfn_to_vma_pgoff; + +return register_pfn_address_space (®ion->pfn_address_space); +} +static int nvgrace_gpu_open_device (struct vfio_device *core_vdev) { struct vfio_pci_core_device *vdev =@@ -114,14 +190,28 @@ static int nvgrace_gpu_open_device(struct vfio_device *core_vdev)* memory mapping. */ ret =vfio_pci_core_setup_barmap (vdev,0 ); -if (ret) { -vfio_pci_core_disable (vdev); -return ret; +if (ret) + goto error_exit; + +if (nvdev->resmem.memlength) { + ret =nvgrace_gpu_vfio_pci_register_pfn_range (core_vdev, &nvdev->resmem); +if (ret && ret != -EOPNOTSUPP ) + goto error_exit; } -vfio_pci_core_finish_enable (vdev); + ret =nvgrace_gpu_vfio_pci_register_pfn_range (core_vdev, &nvdev->usemem); +if (ret && ret != -EOPNOTSUPP ) + goto register_mem_failed; +vfio_pci_core_finish_enable (vdev);return 0 ; + +register_mem_failed: +if (nvdev->resmem.memlength) +unregister_pfn_address_space (&nvdev->resmem.pfn_address_space); +error_exit: +vfio_pci_core_disable (vdev); +return ret; }static void nvgrace_gpu_close_device (struct vfio_device *core_vdev)@@ -130,6 +220,11 @@ static void nvgrace_gpu_close_device(struct vfio_device *core_vdev) container_of(core_vdev, struct nvgrace_gpu_pci_core_device, core_device.vdev); +if (nvdev->resmem.memlength) +unregister_pfn_address_space (&nvdev->resmem.pfn_address_space); + +unregister_pfn_address_space (&nvdev->usemem.pfn_address_space); +/* Unmap the mapping to the device memory cached region */ if (nvdev->usemem.memaddr) {memunmap (nvdev->usemem.memaddr);@@ -247,6 +342,16 @@ static const struct vm_operations_struct nvgrace_gpu_vfio_pci_mmap_ops = {#endif }; +static inline +struct nvgrace_gpu_pci_core_device *vma_to_nvdev (struct vm_area_struct *vma) +{ +/* Check if this VMA belongs to us */ +if (vma->vm_ops != &nvgrace_gpu_vfio_pci_mmap_ops) +return NULL ; + +return vma->vm_private_data; +} +static int nvgrace_gpu_mmap (struct vfio_device *core_vdev,struct vm_area_struct *vma) { --
Quoted 3 lines
2.34.1
Thanks for fixing the nit, Ankit! In case you need it:
Quoted 31 lines · On Thu, 15 Jan 2026 20:28:47 +0000 <[email protected]> wrote:
From: Ankit Agrawal <[email protected]>
Linux MM provides interfaces to allow a driver to [un]register device memory not backed by struct page for poison handling through
memory_failure.The device memory on NVIDIA Grace based systems are not added to the kernel and are not backed by struct pages. So nvgrace-gpu module which manages the device memory can make use of these interfaces to get the benefit of poison handling. Make nvgrace-gpu register the device memory with the MM on open.
Moreover, the stubs are added to accommodate for
CONFIG_MEMORY_FAILUREbeing disabled.Patch 1/2 introduces stubs for
CONFIG_MEMORY_FAILUREdisabled. Patch 2/2 registers the device memory at the time of open instead of mmap.Note that this is a reposting of an earlier series [1] which is partly (patch 1/3) merged to v6.19-rc4. This one addresses the leftover patching. Many thanks to Jason Gunthorpe ([email protected]) and Alex Williamson ([email protected]) for valuable suggestions.
Changelog:
v2:
- Fixed nit to cleanupnvgrace_gpu_vfio_pci_register_pfn_range(Thanks Jiaqi Yan)
Quoted 8 lines
Ankit Agrawal (2):
mm: add stubs for PFNMAP memory failure registration functions vfio/nvgrace-gpu: register device memory for poison handlingdrivers/vfio/pci/nvgrace-gpu/main.c | 113 +++++++++++++++++++++++++++- include/linux/memory-failure.h | 13 +++- 2 files changed, 120 insertions(+), 6 deletions(-)
Applied to vfio next branch for v6.20/7.0. Thanks,
Alex