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 | |
| 11 | http://www.etalabs.net/musl/ |
| 12 | |
| 13 | For installation instructions, see the INSTALL file. |
| 14 | |
| 15 | Please refer to the COPYRIGHT file for details on the copyright status |
| 16 | of code included in musl, and the COPYING file for the license (LGPL) |
| 17 | under which the library as a whole is distributed. |
| 18 | |
| 19 | |
| 20 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 21 | Greetings! |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 22 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 23 | As of the 0.8.0 release, musl is in _beta_ status. While some |
| 24 | interfaces remain incomplete or yet to be implemented, the ABI is |
| 25 | intended to be stable at this point, and serious efforts have been |
| 26 | made, using three separate test frameworks, to verify the correctness |
| 27 | of the implementation. Many major system-level and user-level programs |
| 28 | are known to work with musl, either out-of-the-box or with minor |
| 29 | patches to address portability errors; the main remaining applications |
| 30 | which definitely will not work are those which require C++ support, |
| 31 | which will be addressed during the 0.8 or 0.9 development series. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 32 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 33 | Included with this package is a gcc wrapper script (musl-gcc) which |
| 34 | allows you to build musl-linked programs using an existing gcc 4.x |
| 35 | toolchain on the host. There are also now at least two mini |
| 36 | distributions (in the form of build scripts) which provide a |
| 37 | self-hosting musl-based toolchain and system root: Sabotage Linux and |
| 38 | Bootstrap Linux. These are much better options than the wrapper script |
| 39 | if you wish to use dynamic linking or build packages with many library |
| 40 | dependencies. |
| 41 | |
| 42 | The musl project is actively seeking contributors, mostly in the areas |
| 43 | of porting, testing, and application compatibility improvement. For |
| 44 | bug reports, support requests, or to get involved in development, |
Rich Felker | 5eaa221 | 2011-04-11 00:10:26 -0400 | [diff] [blame] | 45 | please visit #musl on Freenode IRC or subscribe to the musl mailing |
| 46 | list by sending a blank email to musl-subscribe AT lists DOT openwall |
| 47 | DOT com. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 48 | |
Rich Felker | 801b311 | 2011-09-13 13:41:40 -0400 | [diff] [blame] | 49 | Thank you for using musl. |
Rich Felker | 0b44a03 | 2011-02-12 00:22:29 -0500 | [diff] [blame] | 50 | |
| 51 | Cheers, |
| 52 | |
| 53 | Rich Felker / dalias |
| 54 | |
| 55 | |