X-Git-Url: http://nsz.repo.hu/git/?a=blobdiff_plain;f=README;h=a30eb112750c1592081bd8a4e8d9409befbe7419;hb=3ad3fa962efee12067d68c3405a537dce156a7ac;hp=ddc5b6b4885f39a0ae2bbe6da7811b2b19648d23;hpb=8a35deede1c2c1ca2e24aae676c90cac49eff073;p=musl diff --git a/README b/README index ddc5b6b4..a30eb112 100644 --- a/README +++ b/README @@ -1,60 +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 and -license status of code included in musl (standard MIT license). - - - -Greetings! - -With the 0.9.0 release, musl has reached a milestone in completeness -and compatibility. All interfaces in ISO C99 and POSIX 2008 base exist -in musl, along with a number of non-standardized interfaces based on -GNU and BSD libraries and syscall interfaces for Linux-kernel-specific -functions. Some interfaces lack obscure or rarely-used functionality -needed for strict conformance, but the vast majority of interfaces go -above and beyond the requirements for conformance, often promising -success where other implementations can fail under resource exhaustion -or other corner-case conditions. - -At this point, hundreds of packages have been successfully built -against musl, either out-of-the-box or with minor patches to address -portability errors. 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 - - + 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/