diff options
author | Tom Zanussi <tom.zanussi@intel.com> | 2010-09-21 17:01:07 -0500 |
---|---|---|
committer | Richard Purdie <rpurdie@linux.intel.com> | 2010-09-21 23:36:05 +0100 |
commit | 73049a3431dc7cdfe841c2b697090e236cd2c301 (patch) | |
tree | 930e56f69e4edbc94d4238b6e2e181038a46b083 /handbook | |
parent | c0317494aa8c338c4eb528a362e806c5da1210fd (diff) | |
download | openembedded-core-73049a3431dc7cdfe841c2b697090e236cd2c301.tar.gz openembedded-core-73049a3431dc7cdfe841c2b697090e236cd2c301.tar.bz2 openembedded-core-73049a3431dc7cdfe841c2b697090e236cd2c301.tar.xz openembedded-core-73049a3431dc7cdfe841c2b697090e236cd2c301.zip |
handbook: add BSP click-through licensing section
Add a section to the BSB Developer's Guide outlining the motivation
and procedures for click-through BSP licensing support.
The corresponding build system support hasn't been implemented yet;
this is being added now mainly as a guideline wrt future intentions.
Signed-off-by: Tom Zanussi <tom.zanussi@intel.com>
Diffstat (limited to 'handbook')
-rw-r--r-- | handbook/bsp.xml | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/handbook/bsp.xml b/handbook/bsp.xml index 7511a03b6..e0ca31732 100644 --- a/handbook/bsp.xml +++ b/handbook/bsp.xml @@ -314,4 +314,138 @@ FILESPATH =. "${@base_set_filespath(["${THISDIR}/${PN}"], d)}:" </section> + <section id='bsp-click-through-licensing'> + <title>BSP 'Click-through' Licensing Procedure</title> + + <note><para> This section is here as a description of how + click-through licensing is expected to work, and is + not yet not impemented. + </para></note> + + <para> + In some cases, a BSP may contain separately licensed IP + (Intellectual Property) for a component, which imposes + upon the user a requirement to accept the terms of a + 'click-through' license. Once the license is accepted + (in whatever form that may be, see details below) the + Poky build system can then build and include the + corresponding component in the final BSP image. Some + affected components may 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. Other components may be simply + 'good-to-have' or purely elective, or if essential + nonetheless have a 'free' (possibly less-capable) + version which may substituted for in the BSP recipe. + </para> + + <para> + For the latter cases, where it is possible to do so from + a functionality perspective, the Poky website will make + available a 'de-featured' BSP completely free of + encumbered IP, which can be used directly and without + any further licensing requirements. If present, this + fully 'de-featured' BSP will be named meta-bsp (i.e. the + normal default naming convention). This is the simplest + and therefore preferred option if available, assuming + the resulting functionality meets requirements. + </para> + + <para> + If however, a non-encumbered version is unavailable or + the 'free' version would provide unsuitable + functionality or quality, an encumbered version can be + used. Encumbered versions of a BSP are given names of + the form meta-bsp-nonfree. There are several ways + within the Poky build system to satisfy the licensing + requirements for an encumbered BSP, in roughly the + following order of preference: + </para> + + <itemizedlist> + <listitem> + + <para> + Get a license key (or keys) for the encumbered BSP + by + visiting <ulink url='https://pokylinux.org/bsp-keys.html'>https://pokylinux.org/bsp-keys.html</ulink> + and give the web form there the name of the BSP + and your e-mail address. + </para> + + <programlisting> + [screenshot of dialog box] + </programlisting> + + <para> + After agreeing to any applicable license terms, the + BSP key(s) will be immediately sent to the address + given and can be used by specifying BSPKEY_<keydomain> + environment variables when building the image: + </para> + + <programlisting> + $ BSPKEY_<keydomain>=<key> bitbake poky-image-sato + </programlisting> + + <para> + This will allow the encumbered image to be built + with no change at all to the normal build process. + </para> + + <para> + Equivalently and probably more conveniently, a line + for each key can instead be put into the user's + local.conf file. + </para> + + <para> + The <keydomain> component of the + BSPKEY_<keydomain> is required because there + may be multiple licenses in effect for a give BSP; a + given <keydomain> in such cases corresponds to + a particular license. In order for an encumbered + BSP encompassing multiple key domains to be built + successfully, a <keydomain> entry for each + applicable license must be present in local.conf or + supplied on the command-line. + </para> + </listitem> + <listitem> + <para> + Do nothing - build as you normally would, and follow + any license prompts that originate from the + encumbered BSP (the build will cleanly stop at this + point). These usually take the form of instructions + needed to manually fetch the encumbered package(s) + and md5 sums into e.g. the poky/build/downloads + directory. Once the manual package fetch has been + completed, restarting the build will continue where + it left off, this time without the prompt since the + license requirements will have been satisfied. + </para> + </listitem> + <listitem> + <para> + Get a full-featured BSP recipe rather than a key, by + visiting + <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>. + Accepting the license agreement(s) presented will + subsequently allow you to download a tarball + containing a full-featured BSP legally cleared for + your use by the just-given license agreement(s). + This method will also allow the encumbered image to + be built with no change at all to the normal build + process. + </para> + </listitem> + </itemizedlist> + <para> + Note that method 3 is also the only option available + when downloading pre-compiled images generated from + non-free BSPs. Those images are likewise available at + <ulink url='https://pokylinux.org/bsps.html'>https://pokylinux.org/bsps.html</ulink>. + </para> + </section> + </chapter> |