Crates.io | c-gull |
lib.rs | c-gull |
version | 0.16.1 |
source | src |
created_at | 2022-11-08 16:28:05.684922 |
updated_at | 2024-05-22 01:10:14.873043 |
description | A libc implementation in Rust |
homepage | |
repository | https://github.com/sunfishcode/c-ward |
max_upload_size | |
id | 708133 |
size | 98,643 |
c-gull is a libc implementation. It is an implementation of the ABI described by the libc crate.
It is implemented in terms of crates written in Rust, such as c-scape, rustix, origin, libm, realpath-ext, tz-rs, printf-compat, num-complex, and posix-regex.
Currently it only supports *-*-linux-gnu
ABIs, though other ABIs could be
added in the future. And currently this mostly focused on features needed by
Rust programs, so it doesn't have all the C-idiomatic things like qsort
yet,
but they could be added in the future.
The goal is to have very little code in c-gull itself, by factoring out all of the significant functionality into independent crates with more Rust-idiomatic APIs, with c-gull just wrapping those APIs to implement the C ABIs.
This is currently highly experimental, incomplete, and some things aren't optimized.
c-gull has two main cargo features: "take-charge" and "coexist-with-libc". One of these must be enabled.
In "take-charge" mode, c-gull 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-gull-example example crate for
more details.
In "coexist-with-libc" mode, c-gull can be used as a drop-in (partial) libc replacement, provided you're using nightly Rust. To use it, just change your typical libc dependency in Cargo.toml to this:
libc = { version = "<c-gull version>", package = "c-gull", features = ["coexist-with-libc"] }
and c-gull will replace as many of the system libc implementation with its own
implementations as it can. In particular, it can't replace malloc
or any of
the pthread functions in this configuration, but it can replace many other
things. See the libc-replacement example for more details.