mirror of git://git.musl-libc.org/musl
update README in preparation for release
reduces the amount of news-like content on progress and development direction and focuses on the present.
This commit is contained in:
parent
cec05e0429
commit
4b0f39cb53
78
README
78
README
|
@ -1,62 +1,24 @@
|
||||||
|
|
||||||
musl libc - a new standard library to power a new generation of
|
musl libc
|
||||||
Linux-based devices. musl is lightweight, fast, simple, free, and
|
|
||||||
strives to be correct in the sense of standards-conformance and
|
|
||||||
safety.
|
|
||||||
|
|
||||||
musl is an alternative to glibc, eglibc, uClibc, dietlibc, and klibc.
|
musl, pronounced like the word "mussel", is an MIT-licensed
|
||||||
For reasons why one might prefer musl, please see the FAQ and libc
|
implementation of the standard C library targetting the Linux syscall
|
||||||
comparison chart on the project website,
|
API, suitable for use in a wide range of deployment environments. musl
|
||||||
|
offers efficient static and dynamic linking support, lightweight code
|
||||||
|
and low runtime overhead, strong fail-safe guarantees under correct
|
||||||
|
usage, and correctness in the sense of standards conformance and
|
||||||
|
safety. musl is built on the principle that these goals are best
|
||||||
|
achieved through simple code that is easy to understand and maintain.
|
||||||
|
|
||||||
|
The 1.0 release series for musl features coverage for all interfaces
|
||||||
|
defined in ISO C99 and POSIX 2008 base, along with a number of
|
||||||
|
non-standardized interfaces for compatibility with Linux, BSD, and
|
||||||
|
glibc functionality. Also covered are all XSI interfaces except the
|
||||||
|
dbm functions, which are traditionally a separate library from libc.
|
||||||
|
|
||||||
|
For basic installation instructions, see the included INSTALL file.
|
||||||
|
Information on full musl-targeted compiler toolchains, system
|
||||||
|
bootstrapping, and Linux distributions built on musl can be found on
|
||||||
|
the project website:
|
||||||
|
|
||||||
http://www.musl-libc.org/
|
http://www.musl-libc.org/
|
||||||
|
|
||||||
For installation instructions, see the INSTALL file.
|
|
||||||
|
|
||||||
Please refer to the COPYRIGHT file for details on the copyright and
|
|
||||||
license status of code included in musl (standard MIT license).
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Greetings!
|
|
||||||
|
|
||||||
The 0.9.x release series for musl features interface coverage for all
|
|
||||||
interfaces defined in ISO C99 and POSIX 2008 base, along with a number
|
|
||||||
of non-standardized interfaces for compatibility with Linux, BSD, and
|
|
||||||
glibc functionality. As the release series progresses, we are
|
|
||||||
gradually adding support for incomplete functionality in existing
|
|
||||||
interfaces, additional functions that are deemed to be important due
|
|
||||||
to their use in real-world software, and support for new library and
|
|
||||||
language features in C11 such as thread-local storage, which is now
|
|
||||||
supported on all targets. In addition, support for additional target
|
|
||||||
cpu architectures is being added.
|
|
||||||
|
|
||||||
The number of packages build successfully against musl - either
|
|
||||||
out-of-the-box or with minor patches to address portability errors -
|
|
||||||
has exceeded 5000 and is steadily growing. In addition to application
|
|
||||||
compatibility testing, unit testing has been conducted using three
|
|
||||||
separate test frameworks and numerous additional standalone test cases
|
|
||||||
to verify the correctness of the implementation.
|
|
||||||
|
|
||||||
Included with this package is a gcc wrapper script (musl-gcc) which
|
|
||||||
allows you to build musl-linked programs using an existing gcc 3.x or
|
|
||||||
4.x toolchain on the host. There are also now at several mini
|
|
||||||
distributions (in the form of build scripts) which provide a
|
|
||||||
self-hosting musl-based toolchain and system root. These are much
|
|
||||||
better options than the wrapper script if you wish to use dynamic
|
|
||||||
linking or build packages with many library dependencies. See the musl
|
|
||||||
website for details.
|
|
||||||
|
|
||||||
The musl project is actively seeking contributors, mostly in the areas
|
|
||||||
of porting, testing, and application compatibility improvement. For
|
|
||||||
bug reports, support requests, or to get involved in development,
|
|
||||||
please visit #musl on Freenode IRC or subscribe to the musl mailing
|
|
||||||
list by sending a blank email to musl-subscribe AT lists DOT openwall
|
|
||||||
DOT com.
|
|
||||||
|
|
||||||
Thank you for using musl.
|
|
||||||
|
|
||||||
Cheers,
|
|
||||||
|
|
||||||
Rich Felker / dalias
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue