# 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 Ccode (or "C-like" code) on each of the platforms that Rust supports. Thisincludes type definitions (e.g. `c_int`), constants (e.g. `EINVAL`) as well asfunction headers (e.g. `malloc`).This crate exports all underlying platform types, functions, and constants underthe crate root, so all items are accessible as `libc::foo`. The types and valuesof 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 forWinAPI 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 RoadmapCurrently, `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 requestsshould 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 moredetails.## UsageAdd the following to your `Cargo.toml`:```toml[dependencies]libc = "0.2"```## Features* `std`: by default `libc` links to the standard library. Disable this feature  to remove this dependency and be able to use `libc` in `#![no_std]` crates.* `extra_traits`: all `struct`s implemented in `libc` are `Copy` and `Clone`.  This feature derives `Debug`, `Eq`, `Hash`, and `PartialEq`.The following features are deprecated:* `use_std`: this is equivalent to `std`* `const-extern-fn`: this is now enabled by default* `align`: this is now enabled by default## Rust version supportThe 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 policyfor when this may change is a work in progress.`libc` may continue to compile with Rust versions older than the current MSRVbut this is not guaranteed.## Platform supportYou can see the platform(target)-specific docs on [docs.rs], select a platformyou want to see.See [`ci/verify-build.py`](https://github.com/rust-lang/libc/blob/HEAD/ci/verify-build.py) forthe platforms on which `libc` is guaranteed to build for each Rust toolchain.The test matrices at [GitHub Actions] show the platforms in which `libc` testsare run.<div class="platform_docs"></div>## LicenseThis 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.## ContributingWe 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.mdContributions in any form (issues, pull requests, etc.) to this project mustadhere to Rust's [Code of Conduct].[Code of Conduct]: https://www.rust-lang.org/policies/code-of-conductUnless you explicitly state otherwise, any contribution intentionally submittedfor inclusion in `libc` by you, as defined in the Apache-2.0 license, shall bedual 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