Crate c_scape

source
Expand description

c-scape

A layer underneath c-gull

Github Actions CI Status zulip chat crates.io page docs.rs docs

c-scape is a layer underneath c-gull. It provides a subset of libc features, containing only features that don’t require Rust’s std to implement. This allows it to be used by std itself.

This is currently highly experimental, incomplete, and some things aren’t optimized. And it depends on Nightly Rust.

§c-scape’s two modes

Similar to c-gull, c-scape has “take-charge” and “coexist-with-libc” modes. One of these must be enabled.

In “take-charge” mode, c-scape takes charge of the process, handling program startup (via Origin) providing malloc (via c-scape), and other things. This requires some additional setup; see the c-scape-example example crate for more details.

In “coexist-with-libc” mode, c-scape can be used as a drop-in (partial) libc replacement. To use it, just change your typical libc dependency in Cargo.toml to this:

libc = { version = "<c-scape version>", package = "c-scape", features = ["coexist-with-libc"] }

Structs§

Enums§

Constants§

Statics§

Functions§

Type Aliases§

Unions§