summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorGuillaume Desmottes <guillaume.desmottes@collabora.com>2020-08-11 15:49:53 +0200
committerGStreamer Merge Bot <gitlab-merge-bot@gstreamer-foundation.org>2020-10-06 12:54:19 +0000
commit89faf739c92e0e9ec72eb06cc224e1d64173b537 (patch)
treeaaeb1933b409fa57747edfa9ef7a36ae654409dc /README.md
parenta9731bdcb70978e667e342419a0c6b9c07db1113 (diff)
downloadgstreamer-89faf739c92e0e9ec72eb06cc224e1d64173b537.tar.gz
meson: add gst-full-version-script option
Can be used to control the exact symbols exported, or not, in libgstreamer-full. This is useful when building a tailored libgstreamer-full aimed to be run with some specific binaries. By using such version script one can reduce the size of the generated lib by letting the linker garbage collect all the unused APIs. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-build/-/merge_requests/195>
Diffstat (limited to 'README.md')
-rw-r--r--README.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/README.md b/README.md
index 452190fc25..c9ca05158e 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,12 @@ Since *1.20.0* `gst_init_static_plugins()` is called automatically by
`gst_init()` and applications must not call it manually any more. The header
file has been removed from public API.
+One can use the `gst-full-version-script` option to pass a
+[version script](https://www.gnu.org/software/gnulib/manual/html_node/LD-Version-Scripts.html)
+to the linker. This can be used to control the exact symbols that are exported by
+the gstreamer-full library, allowing the linker to garbage collect unused code
+and so reduce the total library size.
+
This is an experimental feature, backward uncompatible changes could still be
made in the future.