92 lines · plain
1==================2The LLVM C Library3==================4 5.. warning::6 LLVM-libc is not yet ABI stable; currently only static linking is supported.7 LLVM-libc developers retain the right to modify the ABI of types used8 throughout the library. Another libc should be preferred if ABI stability is9 a requirement.10 11.. note::12 LLVM-libc is not fully complete right now. Some programs may fail to build due13 to missing functions. If you would like to help us finish LLVM-libc, check14 out "`Contributing to the libc project <contributing.html>`__" in the sidebar15 or ask on `discord <https://discord.com/channels/636084430946959380/636732994891284500>`__16 (`invite link <https://discord.gg/xS7Z362>`__).17 18Introduction19============20 21LLVM-libc aspires to a unique place in the software ecosystem. The goals are:22 23- Fully compliant with current C23 and POSIX.1-2024 standards.24- Easily decomposed and embedded: Supplement or replace system C library25 functionality easily. This is useful to get consistent math precision across26 systems, or updated memory operations for newer microarchitectures. These27 pieces will work on Linux, MacOS, Windows, and Fuchsia.28- The creation of fully static binaries without license implications.29- Increase whole program optimization opportunities for static binaries through30 ability to inline math and memory operations.31- Reduce coding errors by coding in modern C++ through the use of lightweight32 containers during coding that can be optimized away at runtime.33- Permit fuzzing and sanitizer instrumentation of user binaries including the34 libc functions.35- A complete testsuite that tests both the public interface and internal36 algorithms.37- `Fuzzing <https://github.com/llvm/llvm-project/tree/main/libc/fuzzing>`__38 39 40.. toctree::41 :hidden:42 :maxdepth: 143 :caption: Status & Support44 45 headers/index.rst46 arch_support47 platform_support48 compiler_support49 50.. toctree::51 :hidden:52 :maxdepth: 153 :caption: Simple Usage54 55 getting_started56 57.. toctree::58 :hidden:59 :maxdepth: 160 :caption: Advanced Usage61 62 full_host_build63 full_cross_build64 overlay_mode65 gpu/index.rst66 uefi/index.rst67 configure68 69.. toctree::70 :hidden:71 :maxdepth: 172 :caption: Development73 74 Maintainers75 build_and_test76 dev/index.rst77 porting78 contributing79 80.. toctree::81 :hidden:82 :maxdepth: 183 :caption: Useful Links84 85 talks86 Source Code <https://github.com/llvm/llvm-project/tree/main/libc>87 Bug Reports <https://github.com/llvm/llvm-project/labels/libc>88 Discourse <https://discourse.llvm.org/c/runtimes/libc>89 Join the Discord <https://discord.gg/xS7Z362>90 Discord Channel <https://discord.com/channels/636084430946959380/636732994891284500>91 Buildbot <https://lab.llvm.org/buildbot/#/builders?tags=libc>92