The documentation needs to provide some guidance on using the various clean tasks with bitbake. At this point I don't know where to place this information. Here is some fundamental information from Richard. --------- PURDIE EMAIL --------------- There are several "clean" tasks: "clean" - This removes the output from the unpack task onwards (unpack/patch/configure/compile/install/package)" "cleansstate" - This removes everything clean would but also includes any sstate data. This means that when the task reruns, there would no longer be any sstate to use and a build from scratch of the recipe is guaranteed. "cleanall" - This is "cleansstate" plus removing all data related to the downloads. This effectively causes the fetch task to run from scratch. In general, most users would use "clean". "cleansstate" is a belt and braces to ensure any existing sstate package isn't reused. Its unlikely most users would need "cleanall" but the option exists if they did want to remove all downloaded sources as well.
Accepted: Needs to be categorized under "Development Manual" when that category is set up.
Pushing out past 1.5.
I need to be sure this information gets into the re-written BitBake manual.
Hi, I have updated the following sections to provide a bit more information on these clean tasks. http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#ref-tasks-clean http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#ref-tasks-cleanall http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#ref-tasks-cleansstate In addition to this, I made sure the manual set references these sections appropriately when discussing use of these tasks from the BB command line. I am marking as IN PROGRESS REVIEW. Please look this over and let me know if it is good. Thanks, Scott
Need to add do_populate_sysroot and do_deploy to the list of clean tasks although its still not a complete list (nor is it possible to give one). Add a caveat to do_cleansstate that highlights that it cannot remove sstate from a remote sstate mirror. If a try from scratch build is required with remote sstate mirrors, the -f option should be used. Maybe also highlight that do_cleanall removes files from DL_DIR?
Hi, Thanks for the feedback. Please review these tasks: http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#ref-tasks-populate_sysroot http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#deploy http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#cleansstate http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#cleanall Let me know of further changes. Thanks, Scott
Hi, I still need a review of these sections. thanks, Scott
No feedback on this in five weeks. I am marking it RESOLVED and setting the Doc flag to "Done." Scott