vasilito
88b4d06ec2
local/sources/libc is libc 0.2.189 with src/unix/redox/mod.rs extended to
expose the waitid surface relibc already implements:
- idtype_t (= c_int, as relibc defines it)
- P_ALL / P_PID / P_PGID
- CLD_EXITED / KILLED / DUMPED / TRAPPED / STOPPED / CONTINUED
- extern fn waitid(idtype_t, id_t, *mut siginfo_t, c_int) -> c_int
All of it is real in relibc -- src/header/sys_wait/mod.rs defines the
types and constants, and `nm libc.a` shows `T waitid` -- but the libc
crate's Redox bindings never exposed any of it, and still do not as of
0.2.189. Any crate calling waitid therefore cannot build for
x86_64-unknown-redox:
error[E0531]: cannot find unit struct, unit variant or constant
`CLD_EXITED` in crate `libc`
which breaks nix, and through it ctrlc and rustc's bootstrap tooling --
the last thing blocking rust-native.
Values and types come from relibc, not from Linux. Every non-Redox target
is byte-for-byte upstream 0.2.189, so host builds are unaffected. Wired
into the rust workspace via [patch.crates-io]; the fork type-checks for
x86_64-unknown-redox.
Upstream-reportable: this gap belongs in the libc crate.
102 lines
3.6 KiB
Markdown
102 lines
3.6 KiB
Markdown
# libc - Raw FFI bindings to platforms' system libraries
|
|
|
|
[![GHA Status]][GitHub Actions] [![Latest Version]][crates.io] [![Documentation]][docs.rs] ![License]
|
|
|
|
`libc` provides all of the definitions necessary to easily interoperate with C
|
|
code (or "C-like" code) on each of the platforms that Rust supports. This
|
|
includes type definitions (e.g. `c_int`), constants (e.g. `EINVAL`) as well as
|
|
function headers (e.g. `malloc`).
|
|
|
|
This crate exports all underlying platform types, functions, and constants under
|
|
the crate root, so all items are accessible as `libc::foo`. The types and values
|
|
of all the exported APIs match the platform that libc is compiled for.
|
|
|
|
Windows API bindings are not included in this crate. If you are looking for
|
|
WinAPI bindings, consider using crates like [windows-sys].
|
|
|
|
More detailed information about the design of this library can be found in its
|
|
[associated RFC][rfc].
|
|
|
|
[rfc]: https://github.com/rust-lang/rfcs/blob/HEAD/text/1291-promote-libc.md
|
|
[windows-sys]: https://docs.rs/windows-sys
|
|
|
|
## v1.0 Roadmap
|
|
|
|
Currently, `libc` has two active branches: `main` for the upcoming v1.0 release,
|
|
and `libc-0.2` for the currently published version. By default all pull requests
|
|
should target `main`; once reviewed, they can be cherry picked to the `libc-0.2`
|
|
branch if needed.
|
|
|
|
We will stop making new v0.2 releases once v1.0 is released.
|
|
|
|
See the section in [CONTRIBUTING.md](CONTRIBUTING.md#v10-roadmap) for more
|
|
details.
|
|
|
|
## Usage
|
|
|
|
Add the following to your `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
libc = "0.2"
|
|
```
|
|
|
|
## Rust version support
|
|
|
|
The minimum supported Rust toolchain version is currently **Rust 1.65**.
|
|
|
|
Increases to the MSRV are allowed to change without a major (i.e. semver-
|
|
breaking) release in order to avoid a ripple effect in the ecosystem. A policy
|
|
for when this may change is a work in progress.
|
|
|
|
`libc` may continue to compile with Rust versions older than the current MSRV
|
|
but this is not guaranteed.
|
|
|
|
## Platform support
|
|
|
|
You can see the platform(target)-specific docs on [docs.rs], select a platform
|
|
you want to see.
|
|
|
|
See [`ci/verify-build.py`](https://github.com/rust-lang/libc/blob/HEAD/ci/verify-build.py) for
|
|
the platforms on which `libc` is guaranteed to build for each Rust toolchain.
|
|
The test matrices at [GitHub Actions] show the platforms in which `libc` tests
|
|
are run.
|
|
|
|
<div class="platform_docs"></div>
|
|
|
|
## License
|
|
|
|
This project is licensed under either of
|
|
|
|
* [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0)
|
|
([LICENSE-APACHE](https://github.com/rust-lang/libc/blob/HEAD/LICENSE-APACHE))
|
|
|
|
* [MIT License](https://opensource.org/licenses/MIT)
|
|
([LICENSE-MIT](https://github.com/rust-lang/libc/blob/HEAD/LICENSE-MIT))
|
|
|
|
at your option.
|
|
|
|
## Contributing
|
|
|
|
We welcome all people who want to contribute. Please see the
|
|
[contributing instructions] for more information.
|
|
|
|
[contributing instructions]: https://github.com/rust-lang/libc/blob/HEAD/CONTRIBUTING.md
|
|
|
|
Contributions in any form (issues, pull requests, etc.) to this project must
|
|
adhere to Rust's [Code of Conduct].
|
|
|
|
[Code of Conduct]: https://www.rust-lang.org/policies/code-of-conduct
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in `libc` by you, as defined in the Apache-2.0 license, shall be
|
|
dual licensed as above, without any additional terms or conditions.
|
|
|
|
[GitHub Actions]: https://github.com/rust-lang/libc/actions
|
|
[GHA Status]: https://github.com/rust-lang/libc/workflows/CI/badge.svg
|
|
[crates.io]: https://crates.io/crates/libc
|
|
[Latest Version]: https://img.shields.io/crates/v/libc.svg
|
|
[Documentation]: https://docs.rs/libc/badge.svg
|
|
[docs.rs]: https://docs.rs/libc
|
|
[License]: https://img.shields.io/crates/l/libc.svg
|