xref: /relibc/README.md (revision 06a6922cde565448994f02482aed9ef86bc85fc5)
1# relibc ![build](https://travis-ci.org/redox-os/relibc.svg?branch=master)
2relibc is a portable POSIX C standard library written in Rust. It is under heavy development, and currently supports Redox and Linux.
3
4The motivation for this project is twofold: Reduce issues the redox crew was having with newlib, and create a safer alternative to a C standard library written in C. It is mainly designed to be used under redox, as an alternative to newlib, but it also supports linux syscalls via the [sc](https://crates.io/crates/sc) crate.
5
6## Contributing
7Just search for any invocation of the `unimplemented` macro, and hop in! The ci server checks builds for linux and redox, checks formatting (via rustfmt), and runs the test suite. Run `ci.sh` locally to check that your changes will pass travis. Use `fmt.sh` to format your code and `test.sh` to run the C test suite.
8
9## Supported OSes
10
11 - RedoxOS
12 - Linux
13
14## Supported architectures
15
16 - x86\_64
17 - Aarch64
18