diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-12-16 15:39:33 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-02 13:16:09 +0000 |
commit | 61597c48ee928ac79b832cccea61f94953aa7383 (patch) | |
tree | 98869237d432081f569e32dfda9ab7b2605bc333 /documentation | |
parent | d2c89c7cfd36eefe61debac60aeafe7aa34ab526 (diff) | |
download | ast2050-yocto-poky-61597c48ee928ac79b832cccea61f94953aa7383.zip ast2050-yocto-poky-61597c48ee928ac79b832cccea61f94953aa7383.tar.gz |
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>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index ca96b3b..ea280cb 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -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'> |