summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/common-tasks.rst
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2021-10-06 10:42:33 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-10-08 22:01:25 +0100
commit96594eb948732b0805f15495b8b11b15004e6d40 (patch)
treec562db3c254ed5aaff25217bbce0e5c94ba4db93 /documentation/dev-manual/common-tasks.rst
parent6118a0510af238bc889f37a4a18098400b44bd7f (diff)
downloadpoky-96594eb948732b0805f15495b8b11b15004e6d40.tar.gz
dev-manual: warn about license compliance issues when static libraries are used
This partly addresses [YOCTO #14407] (From yocto-docs rev: 444ca8900e8057562d2a71a77e6e6798aca3ce85) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/common-tasks.rst')
-rw-r--r--documentation/dev-manual/common-tasks.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 8ab45193b8..4683b1c045 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -11158,6 +11158,26 @@ this function, you have to follow the following steps:
11158For more usage information refer to :yocto_git:`the meta-spdxscanner repository 11158For more usage information refer to :yocto_git:`the meta-spdxscanner repository
11159</meta-spdxscanner/>`. 11159</meta-spdxscanner/>`.
11160 11160
11161Compliance Limitations with Executables Built from Static Libraries
11162~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11163
11164When package A is added to an image via the :term:`RDEPENDS` or :term:`RRECOMMENDS`
11165mechanisms as well as explicitly included in the image recipe with
11166:term:`IMAGE_INSTALL`, and depends on a static linked library recipe B
11167(``DEPENDS += "B"``), package B will neither appear in the generated license
11168manifest nor in the generated source tarballs. This occurs as the
11169:ref:`license <ref-classes-license>` and :ref:`archiver <ref-classes-archiver>`
11170classes assume that only packages included via :term:`RDEPENDS` or :term:`RRECOMMENDS`
11171end up in the image.
11172
11173As a result, potential obligations regarding license compliance for package B
11174may not be met.
11175
11176The Yocto Project doesn't enable static libraries by default, in part because
11177of this issue. Before a solution to this limitation is found, you need to
11178keep in mind that if your root filesystem is built from static libraries,
11179you will need to manually ensure that your deliveries are compliant
11180with the licenses of these libraries.
11161 11181
11162Copying Non Standard Licenses 11182Copying Non Standard Licenses
11163----------------------------- 11183-----------------------------