aboutsummaryrefslogtreecommitdiff
path: root/libc/docs/usage_modes.rst
blob: 8e5dcca6e0a75c402f707839ff5ed062290e9a8c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
===========
Usage Modes
===========

The libc can used in two different modes:

#. The **overlay** mode: In this mode, the link order semantics are exploited
   to overlay implementations from LLVM's libc over the system libc. See
   :ref:`overlay_mode` for more information about this mode. In this mode, libc
   uses the ABI of the system it's being overlayed onto. Headers are NOT
   generated. libllvmlibc.a is the only build artifact.
#. The **fullbuild** mode: In this mode, LLVM's libc is used as the only libc
   for the binary. See :ref:`fullbuild_mode` for information about this mode.
   In this mode, libc uses its own ABI. Headers are generated along with a
   libc.a.