improve Makefile handling of git checkouts with missing lib/ and config.mak
[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 libc hackers!
22
23 This package is an _alpha_ release of musl, intended for the curious
24 and the adventurous. While it can be used to build a complete small
25 Linux system (musl is self-hosted on the system I use to develop it),
26 at this point doing so requires a lot of manual effort. Nonetheless, I
27 hope low-level Linux enthusiasts will try out building some compact
28 static binaries with musl using the provided gcc wrapper (which allows
29 you to link programs with musl on a "standard" glibc Linux system),
30 find whatever embarassing bugs I've let slip through, and provide
31 feedback on issues encountered building various software against musl.
32
33 Please visit #musl on Freenode IRC or contact me via email at dalias
34 AT etalabs DOT net for bug reports, support requests, or to get
35 involved in development. As this has been a one-person project so far,
36 mailing lists will be setup in due time on an as-needed basis.
37
38 Thank you for trying out musl.
39
40 Cheers,
41
42 Rich Felker / dalias
43
44