]> git.ipfire.org Git - thirdparty/linux.git/commit
rust: safety: introduce `unsafe_precondition_assert!` macro
authorRitvik Gupta <ritvikfoss@gmail.com>
Tue, 7 Oct 2025 21:50:28 +0000 (03:20 +0530)
committerMiguel Ojeda <ojeda@kernel.org>
Mon, 2 Feb 2026 07:10:48 +0000 (08:10 +0100)
commitb8d687c7eeb52d0353ac27c4f71594a2e6aa365f
tree4ceb225ae8d01b4f6acba79a420ad6de8468f7bd
parent0e62e4f3e56cf6c44926db2ee82ff29b4a28ac03
rust: safety: introduce `unsafe_precondition_assert!` macro

Introduce a new `safety` module containing `unsafe_precondition_assert!`
macro. It is a wrapper around `debug_assert!`, intended for validating
preconditions of unsafe function.

When `CONFIG_RUST_DEBUG_ASSERTIONS` flag is enabled, this macro performs
runtime checks to ensure that the preconditions for unsafe function hold.
Otherwise, the macro is a no-op.

Suggested-by: Miguel Ojeda <ojeda@kernel.org>
Link: https://github.com/Rust-for-Linux/linux/issues/1162
Link: https://rust-for-linux.zulipchat.com/#narrow/channel/291566-Library/topic/.60unsafe_precondition_assert.60.20macro/with/528457452
Signed-off-by: Ritvik Gupta <ritvikfoss@gmail.com>
Reviewed-by: Benno Lossin <lossin@kernel.org>
Link: https://patch.msgid.link/20251007215034.213779-1-ritvikfoss@gmail.com
[ Added trailing periods, intra-doc link, "a" in "is a no-op" and `()`
  to function reference. Removed plural in assertion message and title
  of macro. Reworded slightly. - Miguel ]
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
rust/kernel/lib.rs
rust/kernel/safety.rs [new file with mode: 0644]