Skip to content

[llvm-libc] Update readme.txt #24770

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jul 23, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 6 additions & 19 deletions system/lib/llvm-libc/readme.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,34 +3,21 @@ llvm's libc

These files are from llvm-project's HEAD.

We maintain a local fork of llvm-project that contains any emscripten
specific patches:

https://github.com/emscripten-core/llvm-project

The current patch is based on the emscripten-libs-20 branch.

Currently in producgtion, we do not use LLVM's libc directly yet, but libcxx uses a subset
of headers from libc. So libcxx directly depends on the following directories:
Currently in production, we do not use LLVM's libc directly yet, but libcxx uses
a subset of headers from libc. So libcxx directly depends on the following
directories:
- libc/hdr
- libc/include/llvm-libc-macros
- libc/include/llvm-libc-types
- libc/shared
- libc/src/__support

In addition, we are experimenting with using llvm-libc in overlay mode. You can enable this
by running with `EMCC_CFLAGS=-lllvmlibc`. See https://libc.llvm.org/overlay_mode.html for more
details.
In addition, we are experimenting with using llvm-libc in overlay mode. You can
enable this by running with `EMCC_CFLAGS=-lllvmlibc`. See
https://libc.llvm.org/overlay_mode.html for more details.

Update Instructions
-------------------

Run `system/lib/update_libcxx.py path/to/llvm-project`
Run `system/lib/update_llvm_libc.py path/to/llvm-project`

Modifications
-------------

For a list of changes from upstream see the libc files that are part of:

https://github.com/llvm/llvm-project/compare/llvmorg-20.1.4...emscripten-core:emscripten-libs-20