Bug 5801 - Document the ICECC_PARALLEL_MAKE variable
Summary: Document the ICECC_PARALLEL_MAKE variable
Status: RESOLVED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Low normal
Target Milestone: 1.6
Assignee: Scott Rifenbark
QA Contact:
URL:
Whiteboard: 14 February: RESOLVED
Depends on:
Blocks:
 
Reported: 2014-02-07 17:59 UTC by Laszlo Papp
Modified: 2014-02-14 13:14 UTC (History)
4 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Laszlo Papp 2014-02-07 17:59:41 UTC
It is currently a hidden game, but seems to be necessary for optimizing the ICECC distributed builds.
Comment 1 Darren Hart 2014-02-13 15:40:06 UTC
Good to add. Can you provide a recommended blurb you'd like to see in the variable glossary?
Comment 2 Laszlo Papp 2014-02-13 15:43:41 UTC
I would replicate the PARALLEL_MAKE variable to a certain extent with additional ICECC related notes.

For instance, it is not possible to autodetect it like PARALLEL_MAKE in master if I understood correctly. It needs to be set to the estimated participating core numbers * 2 in the network. That is my understanding at least.

I do not feel qualified enough to tell more about it comfortably. It is better to ask someone more experienced.
Comment 3 Laszlo Papp 2014-02-13 15:48:54 UTC
Just so we are clear, that is for the best performance like with the PARALLEL_MAKE option. One can set it to less to utilize less core for sure.

The main difference between PARALLEL_MAKE and ICECC_PARALLEL_MAKE is that the former specifies it for local builds, hence local computer. The latter specifies for all the enabled [*] machines on the network.

[*] running the iceccd daemon so that participating to the distributed builds.
Comment 4 Darren Hart 2014-02-13 15:53:15 UTC
Perfect, thanks. We need to give some direction to start off the documentation process. This should be sufficient to get it started.
Comment 5 Scott Rifenbark 2014-02-13 16:50:49 UTC
This is good information to start with.  I will get a first draft of it in today for review.

Scott
Comment 6 Scott Rifenbark 2014-02-13 19:33:18 UTC
Hi, 

Please look at http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-ICECC_PARALLEL_MAKE for the first draft of this variable.  I made some assumptions to create the description.

Thanks, 
Scott
Comment 7 Laszlo Papp 2014-02-14 11:26:16 UTC
It looks OK to me, thanks.
Comment 8 Scott Rifenbark 2014-02-14 13:14:15 UTC
Thanks for the quick review Laszlo.  I am marking this RESOLVED and the Doc flag as "done".

Scott