From d785a16dffd7788ea82ef71898b2f508fc15344c Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 17 Jun 2014 15:18:53 +0300 Subject: dev-manual, yocto-project-qs: New section on working with source files. Fixes [YOCTO #5566] For the dev-manual, I created a new section called "Working with Source Files." In the section, I cover how to set up mirrors and also how to pre-fetch source using the bitbake -c fetchall command. For the yocto-project-qs, I removed the mirror information in the "Super User" section, which became redundant with the new section now in the dev-manual. I also, removed the fetchall variation of the bitbake command. Both areas reference into the new section of the dev-manual now. (From yocto-docs rev: f314061e3e752d35ea85ed16a60f7f9292180921) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../yocto-project-qs/yocto-project-qs.xml | 68 +++++----------------- 1 file changed, 14 insertions(+), 54 deletions(-) (limited to 'documentation/yocto-project-qs') diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index b1746aec8f..61327f567c 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml @@ -895,42 +895,14 @@ A good deal that goes into a Yocto Project build is simply downloading all of the source tarballs. - Maybe you have been working with another build system - (OpenEmbedded or Angstrom) for which you have built up a sizable - directory of source tarballs. - Or, perhaps someone else has such a directory for which you have - read access. - If so, you can save time by adding statements to your - configuration file so that the build process checks local - directories first for existing tarballs before checking the - Internet. - Here is an efficient way to set it up in your - local.conf file: - - SOURCE_MIRROR_URL ?= "file:///home/you/your-download-dir/" - INHERIT += "own-mirrors" - BB_GENERATE_MIRROR_TARBALLS = "1" - # BB_NO_NETWORK = "1" - - - - - In the previous example, the - BB_GENERATE_MIRROR_TARBALLS - variable causes the OpenEmbedded build system to generate tarballs - of the Git repositories and store them in the - DL_DIR - directory. - Due to performance reasons, generating and storing these tarballs - is not the build system's default behavior. - - - - You can also use the - PREMIRRORS - variable. - For an example, see the variable's glossary entry in the - Yocto Project Reference Manual. + Steps exist that can help you be more efficient with gathering + source files. + For example, you can set up local mirrors that hold your + source tarballs or you can pre-fetch all your source without + initiating a build until later. + For more information, see the + "Working with Source Files" + section in the Yocto Project Development Manual. @@ -949,25 +921,13 @@ - Here are some variations on the build process that could be helpful: - - Fetch all the necessary sources without starting - the build: - - $ bitbake -c fetchall core-image-minimal - - This variation guarantees that you have all the sources for - that BitBake target should you disconnect from the net and - want to do the build later offline. - Specify to continue the build even if BitBake - encounters an error. - By default, BitBake aborts the build when it encounters an - error. - This command keeps a faulty build going: - + By default, BitBake aborts when it encounters an error during + the build. + If you want to make sure the build continues even when BitBake + encounters an error, use this variation: + $ bitbake -k core-image-minimal - - + -- cgit 1.2.3-korg