aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorJon Turney <jon.turney@dronecode.org.uk>2018-06-02 18:12:10 +0100
committerNirbheek Chauhan <nirbheek.chauhan@gmail.com>2018-06-07 12:57:39 +0000
commit1f5c6d62bf1e88ae24dce79b5d7a586e8f783371 (patch)
treedd60d405ef275549f2e7b108dd7867d3257f1e10 /docs/markdown
parenta7fc3fe3561c0b15a5263192a1645c765adf0ec2 (diff)
downloadmeson-1f5c6d62bf1e88ae24dce79b5d7a586e8f783371.zip
meson-1f5c6d62bf1e88ae24dce79b5d7a586e8f783371.tar.gz
meson-1f5c6d62bf1e88ae24dce79b5d7a586e8f783371.tar.bz2
More clearly explain portability issues with linking to a module
Refine #3277 According to what I read on the internet, on OSX, both MH_BUNDLE (module) and MH_DYLIB (shared library) can be dynamically loaded using dlopen(), but it is not possible to link against MH_BUNDLE as if they were shared libraries. Metion this as an issue in the documentation. Emitting a warning, and then going on to fail during the build with mysterious errors in symbolextractor isn't very helpful, so make attempting this an error on OSX. Add a test for that. See also: https://docstore.mik.ua/orelly/unix3/mac/ch05_03.htm https://stackoverflow.com/questions/2339679/what-are-the-differences-between-so-and-dylib-on-osx
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Reference-manual.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index a5733a2..cc49e88 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -1161,6 +1161,10 @@ variables defined in the [`executable`](#executable) it is loaded by,
you will need to set the `export_dynamic` argument of the executable to
`true`.
+**Note:** Linking to a shared module is not supported on some platforms, notably
+OSX. Consider using a [`shared_library`](#shared_library) instead, if you need
+to both `dlopen()` and link with a library.
+
*Added 0.37.0*
### static_library()