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

ref-manual: Edits to several tasks that do a bit of "cleaning" 

Fixes [YOCTO #1949]

Updated the following tasks to note that they "clean" out some
areas when run:

 do_populate_sysroot
 do_deploy

Also made some notes to the do_cleansstate task about attempting
to clean remote mirrors.

And, made a change to do_cleanall to specifically mention that
DL_DIR is cleaned.

(From yocto-docs rev: 7e532b17ccd89e43d3661c733ce1f06a52066c29)

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 2014-06-17 16:54:31 +03:00 committed by Richard Purdie
parent d785a16dff
commit 3d97232403
1 changed files with 28 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
documentation/ref-manual/ref-tasks.xml
View File

@ -77,6 +77,14 @@
<link linkend='var-DEPLOYDIR'><filename>DEPLOYDIR</filename></link>
variable.
</para>
<para>
The <filename>do_deploy</filename> task is a
shared state (sstate) task, which means that the task can
be accelerated through sstate use.
Realize also that if the task is re-executed, any previous output
is removed (i.e. "cleaned").
</para>
</section>
<section id='ref-tasks-fetch'>
@ -210,6 +218,14 @@
task into the sysroot in order to make them available to other
recipes.
</para>
<para>
The <filename>do_populate_sysroot</filename> task is a
shared state (sstate) task, which means that the task can
be accelerated through sstate use.
Realize also that if the task is re-executed, any previous output
is removed (i.e. "cleaned").
</para>
</section>
<section id='ref-tasks-rm_work'>
@ -321,7 +337,8 @@
<para>
Removes all output files, shared state
(<link linkend='shared-state-cache'>sstate</link>) cache, and
downloaded source files for a target.
downloaded source files for a target (i.e. the contents of
<link linkend='var-DL_DIR'><filename>DL_DIR</filename></link>).
Essentially, the <filename>do_cleanall</filename> task is
identical to the
<link linkend='ref-tasks-cleansstate'><filename>do_cleansstate</filename></link>
@ -366,10 +383,19 @@
</para>
<para>
When you run the <filename>do_cleanstate</filename> task,
When you run the <filename>do_cleansstate</filename> task,
the OpenEmbedded build system no longer uses any
sstate.
Consequently, building the recipe from scratch is guaranteed.
<note>
The <filename>do_cleansstate</filename> task cannot remove
sstate from a remote sstate mirror.
If you need to build a target from scratch using remote
mirrors, use the "-f" option as follows:
<literallayout class='monospaced'>
$ bitbake -f -c do_cleansstate &lt;target&gt;
</literallayout>
</note>
</para>
</section>