From 5e5252bf13835abb1cdf61bbb353c1e7711d455e Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Thu, 16 Dec 2021 15:01:58 +0100 Subject: quick start manual: update Share State and Hash Equivalence settings (From yocto-docs rev: 8668f070a5f2bf70f71f1ac53d2fac1b0faff82d) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/brief-yoctoprojectqs/index.rst | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) (limited to 'documentation/brief-yoctoprojectqs') diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index c0419531e2..eaacde2d9a 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst @@ -244,19 +244,24 @@ an entire Linux distribution, including the toolchain, from source. .. tip:: You can significantly speed up your build and guard against fetcher - failures by using mirrors. To use mirrors, add these lines to your - local.conf file in the Build directory:: + failures by using :ref:`overview-manual/concepts:shared state cache` + mirrors and enabling :ref:`overview-manual/concepts:hash equivalence`. + This way, you can use pre-built artifacts rather than building them. + This is relevant only when your network and the server that you use + can download these artifacts faster than you would be able to build them. - SSTATE_MIRRORS = "\ - file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH \n \ - file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION_MINUS_ONE;/PATH;downloadfilename=PATH \n \ - file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION;/PATH;downloadfilename=PATH \n \ - " + To use such mirrors, uncomment the below lines in your ``local.conf`` + file in the :term:`Build Directory`:: + BB_SIGNATURE_HANDLER = "OEEquivHash" + BB_HASHSERVE = "auto" + BB_HASHSERVE_UPSTREAM = "typhoon.yocto.io:8687" + SSTATE_MIRRORS ?= "file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION;/PATH;downloadfilename=PATH" - The previous examples showed how to add sstate paths for Yocto Project - &YOCTO_DOC_VERSION_MINUS_ONE;, &YOCTO_DOC_VERSION;, and a development - area. For a complete index of sstate locations, see :yocto_sstate:`/`. + The above settings assumed the use of Yocto Project &YOCTO_DOC_VERSION;. + If you are using the development version instead, set :term:`SSTATE_MIRRORS` as follows:: + + SSTATE_MIRRORS ?= "file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH" #. **Start the Build:** Continue with the following command to build an OS image for the target, which is ``core-image-sato`` in this example: -- cgit v1.2.3-54-g00ecf