[automerger skipped] Import platform/external/rust/crates/zeroize am: 2b8e8f4202 -s ours am skip reason: Merged-In Ibde1563d295d8a2d1f8da18c5b3a7b979e1914f2 with SHA-1 9e53ed437e is already in history Original change: https://googleplex-android-review.googlesource.com/c/platform/external/rust/crates/zeroize/+/20190419 Change-Id: Id4d55918f08cc1c7e8ae2529ddaf93029d511bc1 Signed-off-by: Automerger Merge Worker <[email protected]>
Securely zero memory (a.k.a. zeroize) while avoiding compiler optimizations.
This crate implements a portable approach to securely zeroing memory using techniques which guarantee they won't be “optimized away” by the compiler.
The Zeroize trait is the crate's primary API.
Zeroing memory securely is hard - compilers optimize for performance, and in doing so they love to “optimize away” unnecessary zeroing calls. There are many documented “tricks” to attempt to avoid these optimizations and ensure that a zeroing routine is performed reliably.
This crate isn‘t about tricks: it uses core::ptr::write_volatile and core::sync::atomic memory fences to provide easy-to-use, portable zeroing behavior which works on all of Rust’s core number types and slices thereof, implemented in pure Rust with no usage of FFI or assembly.
#![no_std] i.e. embedded-friendly!Rust 1.51 or newer.
In the future, we reserve the right to change MSRV (i.e. MSRV is out-of-scope for this crate's SemVer guarantees), however when we do it will be accompanied by a minor version bump.
Licensed under either of:
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.