mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-03 01:40:07 +00:00
Code Issues Projects Releases Wiki Activity

documentation/bsp-guide/bsp.xml: Edits to BSP Licensing section

Browse Source 
Grammar, style, and formatting edits applied to the "BSP
Licensing Considerations" section.

(From yocto-docs rev: 9809e0b5081bdc4f27d7d949930c409575a9a083)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2012-03-22 13:43:51 -06:00
committed by Richard Purdie
parent 2e0b9014e2
commit 40a45af01f
1 changed files with 100 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/bsp-guide/bsp.xml
+100 -108
View File
@@ -656,126 +656,118 @@
</section> </section>
</section> </section>
<section id='bsp-licensing'> <section id='bsp-licensing-considerations'>
<title>BSP Licensing Considerations</title> <title>BSP Licensing Considerations</title>
<para> <para>
In some cases, a BSP contains separately licensed IP In some cases, a BSP contains separately licensed Intellectual Property (IP)
(Intellectual Property) for a component or components for a component or components.
that impose upon the user a requirement to accept the For these cases, you are required to accept the terms of a commercial or other
terms of a commercial or other type of license that type of license that requires some kind of explicit End User License Agreement (EULA).
requires some kind of explicit EULA (End User License Once the license is accepted, the Yocto Project build system can then build and
Agreement). Once the license is accepted the Yocto include the corresponding component in the final BSP image.
Project build system can then build and include the If the BSP is available as a pre-built image, you can download the image after
corresponding component in the final BSP image, or if agreeing to the license or EULA.
the BSP is available in the form of an already built
image, the user will be able to download the image after
agreeing to the license or EULA.
</para>
<para>
Some affected components might be essential to the
normal functioning of the system and have no 'free'
replacement (i.e. the resulting system would be
non-functional without them). On the other hand, other
components might be simply 'good-to-have' or purely
elective, or if essential nonetheless have a 'free'
(possibly less-capable) version that could be used as a
in the BSP recipe.
</para> </para>
<para> <para>
For cases where you can substitute something and still You could find that some separately licensed components that are essential
maintain functionality, the Yocto Project website's for normal operation of the system might not have an unencumbered (or free)
<ulink url='&YOCTO_HOME_URL;/download/all?keys=&amp;download_type=1&amp;download_version='>BSP substitute.
Download Page</ulink> makes available 'de-featured' BSPs Without these essential components, the system would be non-functional.
that are completely free of any IP encumbrances. For Then again, you might find that other licensed components that are simply
these cases you can use the substitution directly and 'good-to-have' or purely elective do have an unencumbered, free replacement
without any further licensing requirements. If present, component that you can use rather than agreeing to the separately licensed component.
these fully 'de-featured' BSPs are named appropriately Even for components essential to the system, you might find an unencumbered component
different as compared to the names of the respective that is not identical but will work as a less-capable version of the
encumbered BSPs. If available, these substitutions are licensed version in the BSP recipe.
the simplest and most preferred options. This, of
course, assumes the resulting functionality meets
requirements.
</para> </para>
<para> <para>
If however, a non-encumbered version is unavailable or For cases where you can substitute a free component and still
the 'free' version would provide unsuitable maintain the system's functionality, the Yocto Project website's
functionality or quality, you can use an encumbered <ulink url='&YOCTO_HOME_URL;/download/all?keys=&amp;download_type=1&amp;download_version='>BSP
version. Download Page</ulink> makes available de-featured BSPs
that are completely free of any IP encumbrances.
For these cases, you can use the substitution directly and
without any further licensing requirements.
If present, these fully de-featured BSPs are named appropriately
different as compared to the names of the respective
encumbered BSPs.
If available, these substitutions are your
simplest and most preferred options.
Use of these substitutions of course assumes the resulting functionality meets
system requirements.
</para> </para>
<para> A couple different methods exist within the Yocto <para>
Project build system to satisfy the licensing If however, a non-encumbered version is unavailable or
requirements for an encumbered BSP. The following list it provides unsuitable functionality or quality, you can use an encumbered
describes them in order of preference: version.
</para> </para>
<orderedlist> <para>
<listitem> A couple different methods exist within the Yocto
<para> Project build system to satisfy the licensing
Yocto recipes that have commercial or other types of requirements for an encumbered BSP.
specially-licensed packages define a variable named The following list describes them in order of preference:
LICENSE_FLAGS. For each of those recipes, a user <orderedlist>
can specify a matching license string in a <listitem><para><emphasis>Use the <filename>LICENSE_FLAGS</filename> variable
local.conf variable named LICENSE_FLAGS_WHITELIST. to define the Yocto Project recipes that have commercial or other types of
This signifies that the user agrees to the license, specially-licensed packages:</emphasis>
and the corresponding recipe can then be built and For each of those recipes, you can
included in the image. See Section 3.3.2. in The specify a matching license string in a
Yocto Project Reference Manual for details on these <filename>local.conf</filename> variable named
variables and how to make use of them. <filename>LICENSE_FLAGS_WHITELIST</filename>.
</para> Specifying the matching license string signifies that you agree to the license.
Thus, the build system can build the corresponding recipe and include
<para> the component in the image.
If you build as you normally would, without See the
specifying any recipes in the "<ulink url='&YOCTO_DOCS_REF_URL;#enabling-commercially-licensed-recipes'>Enabling
LICENSE_FLAGS_WHITELIST, the build will stop and Commercially Licensed Recipes</ulink>" section in the Yocto Project Reference
provide you with the list of recipes that you've Manual for details on how to use these variables.</para>
tried to include in the image which need entries in <para>If you build as you normally would, without
the LICENSE_FLAGS_WHITELIST. Once the appropriate specifying any recipes in the
license flags have been entered into the whitelist, <filename>LICENSE_FLAGS_WHITELIST</filename>, the build stops and
restart the build to continue where it left off. provides you with the list of recipes that you have
During the build the prompt will not appear again tried to include in the image that need entries in
since you have satisfied the requirement. the <filename>LICENSE_FLAGS_WHITELIST</filename>.
</para> Once you enter the appropriate license flags into the whitelist,
restart the build to continue where it left off.
<para> During the build, the prompt will not appear again
Once the appropriate license flags are whitelisted since you have satisfied the requirement.</para>
in the LICENSE_FLAGS_WHITELIST variable, the <para>Once the appropriate license flags are whitelisted
encumbered image can be built with no change at all in the <filename>LICENSE_FLAGS_WHITELIST</filename> variable, you
to the normal build process. can build the encumbered image with no change at all
</para> to the normal build process.</para></listitem>
</listitem> <listitem><para><emphasis>Get a pre-built version of the BSP:</emphasis>
<listitem> You can get this type of BSP by visiting the Yocto Project website's
<para> <ulink url='&YOCTO_HOME_URL;/download'>Download</ulink>
Get a pre-built version of the BSP. You can do this page and clicking on "BSP Downloads".
by visiting the Yocto Project website's You can download BSP tarballs that contain proprietary components
<ulink url='&YOCTO_HOME_URL;/download'>Download</ulink> after agreeing to the licensing
page and clicking on "BSP Downloads". BSP tarballs requirements of each of the individually encumbered
that contain proprietary components can be packages as part of the download process.
downloaded after agreeing to the licensing Obtaining the BSP this way allows you to access an encumbered
requirements of each of the individually encumbered image immediately after agreeing to the
packages as part of the download process. Obtaining click-through license agreements presented by the
the BSP this way allows you to access an encumbered website.
image immediately after agreeing to the Note that if you want to build the image
click-through license agreements presented by the yourself using the recipes contained within the BSP
website. Note that if you want to build the image tarball, you will still need to create an
yourself using the recipes contained within the BSP appropriate <filename>LICENSE_FLAGS_WHITELIST</filename> to match the
tarball, you will still need to create an encumbered recipes in the BSP.</para></listitem>
appropriate LICENSE_FLAGS_WHITELIST to match the </orderedlist>
encumbered recipes in the BSP.
</para>
</listitem>
</orderedlist>
<para>
Note also that the pre-compiled images are bundled with
a time-limited kernel which will run for only a
predetermined amount of time (10 days) before it forces
the system to reboot. This is meant as a discouragement
to directly redistributing the image as-is, and means
that you'll have to eventually rebuild the image if you
want to remove that restriction.
</para> </para>
<note>
Pre-compiled images are bundled with
a time-limited kernel that runs for a
predetermined amount of time (10 days) before it forces
the system to reboot.
This limitation is meant to discourage direct redistribution
of the image.
You must eventually rebuild the image if you want to remove this restriction.
</note>
</section> </section>
</chapter> </chapter>