Struct ProtectedFixedSizeStack

pub struct ProtectedFixedSizeStack(/* private fields */);

A more secure, but slightly slower version of FixedSizeStack.

Allocates stack space using virtual memory, whose pages will only be mapped to physical memory if they are used.

The additional guard page is made protected and inaccessible. Now if a stack overflow occurs it should (hopefully) hit this guard page and cause a segmentation fault instead letting the memory being overwritten silently.

As a general rule it is recommended to use this struct to create stack memory.

Implementations

impl ProtectedFixedSizeStack

pub fn new(size: usize) -> Result<ProtectedFixedSizeStack, StackError>

Allocates a new stack of at least size bytes + one additional guard page.

size is rounded up to a multiple of the size of a memory page and does not include the size of the guard page itself.

Methods from Deref<Target = Stack>

pub fn top(&self) -> *mut c_void

Returns the top of the stack from which on it grows downwards towards bottom().

pub fn bottom(&self) -> *mut c_void

Returns the bottom of the stack and thus it’s end.

pub fn len(&self) -> usize

Returns the size of the stack between top() and bottom().

Trait Implementations

impl Debug for ProtectedFixedSizeStack

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ProtectedFixedSizeStack

fn default() -> ProtectedFixedSizeStack

Returns the “default value” for a type.

impl Deref for ProtectedFixedSizeStack

type Target = Stack

The resulting type after dereferencing.

fn deref(&self) -> &Stack

Dereferences the value.

impl Drop for ProtectedFixedSizeStack

fn drop(&mut self)

Executes the destructor for this type.