Bug 5801

Summary: Document the ICECC_PARALLEL_MAKE variable
Product: [Documentation] Reference Reporter: Laszlo Papp <lpapp>
Component: handbookAssignee: Scott Rifenbark <srifenbark>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Low CC: dvhart, poky.doc.watcher, poky.watcher, srifenbark
Version: unspecified   
Target Milestone: 1.6   
Hardware: x86   
OS: Multiple   
Whiteboard: 14 February: RESOLVED
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Done (doc changes complete)

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