Struct FiberStack

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

Represents an execution stack to use for a fiber.

Implementations

impl FiberStack

pub fn new(size: usize) -> Result<Self>

Creates a new fiber stack of the given size.

pub fn from_custom(custom: Box<dyn RuntimeFiberStack>) -> Result<Self>

Creates a new fiber stack of the given size.

pub unsafe fn from_raw_parts( bottom: *mut u8, guard_size: usize, len: usize, ) -> Result<Self>

Creates a new fiber stack with the given pointer to the bottom of the stack plus how large the guard size and stack size are.

The bytes from bottom to bottom.add(guard_size) should all be guaranteed to be unmapped. The bytes from bottom.add(guard_size) to bottom.add(guard_size + len) should be addressable.

Safety

This is unsafe because there is no validation of the given pointer.

The caller must properly allocate the stack space with a guard page and make the pages accessible for correct behavior.

pub fn top(&self) -> Option<*mut u8>

Gets the top of the stack.

Returns None if the platform does not support getting the top of the stack.

pub fn range(&self) -> Option<Range<usize>>

Returns the range of where this stack resides in memory if the platform supports it.

pub fn is_from_raw_parts(&self) -> bool

Is this a manually-managed stack created from raw parts? If so, it is up to whoever created it to manage the stack’s memory allocation.

pub fn guard_range(&self) -> Option<Range<*mut u8>>

Returns the range of memory that the guard page(s) reside in.