mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-09-04 20:19:47 +08:00

This introduces a new method called `push_within_capacity` for appending to a vector without attempting to allocate if the capacity is full. Rust Binder will use this in various places to safely push to a vector while holding a spinlock. The implementation is moved to a push_within_capacity_unchecked method. This is preferred over having push() call push_within_capacity() followed by an unwrap_unchecked() for simpler unsafe. Panics in the kernel are best avoided when possible, so an error is returned if the vector does not have sufficient capacity. An error type is used rather than just returning Result<(),T> to make it more convenient for callers (i.e. they can use ? or unwrap). Signed-off-by: Alice Ryhl <aliceryhl@google.com> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Benno Lossin <lossin@kernel.org> Link: https://lore.kernel.org/r/20250502-vec-methods-v5-3-06d20ad9366f@google.com [ Remove public visibility from `Vec::push_within_capacity_unchecked()`. - Danilo ] Signed-off-by: Danilo Krummrich <dakr@kernel.org>
24 lines
619 B
Rust
24 lines
619 B
Rust
// SPDX-License-Identifier: GPL-2.0
|
|
|
|
//! Errors for the [`Vec`] type.
|
|
|
|
use core::fmt::{self, Debug, Formatter};
|
|
use kernel::prelude::*;
|
|
|
|
/// Error type for [`Vec::push_within_capacity`].
|
|
pub struct PushError<T>(pub T);
|
|
|
|
impl<T> Debug for PushError<T> {
|
|
fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
|
|
write!(f, "Not enough capacity")
|
|
}
|
|
}
|
|
|
|
impl<T> From<PushError<T>> for Error {
|
|
fn from(_: PushError<T>) -> Error {
|
|
// Returning ENOMEM isn't appropriate because the system is not out of memory. The vector
|
|
// is just full and we are refusing to resize it.
|
|
EINVAL
|
|
}
|
|
}
|