summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
Commit message (Collapse)AuthorAgeFilesLines
* documentation: Updated release date in manual history tables.Scott Rifenbark2016-04-061-2/+2
| | | | | | | | | Updated to "April 2016" for all manuals that use this table. (From yocto-docs rev: 4d3753cc92c446668b0c383736c2071e24e53dd2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual, sdk-manual: Removing oprofile references.Scott Rifenbark2016-04-061-3/+0
| | | | | | | | | | | | | Fixes [YOCTO #9264] I handled the occurrences of "oprofile" and "tools-profile" throughout as I could. They are not all done yet. These in this commit have been removed. (From yocto-docs rev: d76e264ea210846ad8080134bacd56462ba69d24) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the PREFERRED_VERSION variable description.Scott Rifenbark2016-04-061-5/+13
| | | | | | | | | | | | Fixes [YOCTO #8595] Applied some wording changes as part of the review process from Richard Purdie. (From yocto-docs rev: 3c4fc3cbdecb7e3c8287a915b82bc5469288d5db) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated verbiage on proxy handlingScott Rifenbark2016-04-062-16/+29
| | | | | | | | | | | | | | | Fixes [YOCTO #9313] Update the DL_DIR variable description to add a cross-reference to the wiki page that talks about working behind a firewall. Updated the 14.12 FAQ entry with new information about working behind the firewall. (From yocto-docs rev: 056e6881951023e62a7363ba60fe73cd6d2932b6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated PREFERRED_VERSION variable descriptionScott Rifenbark2016-04-061-0/+9
| | | | | | | | | | | Fixes [YOCTO #8595] Added some examples on how to force the version. (From yocto-docs rev: 4a98ce1ed623cd9763731453316f2ff8d8b8b82a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated debugging tips and tricksScott Rifenbark2016-04-061-16/+43
| | | | | | | | | | | | | | | Fixes [YOCTO #9336] I updated the "Debugging" section within the "Tips and Tricks" section. The list of items did not provide detail on two BitBake command-line options you could use to dump out signature data into .sigdata files. Also, the .sigdata files were incorrectly referred to as .siginfo files. (From yocto-docs rev: 7836c386f4f7c011de710b6ec9f6be13045dc559) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Created distrodata and checkpkg tasks, updated distrodata classScott Rifenbark2016-03-232-1/+66
| | | | | | | | | | | | | Fixes [YOCTO #7894] I created two new task reference sections: distrodata and checkpkg. Also, updated the distrodata class description to reflect the presence of these new tasks. (From yocto-docs rev: 3896cbf640d296dafb5eda37f89bba31a47ca8a5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, profile-manual, ref-manual: Updates to remove meta-toolchainScott Rifenbark2016-03-234-9/+8
| | | | | | | | | | | The term "meta-toolchain" is legacy now. I went through and removed its use except for where it appears still as output from the oe-init-build-env script. (From yocto-docs rev: 1cc134060459278997d57f1293f54091c5404d85) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, sdk-manual: Changed section heading.Scott Rifenbark2016-03-234-5/+5
| | | | | | | | | | | Changed the heading for "Optionally Building a Toolchain Installer" to "Building an SDK Installer". This changes the heading and many references to that heading. (From yocto-docs rev: 97d8cd34d0dd0993b1b1135bb75f2212bb46878a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added some SDK manual support to introductionScott Rifenbark2016-03-231-7/+14
| | | | | | | (From yocto-docs rev: 6021a1024b51ab65659e132870eb75d1bf53aedb) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Resolving a conflictScott Rifenbark2016-03-237-34/+31
| | | | | | | (From yocto-docs rev: b364516928d04da38ef3188f07f190ffac64762b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: remove all references to HobBelen Barros Pena2016-03-236-90/+3
| | | | | | | | | | | | | | | | | | | Hob and the packageinfo class have now been removed from the code base. This patch removes all references to: * Hob * meta-hob * packageinfo and * BBLAYERS_NON_REMOVABLE from the documentation. So long, Hob, and thanks for all the fish. (From yocto-docs rev: 6a1ba2761d5c2ec1072616ce3d791787f1b1b2a7) Signed-off-by: Belen Barros Pena <belen.barros.pena@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated COREBASE_FILES variable.Scott Rifenbark2016-03-231-2/+2
| | | | | | | | | Applied review comments. Fixed some wording. (From yocto-docs rev: 0d1ccaf3dadf890498b3f2b090ece276a537b43c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated "Application Development SDK" section.Scott Rifenbark2016-03-111-10/+15
| | | | | | | | | Applied review comments to the section. (From yocto-docs rev: 83871d0f6cd996be2d3476bdfc0f2adef9ff52a7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Applied review edits to several SDK variables.Scott Rifenbark2016-03-111-13/+15
| | | | | | | (From yocto-docs rev: 3d198bc298e6c88ba229f10b96a8e5faf0727897) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated "Cross-Development Toolchain Development" section.Scott Rifenbark2016-03-111-3/+3
| | | | | | | | | | | Updated the note to have a bit better wording regarding extensible SDK specifics. These changes were in response to a review of the section. (From yocto-docs rev: 0209292cafbbe4918ec7ecdf1f48fc8ef2703b9b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated "Build History SDK Information" section.Scott Rifenbark2016-03-111-24/+41
| | | | | | | | | | Applied review edits to adjust this section for the extensible SDK stuff. (From yocto-docs rev: d386fca0b4e54ae2d5e610b37089fb058d80a746) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, mega-manual: Updated "Application Development SDK" section.Scott Rifenbark2016-03-112-11/+39
| | | | | | | | | | | | I updated the figure for this section to include some stuff for the extensible SDK. I updated the text supporting the figure to cover the different SDKs and the different SDK variable sets. (From yocto-docs rev: 5aafab3e2e841293ddba45dfd8683cbdc223ed7c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, mega-manual: Updated "SDK Generation" section.Scott Rifenbark2016-03-112-14/+21
| | | | | | | | | | | | | Updated the figure used to show SDK generation. I added a block to cover the extensible SDK stuff. This affected the figures folder in both the ref-manual and the mega-manual. Updated the text section to support the new figure. (From yocto-docs rev: b9fd7c2b0ea0e2fe1805a1bb1eb1bcb82c807b66) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added several extensible SDK variables to glossary.Scott Rifenbark2016-03-111-37/+277
| | | | | | | | | | | | | | | | | | | SDK_EXT_TYPE SDK_RECRDEP_TASKS SDK_LOCAL_CONF_WHITELIST SDK_LOCAL_CONF_BLACKLIST SDK_INHERIT_BLACKLIST SDK_UPDATE_URL SDK_TARGETS OE_INIT_ENV_SCRIPT COREBASE_FILES SDK_TITLE SDK_INCLUDE_PKGDATA (From yocto-docs rev: c057b9c7027460fa6e53beb3431bf6aa1518b3aa) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated IMAGE_PKGTYPE variable.Scott Rifenbark2016-03-111-1/+1
| | | | | | | | | | Fixed the text to a link to the populate_sdk_* class. The link was good but the text was old. (From yocto-docs rev: dc892cdf618c008a9ce615c31ef643987dfcca13) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated "Cross-Development Toolchain Generation"Scott Rifenbark2016-03-111-0/+6
| | | | | | | | | I added a note about the extensible SDK not including gcc-canadian-cross. (From yocto-docs rev: 53866854af53e97c9d8ca8d0771e12a7744ad6bd) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the "Build History SDK Information" section.Scott Rifenbark2016-03-111-0/+27
| | | | | | | | | | Added some new files to the list of files highlighted for this directory with "sdk". (From yocto-docs rev: 213371bc5c5eb00d37ace5f2b330a87e1f10b73e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updates for nativesdk clarifications.Scott Rifenbark2016-03-032-4/+5
| | | | | | | | | | | | Fixes [YOCTO #8620] Added a couple more clarifications for some nativesdk term uses. Minor edits to help make things clearer. (From yocto-docs rev: 38082e1120861332674f97f67966b1f5cec7dc03) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Clarifying "native" and "sdknative"Scott Rifenbark2016-03-034-14/+16
| | | | | | | | | | | | | Fixes [YOCTO #8620] I applied some review comments for the changes made to several areas in both these manuals. Minor wording fixes and the dropping of some changes as directed by Joshua Lock. (From yocto-docs rev: 71af89da612c37162ba27844c297879d643caf65) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Clarification of "native" and "sdknative"Scott Rifenbark2016-03-036-55/+74
| | | | | | | | | | | | | Fixes [YOCTO #8620] I went through and made some judgement calls on the use of "native" and "sdknative". I tried to make sure that the reader understood the real meaning of these terms. (From yocto-docs rev: d711e8c6dfb32a4ad79e9d11dbf44fbc759d0245) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the S variable description with feedbackScott Rifenbark2016-03-031-4/+7
| | | | | | | | | | | Applied wording feedback. Fixes [YOCTO #8542] (From yocto-docs rev: 847d8bad345728c4a1c95766a127ec6ddb8ad33c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the staging.bbclass descriptionScott Rifenbark2016-03-031-3/+3
| | | | | | | | | | | Fixes [YOCTO #8800] Provided better wording. (From yocto-docs rev: 4a419e22f1ec3623db45393422ca6287d2a73563) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the S variable description.Scott Rifenbark2016-03-031-0/+11
| | | | | | | | | | | | | Fixes [YOCTO #8542] I updated the description with a new example specific to Git. When you use Git, you have to specifically set the S directory for things to work. (From yocto-docs rev: 10d71ccda461098fd8c94677d91fd261f6edf508) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Updated licensing text information.Scott Rifenbark2016-03-031-2/+38
| | | | | | | | | | | | | | | Fixes [YOCTO #8634] To clear up the behavior the COPY_LIC_DIRS, COPY_LIC_MANIFEST, and LICENSE_CREATE_PACKAGE variable behaviors, I updated the glossary descriptions of the variables. Also, added more info to the "Providing License Text" section in the dev-manual. Tied everything together with good referencing. (From yocto-docs rev: e7b2a1ed29dcd9d572b71f756e7705e6499a05ac) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added order information for conf file parsing.Scott Rifenbark2016-03-031-3/+18
| | | | | | | | | | | | | | | I included a new paragraph at the end of the section describing configuration in the "Closer Look" chapter. Cases exist when two configuration files set the same variable. Depending on the order, the last configuration file parsed is the one that actually sets the variable. Fixes [YOCTO #8914] (From yocto-docs rev: 260e7dea7879846bcd3f3475cef001e512c657f0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the do_populate_sysroot task.Scott Rifenbark2016-03-031-3/+9
| | | | | | | | | Fixes [YOCTO #8800] (From yocto-docs rev: 582fc36e9c7157ca9457cad5c8bc6824163feede) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the S variable entry in the glossary.Scott Rifenbark2016-03-031-11/+12
| | | | | | | | | | | | Fixes [YOCTO #8542] I did a bit of re-wording based on the suggested stuff in the bug. (From yocto-docs rev: 8ab2ae205f79429c2986a9ba86bcba07f5e05cd8) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fixed typo in FAQ 14.15 section.Scott Rifenbark2016-02-041-1/+1
| | | | | | | | | Found the word "Ebedded". Fixed to "Embedded". (From yocto-docs rev: 65815012cd70b52b7558e6402f0eec946eb3d445) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated FAQ entry regarding Proxy for SOCKSScott Rifenbark2016-02-041-6/+15
| | | | | | | | | | | | | | Fixes [YOCTO #8637] Added an example to the section for https_proxy. Also added a small example section for SOCKS proxy. Reported-by: Liam R. Howlett <liam.howlett@windriver.com> (From yocto-docs rev: e17510f1209660b934e27f52a3e5c01a1f213453) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fixed type in LICENSE_CREATE_PACKAGE variable descriptionScott Rifenbark2016-02-041-1/+1
| | | | | | | | | | | Pathname was wrong. Fixes [YOCTO #8633] (From yocto-docs rev: 017dd699e68bb600931b271010fbb905a3a25775) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated warning regarding libexecdirScott Rifenbark2016-02-041-5/+7
| | | | | | | | | | | | | | | Fixes [YOCTO #6398] Fixed the text according to Ross such that the specified package contains files in /usr/libexec when the distro configuration uses a different path for <libexecdir>. By default libexecdir is $prefix/libexec but this can be changed, for example to ${libdir}. (From yocto-docs rev: 6ffe6728994c615abe2689a63f9f055425d08d7e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added description for LICENSE_CREATE_PACKAGE variable.Scott Rifenbark2016-02-041-0/+33
| | | | | | | | | | | Fixes [YOCTO #8633] Added a new variable description for LICENSE_CREATE_PACKAGE. (From yocto-docs rev: 49a2f8384e67a90d5b3227ab0de3d12eb311bd20) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added remove-libtool classScott Rifenbark2016-02-041-0/+24
| | | | | | | | | I added this new class to the ref-manual classes section. (From yocto-docs rev: aedb3f54c5874e9cd9d8e5592959410db6f02ec7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the BBMASK variable description.Scott Rifenbark2016-01-291-16/+10
| | | | | | | (From yocto-docs rev: 0ae8d79993eef08c659e609af7e0afa09dcb9158) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Removed obsolete do_deploy statement from "Shared State"Scott Rifenbark2016-01-291-1/+0
| | | | | | | | | | | | The do_deploy[sstate-name] = "deploy" statement in the "Shared State" section was obsolete. I removed it. Fixes [YOCTO #8995] (From yocto-docs rev: e1836a405fcc89cd964e2e71597091161c53224b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the SDK figure.Scott Rifenbark2016-01-292-1/+1
| | | | | | | | | | | Added the SDKPATH variable to figure. It was missing. Also, had to adjust the display parameters to get it to display decently. (From yocto-docs rev: 4862288ab4675051ec6fc93927839da7eb3634b6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added do_image and do_image_complete tasksScott Rifenbark2016-01-291-0/+54
| | | | | | | (From yocto-docs rev: 7b6eb076adc24a6f290e73db93aa831f982817b3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Rewrite of "Image Generation" and devtool text.Scott Rifenbark2016-01-291-32/+71
| | | | | | | | | | | | | Rewrite of devtool reference section. This was a separate commit but got squashed wrong so it ended up with this commit. The changes to "Image Generation" section reflect the new, more detailed image generation figure (From yocto-docs rev: 827c6872b88c17d2d0c8d44b1024fff19076e505) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, mega-manual: Updated the Image Creation figureScott Rifenbark2016-01-291-0/+0
| | | | | | | | | | The old version was off schematically. Moved some boxes around and created more detail to reflect technical correctness. (From yocto-docs rev: 7793101e6866c0c58d0f1202fb04769a21f2f882) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated configuration of auto.conf in closer lookScott Rifenbark2016-01-291-4/+5
| | | | | | | | | | | | | | | | Fixes [YOCTO #8941] Confusing wording existed surrounding how the auto.conf file needs to be created. Early in the section indicates that you must hand create the file. Then later, it indicates to not hand-create it. In reality, this file is not auto-created by any script but is really usually created by an autobuilder. I updated the verbiage to better explain this. (From yocto-docs rev: 2dd8f60251009038d6bc61e2257876baebe8e0be) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Removed all variables related to "QMAKE"Scott Rifenbark2016-01-151-74/+1
| | | | | | | | | | | * Removed the EXTRA_QMAKEVARS_POST variable description * Removed the EXTRA_QMAKEVARS_PRE variable description * Removed the QMAKE_PROFILES variable description (From yocto-docs rev: 19ee6646123f26903d25fb888b23576f7fa75d87) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updates to cull out qt4 stuff.Scott Rifenbark2016-01-158-92/+32
| | | | | | | | | | Several areas changed throughout the ref-manual to remove qt4 referencing. (From yocto-docs rev: 9ee721034ceb2bb7b7a9e64f6a6a7a2b3bfd1c82) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the list of supported image types.Ed Bartosh2016-01-071-14/+27
| | | | | | | | | | The list in the IMAGE_TYPES variable description has been updated to add and remove several image types. (From yocto-docs rev: d363d4d2dcf1760c5a392b443b52965ca7177984) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Prepare for 2.1 buildsScott Rifenbark2016-01-071-0/+5
| | | | | | | | | | | The changes are for the poky.ent file and the mega-manual.sed file to take care of variables. Also, entries added for the manual revision table. (From yocto-docs rev: 60da39f85165e2d4aef55d456f8203183e089433) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>