Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 1 | |
| 2 | musl libc - a new standard library to power a new generation of |
| 3 | Linux-based devices. musl is lightweight, fast, simple, free, and |
| 4 | strives to be correct in the sense of standards-conformance and |
| 5 | safety. |
| 6 | |
| 7 | musl is an alternative to glibc, eglibc, uClibc, dietlibc, and klibc. |
| 8 | For reasons why one might prefer musl, please see the FAQ and libc |
| 9 | comparison chart on the project website, |
| 10 | |
Rich Felker | 3ffb556 | 2012-10-26 20:14:19 -0400 | [diff] [blame] | 11 | http://www.musl-libc.org/ |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 12 | |
| 13 | For installation instructions, see the INSTALL file. |
| 14 | |
Rich Felker | 8a35dee | 2012-05-05 02:39:51 -0400 | [diff] [blame] | 15 | Please refer to the COPYRIGHT file for details on the copyright and |
| 16 | license status of code included in musl (standard MIT license). |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 17 | |
| 18 | |
| 19 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 20 | Greetings! |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 21 | |
Rich Felker | 3ffb556 | 2012-10-26 20:14:19 -0400 | [diff] [blame] | 22 | The 0.9.x release series for musl features interface coverage for all |
| 23 | interfaces defined in ISO C99 and POSIX 2008 base, along with a number |
| 24 | of non-standardized interfaces for compatibility with Linux, BSD, and |
| 25 | glibc functionality. As the release series progresses, we are |
| 26 | gradually adding support for incomplete functionality in existing |
| 27 | interfaces, additional functions that are deemed to be important due |
| 28 | to their use in real-world software, and support for new library and |
| 29 | language features in C11 such as thread-local storage, which is now |
| 30 | supported on all targets. In addition, support for additional target |
| 31 | cpu architectures is being added. |
Rich Felker | 8a35dee | 2012-05-05 02:39:51 -0400 | [diff] [blame] | 32 | |
Rich Felker | 3ffb556 | 2012-10-26 20:14:19 -0400 | [diff] [blame] | 33 | The number of packages build successfully against musl - either |
| 34 | out-of-the-box or with minor patches to address portability errors - |
| 35 | has exceeded 5000 and is steadily growing. In addition to application |
| 36 | compatibility testing, unit testing has been conducted using three |
| 37 | separate test frameworks and numerous additional standalone test cases |
| 38 | to verify the correctness of the implementation. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 39 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 40 | Included with this package is a gcc wrapper script (musl-gcc) which |
Rich Felker | 8a35dee | 2012-05-05 02:39:51 -0400 | [diff] [blame] | 41 | allows you to build musl-linked programs using an existing gcc 3.x or |
| 42 | 4.x toolchain on the host. There are also now at several mini |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 43 | distributions (in the form of build scripts) which provide a |
Rich Felker | 8a35dee | 2012-05-05 02:39:51 -0400 | [diff] [blame] | 44 | self-hosting musl-based toolchain and system root. These are much |
| 45 | better options than the wrapper script if you wish to use dynamic |
| 46 | linking or build packages with many library dependencies. See the musl |
| 47 | website for details. |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 48 | |
| 49 | The musl project is actively seeking contributors, mostly in the areas |
| 50 | of porting, testing, and application compatibility improvement. For |
| 51 | bug reports, support requests, or to get involved in development, |
Rich Felker | 5eaa221 | 2011-04-11 00:10:26 -0400 | [diff] [blame] | 52 | please visit #musl on Freenode IRC or subscribe to the musl mailing |
| 53 | list by sending a blank email to musl-subscribe AT lists DOT openwall |
| 54 | DOT com. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 55 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 56 | Thank you for using musl. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 57 | |
| 58 | Cheers, |
| 59 | |
| 60 | Rich Felker / dalias |
| 61 | |
| 62 | |