aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorFini Jastrow <ulf.fini.jastrow@desy.de>2022-03-08 18:41:08 +0100
committerXavier Claessens <xclaesse@gmail.com>2022-04-30 10:06:22 -0400
commitc16fdaeecafe94461d6048b90bd337a04c25ad3c (patch)
tree7ebffc621f5ad4d75459dff1d5b5f05cc6481993 /docs
parent93ed7531c4a1e08defc5ea3b37427e59f67582db (diff)
downloadmeson-c16fdaeecafe94461d6048b90bd337a04c25ad3c.zip
meson-c16fdaeecafe94461d6048b90bd337a04c25ad3c.tar.gz
meson-c16fdaeecafe94461d6048b90bd337a04c25ad3c.tar.bz2
linkers: Add support for mold linker
[why] Support for the relatively new mold linker is missing. If someone wants to use mold as linker `LDFLAGS="-B/path/to/mold"` has to be added instead of the usual `CC_LD=mold meson ...` or `CXX_LD=mold meson ...`. [how] Allow `mold' as linker for clang and newer GCC versions (that versions that have support). The error message can be a bit off, because it is generic for all GNU like compilers, but I guess that is ok. (i.e. 'mold' is not listed as possible linker, even if it would be possible for the given compiler.) [note] GCC Version 12.0.1 is not sufficient to say `mold` is supported. The expected release with support will be 12.1.0. On the other hand people that use the un-released 12.0.1 will probably have built it from trunk. Allowing 12.0.1 is helping bleeding edge developers to use mold in Meson already now. Fixes: #9072 Signed-off-by: Fini Jastrow <ulf.fini.jastrow@desy.de>
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Reference-tables.md1
-rw-r--r--docs/markdown/snippets/mold-support.md4
2 files changed, 5 insertions, 0 deletions
diff --git a/docs/markdown/Reference-tables.md b/docs/markdown/Reference-tables.md
index acd1297..2a6868c 100644
--- a/docs/markdown/Reference-tables.md
+++ b/docs/markdown/Reference-tables.md
@@ -46,6 +46,7 @@ These are return values of the `get_linker_id` method in a compiler object.
| ld.bfd | The GNU linker |
| ld.gold | The GNU gold linker |
| ld.lld | The LLVM linker, with the GNU interface |
+| ld.mold | The fast MOLD linker |
| ld.solaris | Solaris and illumos |
| ld.wasm | emscripten's wasm-ld linker |
| ld64 | Apple ld64 |
diff --git a/docs/markdown/snippets/mold-support.md b/docs/markdown/snippets/mold-support.md
new file mode 100644
index 0000000..450ffad
--- /dev/null
+++ b/docs/markdown/snippets/mold-support.md
@@ -0,0 +1,4 @@
+## Support for mold linker added
+
+The high performance linker mold can be selected via `CC_LD` or `CXX_LD` for
+Clang and GCC >= 12.0.1.