mirror of
https://codeberg.org/kiss-community/repo
synced 2024-12-24 16:30:04 -07:00
105 lines
4.8 KiB
Plaintext
105 lines
4.8 KiB
Plaintext
mold
|
|
________________________________________________________________________________
|
|
|
|
mold is a multi-threaded, high-performance linker that is several times faster
|
|
than the industry-standard ones, namely, GNU ld, GNU gold or LLVM lld. It is
|
|
developed as a drop-in replacement for these linkers and command-line compatible
|
|
with them with a few exceptions. [0]
|
|
|
|
Upstream: $/rui314/mold
|
|
|
|
|
|
[000] Index
|
|
________________________________________________________________________________
|
|
|
|
* Installation ........................................................... [001]
|
|
* Setup .................................................................. [002]
|
|
* Usage .................................................................. [003]
|
|
* Troubleshooting ........................................................ [004]
|
|
* Package Fails To Link With Mold ...................................... [005]
|
|
* References ............................................................. [006]
|
|
|
|
|
|
[001] Installation
|
|
________________________________________________________________________________
|
|
|
|
+------------------------------------------------------------------------------+
|
|
| |
|
|
| $ kiss b mold |
|
|
| |
|
|
+------------------------------------------------------------------------------+
|
|
|
|
|
|
[002] Setup
|
|
________________________________________________________________________________
|
|
|
|
To use mold as the system linker one of the following methods must be used.
|
|
The first solution is recommended as it removes all possibility of the prior
|
|
linker being executed by mistake.
|
|
|
|
1. Use the alternatives system to set mold as the system linker.
|
|
|
|
+------------------------------------------------------------------------------+
|
|
| |
|
|
| $ kiss a mold /usr/bin/ld |
|
|
| |
|
|
+------------------------------------------------------------------------------+
|
|
|
|
2. Add --ld-path to CFLAGS/CXXFLAGS (Clang > 12.0)
|
|
|
|
+------------------------------------------------------------------------------+
|
|
| |
|
|
| $ export CFLAGS="$CFLAGS --ld-path=/usr/bin/mold" |
|
|
| $ export CXXFLAGS="$CXXFLAGS --ld-path=/usr/bin/mold" |
|
|
| |
|
|
+------------------------------------------------------------------------------+
|
|
|
|
3. Add -B to CFLAGS/CXXFLAGS (GCC)
|
|
|
|
+------------------------------------------------------------------------------+
|
|
| |
|
|
| $ export CFLAGS="$CFLAGS -B/usr/lib/mold" |
|
|
| $ export CXXFLAGS="$CXXFLAGS -B/usr/lib/mold" |
|
|
| |
|
|
+------------------------------------------------------------------------------+
|
|
|
|
|
|
[003] Usage
|
|
________________________________________________________________________________
|
|
|
|
Mold does not yet support all use cases. It can not be used to link the Linux
|
|
kernel (due to lack of linker script support) and It has no support for LTO
|
|
(Link Time Optimization).
|
|
|
|
With mold as the default linker, running the package manager as normal should
|
|
result in its usage. To verify that mold is being used, disable binary stripping
|
|
(KISS_STRIP=0) and run the following command on a newly built executable.
|
|
|
|
+------------------------------------------------------------------------------+
|
|
| |
|
|
| $ readelf -p .comment /path/to/exe |
|
|
| |
|
|
+------------------------------------------------------------------------------+
|
|
|
|
If 'mold' appears in the output, everything is setup correctly.
|
|
|
|
|
|
[004] Troubleshooting
|
|
________________________________________________________________________________
|
|
|
|
|
|
--[005] Package Fails To Link With Mold ----------------------------------------
|
|
|
|
If a package in the official repositories fails to link with mold, open an
|
|
issue. If a package in a third-party repository fails to link with mold, open
|
|
an issue in their tracker. If a package you maintain fails to link (and the
|
|
issue is in the linker), open an issue upstream.
|
|
|
|
|
|
[006] References
|
|
________________________________________________________________________________
|
|
|
|
[0] $/rui314/mold
|
|
|
|
|