diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2021-12-16 15:01:58 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2022-01-07 11:12:06 +0000 |
commit | 5e5252bf13835abb1cdf61bbb353c1e7711d455e (patch) | |
tree | 88deebd765e04a3ddd1929af3f73de0cb86e1389 /documentation/brief-yoctoprojectqs | |
parent | 36d200ab0adbf76d6d8197551b3304afcf069716 (diff) | |
download | poky-5e5252bf13835abb1cdf61bbb353c1e7711d455e.tar.gz |
quick start manual: update Share State and Hash Equivalence settings
(From yocto-docs rev: 8668f070a5f2bf70f71f1ac53d2fac1b0faff82d)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/brief-yoctoprojectqs')
-rw-r--r-- | documentation/brief-yoctoprojectqs/index.rst | 25 |
1 files changed, 15 insertions, 10 deletions
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. | |||
244 | .. tip:: | 244 | .. tip:: |
245 | 245 | ||
246 | You can significantly speed up your build and guard against fetcher | 246 | You can significantly speed up your build and guard against fetcher |
247 | failures by using mirrors. To use mirrors, add these lines to your | 247 | failures by using :ref:`overview-manual/concepts:shared state cache` |
248 | local.conf file in the Build directory:: | 248 | mirrors and enabling :ref:`overview-manual/concepts:hash equivalence`. |
249 | This way, you can use pre-built artifacts rather than building them. | ||
250 | This is relevant only when your network and the server that you use | ||
251 | can download these artifacts faster than you would be able to build them. | ||
249 | 252 | ||
250 | SSTATE_MIRRORS = "\ | 253 | To use such mirrors, uncomment the below lines in your ``local.conf`` |
251 | file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH \n \ | 254 | file in the :term:`Build Directory`:: |
252 | file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION_MINUS_ONE;/PATH;downloadfilename=PATH \n \ | ||
253 | file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION;/PATH;downloadfilename=PATH \n \ | ||
254 | " | ||
255 | 255 | ||
256 | BB_SIGNATURE_HANDLER = "OEEquivHash" | ||
257 | BB_HASHSERVE = "auto" | ||
258 | BB_HASHSERVE_UPSTREAM = "typhoon.yocto.io:8687" | ||
259 | SSTATE_MIRRORS ?= "file://.* http://sstate.yoctoproject.org/&YOCTO_DOC_VERSION;/PATH;downloadfilename=PATH" | ||
256 | 260 | ||
257 | The previous examples showed how to add sstate paths for Yocto Project | 261 | The above settings assumed the use of Yocto Project &YOCTO_DOC_VERSION;. |
258 | &YOCTO_DOC_VERSION_MINUS_ONE;, &YOCTO_DOC_VERSION;, and a development | 262 | If you are using the development version instead, set :term:`SSTATE_MIRRORS` as follows:: |
259 | area. For a complete index of sstate locations, see :yocto_sstate:`/`. | 263 | |
264 | SSTATE_MIRRORS ?= "file://.* http://sstate.yoctoproject.org/dev/PATH;downloadfilename=PATH" | ||
260 | 265 | ||
261 | #. **Start the Build:** Continue with the following command to build an OS | 266 | #. **Start the Build:** Continue with the following command to build an OS |
262 | image for the target, which is ``core-image-sato`` in this example: | 267 | image for the target, which is ``core-image-sato`` in this example: |