vthread-stack 0.1.0

Stack and context backend for vthread
Documentation

vthread-stack

The stack and context-switching backend used by vthread.

Use vthread in applications. Its public crate forbids unsafe Rust. This support crate isolates the unsafe stack mechanics and has no compatibility contract for direct downstream use.

See release notes for verification coverage and known limitations.

Ownership and safety

  • Guard pages protect stack mappings. Context switching supports Linux x86_64 and macOS ARM64.
  • Every started stack is resumed, unwound, and reclaimed by its owning carrier.
  • A fiber's control block and entry live on its own stack; starting one on a pooled stack requires no allocation.
  • Unwinding panics are required. A persistent cleanup mount failure during lexical scope exit aborts the process because borrowed executable stacks cannot outlive their environment.

Apache License 2.0