Chiebot-Mirror
/
meson
mirror of https://github.com/mesonbuild/meson.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity
The Meson Build System http://mesonbuild.com/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
14672 Commits
76 Branches
171 Tags
76 MiB
Tag: Branch: Tree: f8aefe2070
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'f8aefe2070'
${ noResults }
meson/docs/yaml/functions/shared_module.yaml

52 lines
2.0 KiB
Raw Normal View History Unescape

docs: Add the YAML Reference manual
3 years ago
name: shared_module
returns: build_tgt
since: 0.37.0
description: |
Builds a shared module with the given sources.
This is useful for building modules that will be `dlopen()`ed and
hence may contain undefined symbols that will be provided by the
library that is loading it.
If you want the shared module to be able to refer to functions and
variables defined in the [[executable]] it is loaded by,
you will need to set the `export_dynamic` argument of the executable to
`true`.
shared_module: Add soname when used as a link target Emit a detailed deprecation warning that explains what to do instead. Also add a unittest. ``` DEPRECATION: target prog links against shared module mymod, which is incorrect. This will be an error in the future, so please use shared_library() for mymod instead. If shared_module() was used for mymod because it has references to undefined symbols, use shared_libary() with `override_options: ['b_lundef=false']` instead. ``` Fixes https://github.com/mesonbuild/meson/issues/9492
3 years ago
notes:
- |
shared module: Allow linking on Android Android requires shared modules that use symbols from other shared modules to be linked before they can be dlopen()ed in the correct order. Not doing so leads to a missing symbol error: https://github.com/android/ndk/issues/201 We need to always allow linking for this. Also add a soname, although it's not confirmed that it's needed, and it doesn't really hurt if it isn't needed.
3 years ago
*Linking to a shared module on platforms other than Android is deprecated, and will be an error
in the future*.
It was previously allowed because it was the only way to have a shared-library-like target that
shared_module: Add soname when used as a link target Emit a detailed deprecation warning that explains what to do instead. Also add a unittest. ``` DEPRECATION: target prog links against shared module mymod, which is incorrect. This will be an error in the future, so please use shared_library() for mymod instead. If shared_module() was used for mymod because it has references to undefined symbols, use shared_libary() with `override_options: ['b_lundef=false']` instead. ``` Fixes https://github.com/mesonbuild/meson/issues/9492
3 years ago
contained references to undefined symbols. However, since 0.40.0, the `override_options:`
shared module: Allow linking on Android Android requires shared modules that use symbols from other shared modules to be linked before they can be dlopen()ed in the correct order. Not doing so leads to a missing symbol error: https://github.com/android/ndk/issues/201 We need to always allow linking for this. Also add a soname, although it's not confirmed that it's needed, and it doesn't really hurt if it isn't needed.
3 years ago
[[build_target]] keyword argument can be used to create such a [[shared_library]] by passing
`override_options: 'b_lundef=false'`. Shared modules have other characteristics that make
them incompatible with linking, such as a lack of SONAME.
On macOS and iOS, linking to shared modules is disallowed by the linker, so we disallow it at
configure time.
On Android, if a shared module `foo` uses symbols from another shared module `bar`, `foo` must
also be linked to `bar`. Hence, linking one shared module to another will always be allowed when
building for Android.
shared_module: Add soname when used as a link target Emit a detailed deprecation warning that explains what to do instead. Also add a unittest. ``` DEPRECATION: target prog links against shared module mymod, which is incorrect. This will be an error in the future, so please use shared_library() for mymod instead. If shared_module() was used for mymod because it has references to undefined symbols, use shared_libary() with `override_options: ['b_lundef=false']` instead. ``` Fixes https://github.com/mesonbuild/meson/issues/9492
3 years ago
docs: Add the YAML Reference manual
3 years ago
posargs_inherit: _build_target_base
varargs_inherit: _build_target_base
kwargs_inherit: _build_target_base
kwargs:
vs_module_defs:
type: str | file | custom_tgt | custom_idx
since: 0.52.0
description: |
Specify a Microsoft module definition file for controlling symbol exports,
etc., on platforms where that is possible (e.g. Windows).
Rust: Replace rust_crate_type with rust_abi Meson already knows if it's a shared or static library, user only need to specify the ABI (Rust or C).
2 years ago
fix using a CustomTargetIndex for vs_module_defs Because `CustomTargetIndex`es don't have a `subdir` property, but they do implement the `get_subdir()` method
1 year ago
*(Since 1.3.0)* [[@custom_idx]] are supported
Rust: Replace rust_crate_type with rust_abi Meson already knows if it's a shared or static library, user only need to specify the ABI (Rust or C).
2 years ago
rust_abi:
type: str
since: 1.3.0
description: |
Set the specific ABI to compile (when compiling rust).
- 'rust' (default): Create a "dylib" crate.
- 'c': Create a "cdylib" crate.