musl - an implementation of the standard library for Linux-based systems
Go to file
Rich Felker 60872cf9c9 first attempt at enabling stack protector support
the code is written to pre-init the thread pointer in static linked
programs that pull in __stack_chk_fail or dynamic-linked programs that
lookup the symbol. no explicit canary is set; the canary will be
whatever happens to be in the thread structure at the offset gcc
hard-coded. this can be improved later.
2012-04-24 18:07:59 -04:00
arch use signed char rather than plain char for int8_t 2012-04-24 18:06:56 -04:00
crt add support for init/finit (constructors and destructors) 2012-02-06 14:39:09 -05:00
dist add another example option to dist/config.mak 2012-04-24 16:49:11 -04:00
include implement getusershell, etc. legacy functions 2012-04-22 14:41:54 -04:00
lib new solution for empty lib dir (old one had some problems) 2011-02-17 17:12:52 -05:00
src first attempt at enabling stack protector support 2012-04-24 18:07:59 -04:00
tools new gcc wrapper, entirely specfile based 2012-04-22 14:32:49 -04:00
.gitignore new gcc wrapper, entirely specfile based 2012-04-22 14:32:49 -04:00
COPYING initial check-in, version 0.5.0 2011-02-12 00:22:29 -05:00
COPYRIGHT update COPYRIGHT status of TRE regex code 2012-03-24 17:46:42 -04:00
INSTALL new installation guide with alternate and primary libc setups 2011-09-21 19:39:40 -04:00
Makefile new gcc wrapper, entirely specfile based 2012-04-22 14:32:49 -04:00
README update README to remove information no longer relevant as of 0.8.7 2012-03-24 17:43:07 -04:00
WHATSNEW release notes for 0.8.9 (bugfix release) 2012-04-19 22:02:50 -04:00

README

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 status
of code included in musl, and the COPYING file for the license (LGPL)
under which the library as a whole is distributed.



Greetings!

As of the 0.8.0 release, musl is in _beta_ status. While some
interfaces remain incomplete or yet to be implemented, the ABI is
intended to be stable at this point, and serious efforts have been
made, using three separate test frameworks, to verify the correctness
of the implementation. Many major system-level and user-level programs
are known to work with musl, either out-of-the-box or with minor
patches to address portability errors.

Included with this package is a gcc wrapper script (musl-gcc) which
allows you to build musl-linked programs using an existing gcc 4.x
toolchain on the host. There are also now at least two mini
distributions (in the form of build scripts) which provide a
self-hosting musl-based toolchain and system root: Sabotage Linux and
Bootstrap Linux. These are much better options than the wrapper script
if you wish to use dynamic linking or build packages with many library
dependencies.

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