niansa-misc/musl: musl - an implementation of the standard library for Linux-based systems

mirror of git://git.musl-libc.org/musl synced 2025-03-06 20:48:29 +01:00

musl - an implementation of the standard library for Linux-based systems

Find a file

Rich Felker 8d37958d58 give libc access to its own malloc even if public malloc is interposed allowing the application to replace malloc (since commit `c9f415d7ea`) has brought multiple headaches where it's used from various critical sections in libc components. for example: - the thread-local message buffers allocated for dlerror can't be freed at thread exit time because application code would then run in the context of a non-existant thread. this was handled in commit `aa5a9d15e0` by queuing them for free later. - the dynamic linker has to be careful not to pass memory allocated at early startup time (necessarily using its own malloc) to realloc or free after redoing relocations with the application and all libraries present. bugs in this area were fixed several times, at least in commits `0c5c8f5da6` and `2f1f51ae7b` and possibly others. - by calling the allocator from contexts where libc-internal locks are held, we impose undocumented requirements on alternate malloc implementations not to call into any libc function that might attempt to take these locks; if they do, deadlock results. - work to make fork of a multithreaded parent give the child an unrestricted execution environment is blocked by lock order issues as long as the application-provided allocator can be called with libc-internal locks held. these problems are all fixed by giving libc internals access to the original, non-replaced allocator, for use where needed. it can't be used everywhere, as some interfaces like str[n]dup, open_[w]memstream, getline/getdelim, etc. are required to provide the called memory obtained as if by (the public) malloc. and there are a number of libc interfaces that are "pure library" code, not part of some internal singleton, and where using the application's choice of malloc implementation is preferable -- things like glob, regex, etc. one might expect there to be significant cost to static-linked programs, pulling in two malloc implementations, one of them mostly-unused, if malloc is replaced. however, in almost all of the places where malloc is used internally, care has been taken already not to pull in realloc/free (i.e. to link with just the bump allocator). this size optimization carries over automatically. the newly-exposed internal allocator functions are obtained by renaming the actual definitions, then adding new wrappers around them with the public names. technically __libc_realloc and __libc_free could be aliases rather than needing a layer of wrapper, but this would almost surely break certain instrumentation (valgrind) and the size and performance difference is negligible. __libc_calloc needs to be handled specially since calloc is designed to work with either the internal or the replaced malloc. as a bonus, this change also eliminates the longstanding ugly dependency of the static bump allocator on order of object files in libc.a, by making it so there's only one definition of the malloc function and having it in the same source file as the bump allocator.		2020-11-11 11:38:21 -05:00
arch	fix vector types in aarch64 register file structures	2020-11-11 10:54:58 -05:00
compat/time32	fix null pointer dereference in setitimer time32 compat shim	2019-12-08 10:35:04 -05:00
crt	remove unnecessary and problematic _Noreturn from crt/ldso startup	2019-06-25 19:05:40 -04:00
dist	add another example option to dist/config.mak	2012-04-24 16:49:11 -04:00
include	add support for SIGEV_THREAD_ID timers	2020-10-28 23:00:08 -04:00
ldso	drop use of getdelim/stdio in dynamic linker	2020-11-11 10:55:13 -05:00
src	give libc access to its own malloc even if public malloc is interposed	2020-11-11 11:38:21 -05:00
tools	fix incorrect escaping in add-cfi.*.awk scripts	2020-01-20 15:57:29 -05:00
.gitignore	remove obsolete gitignore rules	2016-07-06 00:21:25 -04:00
.mailmap	update contributor name	2019-12-07 12:21:35 -05:00
configure	configure: enable warnings by default	2020-08-27 20:43:47 -04:00
COPYRIGHT	add optimized aarch64 memcpy and memset	2020-06-26 17:49:51 -04:00
dynamic.list	fix regression in access to optopt object	2018-11-19 13:20:41 -05:00
INSTALL	document mips r6 in INSTALL file	2019-09-27 00:22:48 -04:00
Makefile	make mallocng the default malloc implementation	2020-06-30 15:38:27 -04:00
README	update version reference in the README file	2014-06-25 14:16:53 -04:00
VERSION	release 1.2.1	2020-08-04 00:21:09 -04:00
WHATSNEW	release 1.2.1	2020-08-04 00:21:09 -04:00

README

    musl libc

musl, pronounced like the word "mussel", is an MIT-licensed
implementation of the standard C library targetting the Linux syscall
API, suitable for use in a wide range of deployment environments. musl
offers efficient static and dynamic linking support, lightweight code
and low runtime overhead, strong fail-safe guarantees under correct
usage, and correctness in the sense of standards conformance and
safety. musl is built on the principle that these goals are best
achieved through simple code that is easy to understand and maintain.

The 1.1 release series for musl features coverage for all interfaces
defined in ISO C99 and POSIX 2008 base, along with a number of
non-standardized interfaces for compatibility with Linux, BSD, and
glibc functionality.

For basic installation instructions, see the included INSTALL file.
Information on full musl-targeted compiler toolchains, system
bootstrapping, and Linux distributions built on musl can be found on
the project website:

    http://www.musl-libc.org/