rust: bits: add support for bits/genmask macros
authorDaniel Almeida <daniel.almeida@collabora.com>
Mon, 14 Jul 2025 23:29:58 +0000 (20:29 -0300)
committerMiguel Ojeda <ojeda@kernel.org>
Sat, 19 Jul 2025 21:18:18 +0000 (23:18 +0200)
commitcc84ef3b88f407e8bd5a5f7b6906d1e69851c856
tree43e765162217ea01d519a895eadf8678dca99e96
parentc77f85b347dd506ab6ef047031e75c2d03101187
rust: bits: add support for bits/genmask macros

In light of bindgen being unable to generate bindings for macros, and
owing to the widespread use of these macros in drivers, manually define
the bit and genmask C macros in Rust.

The *_checked version of the functions provide runtime checking while
the const version performs compile-time assertions on the arguments via
the build_assert!() macro.

Reviewed-by: Alice Ryhl <aliceryhl@google.com>
Reviewed-by: Alexandre Courbot <acourbot@nvidia.com>
Signed-off-by: Daniel Almeida <daniel.almeida@collabora.com>
Reviewed-by: Danilo Krummrich <dakr@kernel.org>
Link: https://lore.kernel.org/r/20250714-topics-tyr-genmask2-v9-1-9e6422cbadb6@collabora.com
[ `expect`ed Clippy warning in doctests, hid single `use`, grouped
  examples. Reworded title. - Miguel ]
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
rust/kernel/bits.rs [new file with mode: 0644]
rust/kernel/lib.rs