mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 12:29:55 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual, yocto-project-qs: Explanations for Git tarballs

Browse Source 
Fixes [YOCTO #5035]

By default, the DL_DIR does not get files from Git repositories
that are suitable for mirroring.  There is a work-around by
using the BB_GENERATE_MIRROR_TARBALLS variable, which, when
set, causes the build system to generate tarballs for the
Git repositories and place them in the DL_DIR.

To address this, I added a new variable description for the
BB_GENERATE_MIRROR_TARBALLS varible, updated the DL_DIR
variable to indicate that "out-of-the-box" the YP puts suitable
mirror files into the DL_DIR for everthing except Git
repositories.

Some other sections were updated where discussion revolved around
pulling down source files.  The QS had a spot where the
BB_GENERATE_MIRROR_TARBALLS variable was actually used in an
example.  And, the expanded discussion on the BitBake process
had a couple spots that deserved a mention.

(From yocto-docs rev: 1539ff13222449ba60bfaaaac4fe1e8a795b0039)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2013-09-18 13:39:18 -07:00
committed by Richard Purdie
parent 3fa6a307c3
commit 6084246825
3 changed files with 46 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/ref-variables.xml
+18 -14
View File
@@ -502,6 +502,12 @@
For performance reasons, creating and placing tarballs of
the Git repositories is not the default action by the
OpenEmbedded build system.
<literallayout class='monospaced'>
BB_Generate_MIRROR_TARBALLS = "1"
</literallayout>
Set this variable in your <filename>local.conf</filename>
file in the
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
</para>
</glossdef>
</glossentry>
@@ -1272,6 +1278,15 @@ Core layer for images cannot be removed
<para>
The central download directory used by the build process to
store downloads.
By default, <filename>DL_DIR</filename> gets files
suitable for mirroring for everything except Git
repositories.
If you want tarballs of Git repositories, use the
<link linkend='var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></link>
variable.
</para>
<para>
You can set this directory by defining the
<filename>DL_DIR</filename> variable in the
<filename>/conf/local.conf</filename> file.
@@ -1296,20 +1311,9 @@ Core layer for images cannot be removed
<filename>DL_DIR</filename> and the build system looks there
first to find source tarballs.
<note>
<para>
When wiping and rebuilding, you can preserve this
directory to speed up this part of subsequent
builds.
</para>
<para>
Also, by default, the <filename>DL_DIR</filename>
does not contain tarballs of Git directories.
However, you can instruct the build process to save
these tarballs to the directory by using the
<link linkend='var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></link>
variable.
</para>
When wiping and rebuilding, you can preserve this
directory to speed up this part of subsequent
builds.
</note>
</para>