somasis/musl-wiki

A community-maintained wiki documenting the musl libc.

musl-wiki

A community-maintained wiki detailing things such as implementation details, frequently asked questions, open issues, users of musl, and other information to the musl libc project.

Cloning

Make sure to get the makedown submodule, you'll need it to make the HTML.

git clone --recursive https://github.com/somasis/musl-wiki

Make sure to look at makedown's requirements for building and testing.

Contributing

Pull requests are welcomed.

Rather than taking edits from anonymous users and allowing drive-by contributions, this wiki takes edits through the git repo here, in order to ensure that all documentation and information on the wiki is verified to be correct and reasonably good quality.

When making edits for submission, you may want to run make lint in order to ensure that your newly-added documentation or edits are adherent to the markdown style. However, it's not really necessary to test locally; Travis CI tests all pull-requests and runs lint on them, and fails if the new commits introduce warnings.

In addition to editing locally, you can also edit online. For creating new pages, click GitHub's "Create New File" button, type the page filename (so, <filename>.md), and begin editing there. You can also edit pages the same way by clicking a page (the filenames correspond to the page titles) and clicking the edit icon next to history.

musl-wiki's Issues

Porting/AArch64 is outdated

Hi,

I noticed that the Porting/AArch64 page is now out of date, because the aarch64 port is merged upstream and stable enough that Alpine Linux builds binary packages for it.

Thanks for maintaining this useful wiki.

MUSL GCC 2019-05-20 support for HAVE_FLOAT_DECIMAL32,64,128

I am using the MUSL GCC version 2019-05-20.

Why MUSL GCC version 2019-05-20 it is not supporting the HAVE_FLOAT_DECIMAL32,64,128 so is there any workaround for supporting the DECIMAL32.

https://wiki.musl-libc.org has TLS error

The website for this wiki has some sort of unrecoverable TLS error. Accessing from Ubuntu 16.04 using firefox.

Explain how to contribute code

Hi all

I would like to contribute code for pthread_getname_np but I can not find any information on how.
Please add an explanation on how to submit patches.

Best regards

Mathematical Library contains erroneous formatting

This page contains bad formatting (specifically in the section where it mentions rounding modes and status flags). To fix this, surround the macro names in backticks.

Fix broken links

There are a number of outdated or broken links. Some appear to pose security risk. Please verify all third-party links on the wiki.

Thread-safety of system(3)

Hi!

POSIX doesn't require for system(3) to be thread-safe and musl doesn't implement it in this way either. However, the glibc man page explitely declares system(3) as thread-safe (without any clarifications how it is implemented). In fact, glibc's approach is similar to one used in Solaris.

For this reason, I think it is worth mentioning on https://wiki.musl-libc.org/functional-differences-from-glibc.html that glibc's behavior is a non-standard extension, and musl doesn't follow it. Right now the page lacks any mentions of system(3).

Gentoo musl stages no longer 'experimental'

Under https://wiki.musl-libc.org/projects-using-musl.html#Linux-distros-shipping-musl-as-an-optional-package the musl stage3s are linked to the 'experimental' subsection of distfiles.gentoo.org . For a few months now, these have been migrated to the standard locations under 'releases' (eg. for x86_64 "amd64" in /releases/amd64/autobuilds/current-stage3-amd64-openrc/).

See lower section of https://www.gentoo.org/downloads/ for further details.

Update musl build instructions

Hello, I am currently stuck on these instructions, they appear to be really out of date: https://wiki.musl-libc.org/building-llvm.html

I'm unsure of what needs to be changed in order for it to build correctly, I've tried building on my own and I keep getting gnu dependencies being brought into the project.

Generating reference value for mathematical functions

Hello, can we tell me, how the reference value is generating for math functions (for example reference value in acos.h)?
And is there any tool for generating accurate reference value for math function in some range?
Thank in advance,
Nikola