fix crash in pthread_cond_wait mutex-locked check
[musl] / README
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
21 Greetings!
22
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.
32
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,
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.
48
49 Thank you for using musl.
50
51 Cheers,
52
53 Rich Felker / dalias
54
55