summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2019-03-19 09:06:47 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2019-03-19 23:54:02 +0000
commitddc9d240f413c7e48b4861d571054689c5dd860e (patch)
treecedb756d9b9d0dfeec518399b48c9d39c0bd1e27 /documentation/dev-manual
parent95d6ad04fb681a84722bd32bf568f69da63321e9 (diff)
downloadpoky-ddc9d240f413c7e48b4861d571054689c5dd860e.tar.gz
dev-manual: Added note about AUTOREV for replicating build
Feedback from Paul. (From yocto-docs rev: ea118a9d6fa671de10b9aa8413c7d29951593ec3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml59
1 files changed, 56 insertions, 3 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 5f2b6ece3b..5ac8dbf737 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -6370,7 +6370,7 @@
6370 Use BitBake to fetch your sources but inhibit the 6370 Use BitBake to fetch your sources but inhibit the
6371 build: 6371 build:
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 now has a "snapshot" of the
6376 source files used for the build. 6376 source files used for the build.
@@ -6382,6 +6382,7 @@
6382 by removing any Git or other Source Control Management 6382 by removing any Git or other Source Control Management
6383 (SCM) subdirectories such as 6383 (SCM) subdirectories such as
6384 <filename>${DL_DIR}/git2/*</filename>. 6384 <filename>${DL_DIR}/git2/*</filename>.
6385 The tarballs already contain these subdirectories.
6385 </para></listitem> 6386 </para></listitem>
6386 </orderedlist> 6387 </orderedlist>
6387 </para> 6388 </para>
@@ -6398,7 +6399,7 @@
6398 downloads directory: 6399 downloads directory:
6399 <orderedlist> 6400 <orderedlist>
6400 <listitem><para> 6401 <listitem><para>
6401 <emphasis>Instruct the Build Process to Build Using Local Files:</emphasis> 6402 <emphasis>Using Local Files Only:</emphasis>
6402 Add the 6403 Add the
6403 <ulink url='&YOCTO_DOCS_BB_URL;#var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></ulink> 6404 <ulink url='&YOCTO_DOCS_BB_URL;#var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></ulink>
6404 variables to your <filename>local.conf</filename>. 6405 variables to your <filename>local.conf</filename>.
@@ -6423,10 +6424,62 @@
6423 <literallayout class='monospaced'> 6424 <literallayout class='monospaced'>
6424 $ bitbake <replaceable>target</replaceable> 6425 $ bitbake <replaceable>target</replaceable>
6425 </literallayout> 6426 </literallayout>
6426 The build completes using the know local "snapshot" of 6427 The build completes using the known local "snapshot" of
6427 source files from your mirror. 6428 source files from your mirror.
6428 The resulting tarballs for your "snapshot" of source 6429 The resulting tarballs for your "snapshot" of source
6429 files are in the downloads directory. 6430 files are in the downloads directory.
6431 <note>
6432 <para>The offline build does not work if recipes
6433 attempt to find the latest version of software
6434 by setting
6435 <ulink url='&YOCTO_DOCS_REF_URL;#var-SRCREV'><filename>SRCREV</filename></ulink>
6436 to
6437 <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-AUTOREV'><filename>AUTOREV</filename></ulink><filename>}</filename>:
6438 <literallayout class='monospaced'>
6439 SRCREV = "${AUTOREV}"
6440 </literallayout>
6441 When a recipe sets
6442 <filename>SRCREV</filename> to
6443 <filename>${AUTOREV}</filename>, the build system
6444 accesses the network in an attempt to determine the
6445 latest version of software from the SCM.
6446 Typically, recipes that use
6447 <filename>AUTOREV</filename> are custom or
6448 modified recipes.
6449 Recipes that reside in public repositories
6450 usually do not use <filename>AUTOREV</filename>.
6451 </para>
6452
6453 <para>If you do have recipes that use
6454 <filename>AUTOREV</filename>, you can take steps to
6455 still use the recipes in an offline build.
6456 Do the following:
6457 <orderedlist>
6458 <listitem><para>
6459 Use a configuration generated by
6460 enabling
6461 <link linkend='maintaining-build-output-quality'>build history</link>.
6462 </para></listitem>
6463 <listitem><para>
6464 Use the
6465 <filename>buildhistory-collect-srcrevs</filename>
6466 command to collect the stored
6467 <filename>SRCREV</filename> values from
6468 the build's history.
6469 For more information on collecting these
6470 values, see the
6471 "<link linkend='build-history-package-information'>Build History Package Information</link>"
6472 section.
6473 </para></listitem>
6474 <listitem><para>
6475 Once you have the correct source
6476 revisions, you can modify those recipes
6477 to to set <filename>SRCREV</filename>
6478 to specific versions of the software.
6479 </para></listitem>
6480 </orderedlist>
6481 </para>
6482 </note>
6430 </para></listitem> 6483 </para></listitem>
6431 </orderedlist> 6484 </orderedlist>
6432 </para> 6485 </para>