[PATCH v2 0/5] rust: pin-init: merge `__init` and `__pinned_init`
From: Gary Guo
Date: Wed Jul 29 2026 - 12:10:54 EST
Currently we have `PinInit::__pinned_init` and `Init::__init` which has
slightly different safety requirement but are required to do the same
thing. Instead of having to duplicate impl everywhere, it's simpler to just
use `Init` as a marker trait that cancels out the pinning requirement on
`PinInit::__pinned_init`. This also simplifies code (and shorten the symbol
name) so `__init` can always be used.
However, there are multiple users currently using `__pinned_init`. This is
not designed to be public API; however `pin_init` failed to provide a
public API alternative so it is still being used. Add `ptr_init` and
`ptr_try_init` methods and convert users to use them instead. `__init`
users can use these as well due to the super-trait relationship.
Signed-off-by: Gary Guo <gary@xxxxxxxxxxx>
---
Changes in v2:
- Add a public API for `__init` and convert users.
- Remove the part about multiple cycles. Danilo suggests me to take the
entirety in single cycle as this doesn't conflict with other branches.
- Link to v1: https://patch.msgid.link/20260722-merge-init-v1-0-d4594de76538@xxxxxxxxxxx
---
Gary Guo (5):
rust: pin-init: examples: use `Wrapper::pin_init` instead of manual reimplementation
rust: pin-init: merge `__pinned_init` and `__init`
rust: pin-init: add `ptr_init` and `ptr_try_init` and recommend over `__init`
rust: treewide: replace `__pinned_init` with `ptr_[try_]init`
rust: pin-init: remove `__pinned_init` method for `cfg(kernel)`
drivers/gpu/nova-core/gsp/cmdq.rs | 4 +-
rust/kernel/alloc/kbox.rs | 8 +-
rust/kernel/dma.rs | 10 +-
rust/kernel/drm/device.rs | 2 +-
rust/kernel/drm/gpuvm/va.rs | 2 +-
rust/kernel/drm/gpuvm/vm_bo.rs | 2 +-
rust/kernel/init.rs | 6 +-
rust/kernel/pwm.rs | 2 +-
rust/kernel/sync/arc.rs | 8 +-
rust/kernel/types.rs | 8 +-
rust/macros/module.rs | 2 +-
rust/pin-init/examples/mutex.rs | 6 +-
rust/pin-init/examples/static_init.rs | 10 +-
rust/pin-init/src/__internal.rs | 8 +-
rust/pin-init/src/alloc.rs | 6 +-
rust/pin-init/src/lib.rs | 177 +++++++++++++++++-----------------
16 files changed, 128 insertions(+), 133 deletions(-)
---
base-commit: 6d0795b507fb1db2e6aefe533d949db3a4abf4c6
change-id: 20260722-merge-init-3ed98519ec7f
Best regards,
--
Gary Guo <gary@xxxxxxxxxxx>