sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

ref-manual: Edits to the icecc class. 

Added some more information around the use of the ICECC_DISABLED
variable.  Information from Martin.

Reported-by: Martin Jansa <martin.jansa@gmail.com>
(From yocto-docs rev: 25990dbe66690991babda602ef40df948b70b038)

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 2013-12-16 15:39:33 -06:00 committed by Richard Purdie
parent d2c89c7cfd
commit 61597c48ee
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
documentation/ref-manual/ref-classes.xml
View File

@ -1000,6 +1000,38 @@
<link linkend='var-PARALLEL_MAKE'><filename>PARALLEL_MAKE</filename></link>
variable.
</para>
<para>
Inheriting the <filename>icecc</filename> class changes all sstate
signatures.
Consequently, if a development team has a dedicated build system
that populates
<link linkend='var-SSTATE_MIRRORS'><filename>STATE_MIRRORS</filename></link>
and they want to reuse sstate from
<filename>STATE_MIRRORS</filename>, then all developers and the
build system need to either inherit the <filename>icecc</filename>
class or nobody should.
</para>
<para>
At the distribution level, you can inherit the
<filename>icecc</filename> class to be sure that all builders start
with the same sstate signatures.
After inheriting the class, you can then disable the feature by setting
the
<link linkend='var-ICECC_DISABLED'><filename>ICECC_DISABLED</filename></link>
variable to "1" as follows:
<literallayout class='monospaced'>
INHERIT_DISTRO += "icecc"
ICECC_DISABLED ??= "1"
</literallayout>
This practice makes sure everyone is using the same signatures but also
requires individuals that do want to use Icecream to enable the feature
individually as follows in your <filename>local.conf</filename> file:
<literallayout class='monospaced'>
ICECC_DISABLED = ""
</literallayout>
</para>
</section>
<section id='ref-classes-image'>