Commit 866ec3ba authored by Danilo Krummrich's avatar Danilo Krummrich
Browse files

rust: page: define trait AsPageIter 



The AsPageIter trait provides a common interface for types that
provide a page iterator, such as VmallocPageIter.

Subsequent patches will leverage this to let VBox and VVec provide a
VmallocPageIter though this trait.

Reviewed-by: default avatarAlice Ryhl <aliceryhl@google.com>
Reviewed-by: default avatarAlexandre Courbot <acourbot@nvidia.com>
Tested-by: default avatarAlexandre Courbot <acourbot@nvidia.com>
Reviewed-by: default avatarDaniel Almeida <daniel.almeida@collabora.com>
Link: https://lore.kernel.org/r/20250820145434.94745-5-dakr@kernel.org


Signed-off-by: default avatarDanilo Krummrich <dakr@kernel.org>
parent 7937dca7

rust/kernel/page.rs

+12 −0
Original line number Diff line number Diff line
@@ -103,6 +103,18 @@ fn deref(&self) -> &Self::Target { 
    }

}



/// Trait to be implemented by types which provide an [`Iterator`] implementation of

/// [`BorrowedPage`] items, such as [`VmallocPageIter`](kernel::alloc::allocator::VmallocPageIter).

pub trait AsPageIter {

    /// The [`Iterator`] type, e.g. [`VmallocPageIter`](kernel::alloc::allocator::VmallocPageIter).

    type Iter<'a>: Iterator<Item = BorrowedPage<'a>>

    where

        Self: 'a;



    /// Returns an [`Iterator`] of [`BorrowedPage`] items over all pages owned by `self`.

    fn page_iter(&mut self) -> Self::Iter<'_>;

}



/// A pointer to a page that owns the page allocation.

///

/// # Invariants