musl - an implementation of the standard library for Linux-based systems
Go to file
Rich Felker 1a6d6f131b fix and future-proof against stack overflow in aio io threads
aio threads not using SIGEV_THREAD notification are created with small
stacks and no guard page, which is possible since they only run the
code for the requested io operation, not any application code. the
motivation is not creating a lot of VMAs. however, the io thread needs
to be able to receive a cancellation signal in case aio_cancel
(implemented via pthread_cancel) is called. this requires sufficient
stack space for a signal frame, which PTHREAD_STACK_MIN does not
necessarily include.

in principle MINSIGSTKSZ from signal.h should give us sufficient space
for a signal frame, but the value is incorrect on some existing archs
due to kernel addition of new vector register support without
consideration for impact on ABI. some powerpc models exceed
MINSIGSTKSZ by about 0.5k, and x86[_64] with AVX-512 can exceed it by
up to about 1.5k. so use MINSIGSTKSZ+2048 to allow for the discrepancy
plus some working space.

unfortunately, it's possible that signal frame sizes could continue to
grow, and some archs (aarch64) explicitly specify that they may.
passing of a runtime value for MINSIGSTKSZ via AT_MINSIGSTKSZ in the
aux vector was added to aarch64 linux, and presumably other archs will
use this mechanism to report if they further increase the signal frame
size. when AT_MINSIGSTKSZ is present, assume it's correct, so that we
only need a small amount of working space in addition to it; in this
case just add 512.
2018-12-09 23:28:47 -05:00
arch add io_pgetevents and rseq syscall numbers from linux v4.18 2018-12-09 22:29:12 -05:00
crt define and use internal macros for hidden visibility, weak refs 2018-09-05 14:05:14 -04:00
dist add another example option to dist/config.mak 2012-04-24 16:49:11 -04:00
include add NT_VMCOREDD to elf.h from linux v4.18 2018-12-09 22:30:05 -05:00
ldso add new stage 2b to dynamic linker bootstrap for thread pointer 2018-10-16 13:50:28 -04:00
src fix and future-proof against stack overflow in aio io threads 2018-12-09 23:28:47 -05:00
tools fix musl-gcc wrapper to be compatible with default-pie gcc toolchains 2018-08-02 19:15:48 -04:00
.gitignore remove obsolete gitignore rules 2016-07-06 00:21:25 -04:00
configure support clang internal assembler when building for arm as thumb2 code 2018-09-19 01:31:26 -04:00
COPYRIGHT new tsearch implementation 2018-09-20 17:57:47 -04:00
dynamic.list fix regression in access to optopt object 2018-11-19 13:20:41 -05:00
INSTALL add powerpc64 and s390x to list of supported archs in INSTALL file 2017-08-29 20:48:02 -04:00
Makefile overhaul internally-public declarations using wrapper headers 2018-09-12 14:34:33 -04:00
README update version reference in the README file 2014-06-25 14:16:53 -04:00
VERSION release 1.1.20 2018-09-04 13:17:19 -04:00
WHATSNEW fix mistake/cruft in 1.1.20 release notes 2018-09-04 19:27:15 -04:00

    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/