Lines Matching +full:fixed +full:- +full:partitions

1 Partitions  title
10 or a shared library) to be split into multiple pieces, or partitions. A
12 loadable partitions. The loadable partitions depend on the main partition
14 shared object, the main partition and the loadable partitions share a virtual
15 address space at link time, and each loadable partition is assigned a fixed
16 offset from the main partition. This allows the loadable partitions to refer
21 -----
37 ``-fsymbol-partition=<soname>``, where ``<soname>`` is the intended soname
42 into partitions according to which sections of the program are reachable from
43 which entry points, similarly to how ``--gc-sections`` removes unused parts of
47 loadable partitions.
49 The following diagram illustrates how sections are assigned to partitions. Each
52 .. image:: partitions.svg
54 The result of linking a program that uses partitions is essentially an
55 ELF file with all of the partitions concatenated together. This file is
57 combined output file, the ``llvm-objcopy`` tool should be used together
58 with the flag ``--extract-main-partition`` to extract the main partition, or
59 ``-extract-partition=<soname>`` to extract one of the loadable partitions.
62 .. code-block:: shell
65   clang -ffunction-sections -fdata-sections -c main.c
69   clang -ffunction-sections -fdata-sections -fsymbol-partition=libfeature.so -c feature.c
72 …clang main.o feature.o -fuse-ld=lld -shared -o libcombined.so -Wl,-soname,libmain.so -Wl,--gc-sect…
74   # Extract the partitions.
75   llvm-objcopy libcombined.so libmain.so --extract-main-partition
76   llvm-objcopy libcombined.so libfeature.so --extract-partition=libfeature.so
78 In order to allow a program to discover the names of its loadable partitions
82 .. code-block:: c
90 The ``name_offset`` field is a relative pointer to a null-terminated string
98 linker-defined symbols ``__part_index_begin`` and ``__part_index_end``.
101 ------------
107 ``--section-start``, ``-Ttext``, ``-Tdata`` or ``-Tbss`` flags. All of these
112 because it is unclear whether the MIPS multi-GOT ABI is compatible with
113 partitions.
115 The current implementation only supports creating up to 254 partitions due