Re: [PATCH] rust: types: add Opaque::from_raw
From: Danilo Krummrich
Date: Tue Jun 17 2025 - 09:55:57 EST
On Tue, Jun 17, 2025 at 01:36:47PM +0000, Alice Ryhl wrote:
> Since commit b20fbbc08a36 ("rust: check type of `$ptr` in
> `container_of!`") we have enforced that the field pointer passed to
> container_of! must match the declared field. This caused mismatches when
> using a pointer to bindings::x for fields of type Opaque<bindings::x>.
>
> This situation encourages the user to simply pass field.cast() to the
> container_of! macro, but this is not great because you might
> accidentally pass a *mut bindings::y when the field type is
> Opaque<bindings::x>, which would be wrong.
>
> To help catch this kind of mistake, add a new Opaque::from_raw that
> wraps a raw pointer in Opaque without changing the inner type.
The patch does more than that, it also adds a hint to container_of!() and fixes
up two occurences. I feel like we should split it up.
> + /// The opposite operation of [`Opaque::raw_get`].
> + pub const fn from_raw(this: *const T) -> *const Self {
Do we want to name this from_raw()? Usually from_raw() methods return either
Self or &'a Self.
Maybe something like cast_from() and rename raw_get() to cast_into()? I think
the latter may be confusing anyways, since it sounds like it would do somthing
with reference counting.
> + this.cast()
> + }