X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=README;h=a30eb112750c1592081bd8a4e8d9409befbe7419;hb=2b2c8aafce9d80f9d58652643538f4d58e82b856;hp=666176c7deeb25b18420b1ca95eab0c722c4becd;hpb=a9014ac1b9bc813a21752cd40e0a73441860e6e6;p=oweals%2Fmusl.git diff --git a/README b/README index 666176c7..a30eb112 100644 --- a/README +++ b/README @@ -1,53 +1,23 @@ -musl libc - a new standard library to power a new generation of -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. -For reasons why one might prefer musl, please see the FAQ and libc -comparison chart on the project website, - - http://www.etalabs.net/musl/ - -For installation instructions, see the INSTALL file. - -Please refer to the COPYRIGHT file for details on the copyright status -of code included in musl, and the COPYING file for the license (LGPL) -under which the library as a whole is distributed. - - - -Greetings! - -As of the 0.8.0 release, musl is in _beta_ status. While some -interfaces remain incomplete or yet to be implemented, the ABI is -intended to be stable at this point, and serious efforts have been -made, using three separate test frameworks, to verify the correctness -of the implementation. Many major system-level and user-level programs -are known to work with musl, either out-of-the-box or with minor -patches to address portability errors. - -Included with this package is a gcc wrapper script (musl-gcc) which -allows you to build musl-linked programs using an existing gcc 4.x -toolchain on the host. There are also now at least two mini -distributions (in the form of build scripts) which provide a -self-hosting musl-based toolchain and system root: Sabotage Linux and -Bootstrap Linux. These are much better options than the wrapper script -if you wish to use dynamic linking or build packages with many library -dependencies. - -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 - - + musl libc + +musl, pronounced like the word "mussel", is an MIT-licensed +implementation of the standard C library targetting the Linux syscall +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.1 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. + +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/