Struct ZeroizingAllocator

pub struct ZeroizingAllocator<Alloc: GlobalAlloc>(pub Alloc);

Custom allocator that zeroizes memory before deallocating it

This is highly recommended to be enabled when using the Bitwarden crates to avoid sensitive data persisting in memory after it has been deallocated.

This allocator is a decorator around another allocator.

Example

This example shows how to use the ZeroizingAllocator with the system allocator.

#[global_allocator]
static ALLOC: bitwarden_crypto::ZeroizingAllocator<std::alloc::System> =
   bitwarden_crypto::ZeroizingAllocator(std::alloc::System);

Tuple Fields

0: Alloc

Trait Implementations

impl<T: GlobalAlloc> GlobalAlloc for ZeroizingAllocator<T>

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory as described by the given layout.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates the block of memory at the given ptr pointer with the given layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned.

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.