rust: mm: add abstractions for mm_struct and vm_area_struct
Subsystems (3)
Alice Ryhl
maintainerPATCH v5 1/1 rust: mm: add abstractions for mm_struct and vm_area_struct
This is a follow-up to the page abstractions [1] that were recently merged in 6.11. Rust Binder will need these abstractions to manipulate the vma in its implementation of the mmap fop on the Binder file.
This patch is based on Wedson's implementation on the old rust branch, but has been changed significantly. All mistakes are Alice's.
---
This change depends on:
https://lore.kernel.org/all/[email protected]/
---
Changes in v5:
- Rename VmArea::from_raw_vma to from_raw.
- Use Pin for mutable VmArea references.
- Go through ARef::from in mmgrab_current.
- Link to v4: https://lore.kernel.org/r/[email protected]
Changes in v4:
- Pull out ARef::into_raw into a separate patch.
- Update invariants and struct documentation.
- Rename from_raw_mm to from_raw.
- Link to v3: https://lore.kernel.org/r/[email protected]
Changes in v3:
- Reorder entries in mm.rs.
- Use ARef for mmput_async helper.
- Clarify that VmArea requires you to hold the mmap read or write lock.
- Link to v2: https://lore.kernel.org/r/[email protected]
Changes in v2:
- mm.rs is redesigned from scratch making use of AsRef
- Add notes about whether destructors may sleep
- Rename Area to VmArea
- Link to v1: https://lore.kernel.org/r/[email protected]
--- rust/helpers.c | 61 +++++++++ rust/kernel/lib.rs | 1 + rust/kernel/mm.rs | 347 +++++++++++++++++++++++++++++++++++++++++++++++++ rust/kernel/mm/virt.rs | 206 +++++++++++++++++++++++++++++ 4 files changed, 615 insertions(+)
rust/helpers.c +61 -0
@@ -200,6 +200,67 @@ rust_helper_krealloc(const void *objp, size_t new_size, gfp_t flags) }EXPORT_SYMBOL_GPL (rust_helper_krealloc); +void rust_helper_mmgrab (struct mm_struct *mm) +{ +mmgrab (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmgrab); + +void rust_helper_mmdrop (struct mm_struct *mm) +{ +mmdrop (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmdrop); + +void rust_helper_mmget (struct mm_struct *mm) +{ +mmget (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmget); + +bool rust_helper_mmget_not_zero (struct mm_struct *mm) +{ +return mmget_not_zero (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmget_not_zero); + +void rust_helper_mmap_read_lock (struct mm_struct *mm) +{ +mmap_read_lock (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmap_read_lock); + +bool rust_helper_mmap_read_trylock (struct mm_struct *mm) +{ +return mmap_read_trylock (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmap_read_trylock); + +void rust_helper_mmap_read_unlock (struct mm_struct *mm) +{ +mmap_read_unlock (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmap_read_unlock); + +void rust_helper_mmap_write_lock (struct mm_struct *mm) +{ +mmap_write_lock (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmap_write_lock); + +void rust_helper_mmap_write_unlock (struct mm_struct *mm) +{ +mmap_write_unlock (mm); +} +EXPORT_SYMBOL_GPL (rust_helper_mmap_write_unlock); + +struct vm_area_struct *rust_helper_vma_lookup (struct mm_struct *mm, +unsigned long addr) +{ +return vma_lookup (mm, addr); +} +EXPORT_SYMBOL_GPL (rust_helper_vma_lookup); +/* * `bindgen` binds the C `size_t` type as the Rust `usize` type, so we can * use it in contexts where Rust expects a `usize` like slice (array) indices.
rust/kernel/lib.rs +1 -0
@@ -38,6 +38,7 @@pub mod ioctl;#[cfg( CONFIG_KUNIT )] pub mod kunit; +pub mod mm;#[cfg( CONFIG_NET )] pub mod net;pub mod page;
rust/kernel/mm.rs new file +347 -0
347 lines not on this page · raw message
rust/kernel/mm/virt.rs new file +206 -0
206 lines not on this page · raw message
---
base-commit: ef0f6dbf36d56c3a72264b316e120e58e4805da6
change-id: 20240723-vma-f80119f9fb35
Best regards,
Signature · 1 line
Alice Ryhl <[email protected]>