summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml42
1 files changed, 27 insertions, 15 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 5ac8dbf737..893ef7ba07 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6346,24 +6346,24 @@
6346 (<ulink url='&YOCTO_DOCS_REF_URL;#var-DL_DIR'><filename>DL_DIR</filename></ulink>). 6346 (<ulink url='&YOCTO_DOCS_REF_URL;#var-DL_DIR'><filename>DL_DIR</filename></ulink>).
6347 You start with an empty downloads directory by either 6347 You start with an empty downloads directory by either
6348 removing the files in the existing directory or by 6348 removing the files in the existing directory or by
6349 setting <filename>DL_DIR</filename> to point to either 6349 setting
6350 an empty location or one that does not yet exist. 6350 <filename>DL_DIR</filename> to point to either an
6351 empty location or one that does not yet exist.
6351 </para></listitem> 6352 </para></listitem>
6352 <listitem><para> 6353 <listitem><para>
6353 <emphasis>Create Your "own-mirror" From Your Downloads Directory:</emphasis> 6354 <emphasis>Generate Tarballs of the Source Git Repositories:</emphasis>
6354 Edit your <filename>local.conf</filename> configuration 6355 Edit your <filename>local.conf</filename> configuration
6355 file as follows: 6356 file as follows:
6356 <literallayout class='monospaced'> 6357 <literallayout class='monospaced'>
6357 SOURCE_MIRROR_URL ?= "file:///home/<replaceable>your-download-dir</replaceable>/" 6358 DL_DIR = "/home/<replaceable>your-download-dir</replaceable>/"
6358 INHERIT += "own-mirrors"
6359 BB_GENERATE_MIRROR_TARBALLS = "1" 6359 BB_GENERATE_MIRROR_TARBALLS = "1"
6360 </literallayout> 6360 </literallayout>
6361 During the fetch process in the next step, BitBake 6361 During the fetch process in the next step, BitBake
6362 looks in your mirror for source files. 6362 gathers the source files and creates tarballs in
6363 The 6363 the directory pointed to by <filename>DL_DIR</filename>.
6364 See the
6364 <ulink url='&YOCTO_DOCS_REF_URL;#var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></ulink> 6365 <ulink url='&YOCTO_DOCS_REF_URL;#var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></ulink>
6365 variable causes the build process to create source 6366 variable for more information.
6366 tarballs in the downloads directory.
6367 </para></listitem> 6367 </para></listitem>
6368 <listitem><para> 6368 <listitem><para>
6369 <emphasis>Populate Your Downloads Directory Without Building:</emphasis> 6369 <emphasis>Populate Your Downloads Directory Without Building:</emphasis>
@@ -6372,9 +6372,10 @@
6372 <literallayout class='monospaced'> 6372 <literallayout class='monospaced'>
6373 $ bitbake <replaceable>target</replaceable> --runonly=fetch 6373 $ bitbake <replaceable>target</replaceable> --runonly=fetch
6374 </literallayout> 6374 </literallayout>
6375 The downloads directory now has a "snapshot" of the 6375 The downloads directory (i.e.
6376 source files used for the build. 6376 <filename>${DL_DIR}</filename>) now has a "snapshot" of
6377 The directory also has the tarballs. 6377 the source files in the form of tarballs, which can
6378 be used for the build.
6378 </para></listitem> 6379 </para></listitem>
6379 <listitem><para> 6380 <listitem><para>
6380 <emphasis>Optionally Remove Any Git or other SCM Subdirectories From the Downloads Directory:</emphasis> 6381 <emphasis>Optionally Remove Any Git or other SCM Subdirectories From the Downloads Directory:</emphasis>
@@ -6389,7 +6390,8 @@
6389 6390
6390 <para> 6391 <para>
6391 Once your downloads directory has everything it needs regarding 6392 Once your downloads directory has everything it needs regarding
6392 source files, you can build your target. 6393 source files, you can create your "own-mirror" and build
6394 your target.
6393 Understand that you can use the files to build the target 6395 Understand that you can use the files to build the target
6394 offline from any machine and at any time. 6396 offline from any machine and at any time.
6395 </para> 6397 </para>
@@ -6400,12 +6402,22 @@
6400 <orderedlist> 6402 <orderedlist>
6401 <listitem><para> 6403 <listitem><para>
6402 <emphasis>Using Local Files Only:</emphasis> 6404 <emphasis>Using Local Files Only:</emphasis>
6403 Add the 6405 Inside your <filename>local.conf</filename> file, add
6406 the
6407 <ulink url='&YOCTO_DOCS_REF_URL;#var-SOURCE_MIRROR_URL'><filename>SOURCE_MIRROR_URL</filename></ulink>
6408 variable,
6409 inherit the <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-own-mirrors'><filename>own-mirrors</filename></ulink>
6410 class, and use the
6404 <ulink url='&YOCTO_DOCS_BB_URL;#var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></ulink> 6411 <ulink url='&YOCTO_DOCS_BB_URL;#var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></ulink>
6405 variables to your <filename>local.conf</filename>. 6412 variable to your <filename>local.conf</filename>.
6406 <literallayout class='monospaced'> 6413 <literallayout class='monospaced'>
6414 SOURCE_MIRROR_URL ?= "file:///home/<replaceable>your-download-dir</replaceable>/"
6415 INHERIT += "own-mirrors"
6407 BB_NO_NETWORK = "1" 6416 BB_NO_NETWORK = "1"
6408 </literallayout> 6417 </literallayout>
6418 The <filename>SOURCE_MIRROR_URL</filename> and
6419 <filename>own-mirror</filename> class set up the system
6420 to use the downloads directory as your "own mirror".
6409 Using the <filename>BB_NO_NETWORK</filename> 6421 Using the <filename>BB_NO_NETWORK</filename>
6410 variable makes sure that BitBake's fetching process 6422 variable makes sure that BitBake's fetching process
6411 in step 3 stays local, which means files from 6423 in step 3 stays local, which means files from