summaryrefslogtreecommitdiffstats
path: root/documentation/poky-ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-10-15 13:27:35 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-10-17 17:32:52 +0100
commita1b04a126e917dbfe1275f985edd9f8a54de9b3f (patch)
tree50d28f0625568fdd3dfc21556d172bcc9be163e6 /documentation/poky-ref-manual
parent96a00c140292f693dbb30106c10154dbdbdac51f (diff)
downloadpoky-a1b04a126e917dbfe1275f985edd9f8a54de9b3f.tar.gz
documentation: poky-ref-manual - added note about PATH
Added a note explaining why "PATH" is needed when using SSTATE_MIRRORS if the shared state directory structure on the mirror is the same as SSTATE_DIR. (From yocto-docs rev: 94b8a45827d2bf7f16ec530de694ec5e4e6ed164) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/poky-ref-manual')
-rw-r--r--documentation/poky-ref-manual/technical-details.xml18
1 files changed, 14 insertions, 4 deletions
diff --git a/documentation/poky-ref-manual/technical-details.xml b/documentation/poky-ref-manual/technical-details.xml
index 8ce9e5da1b..2e30df1604 100644
--- a/documentation/poky-ref-manual/technical-details.xml
+++ b/documentation/poky-ref-manual/technical-details.xml
@@ -442,14 +442,24 @@
442 442
443 <para> 443 <para>
444 Behind the scenes, the shared state code works by looking in 444 Behind the scenes, the shared state code works by looking in
445 <filename>SSTATE_DIR</filename> and 445 <link linkend='var-SSTATE_DIR'><filename>SSTATE_DIR</filename></link> and
446 <filename>SSTATE_MIRRORS</filename> for shared state files. 446 <link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link>
447 for shared state files.
447 Here is an example: 448 Here is an example:
448 <literallayout class='monospaced'> 449 <literallayout class='monospaced'>
449 SSTATE_MIRRORS ?= "\ 450 SSTATE_MIRRORS ?= "\
450 file://.* http://someserver.tld/share/sstate/ \n \ 451 file://.* http://someserver.tld/share/sstate/PATH \n \
451 file://.* file:///some/local/dir/sstate/" 452 file://.* file:///some/local/dir/sstate/PATH"
452 </literallayout> 453 </literallayout>
454 <note>
455 The shared state directory (<filename>SSTATE_DIR</filename>) is
456 organized into two-character subdirectories, where the subdirectory
457 names are based on the first two characters of the hash.
458 If the shared state directory structure for a mirror has the
459 same structure as <filename>SSTATE_DIR</filename>, you must
460 specify "PATH" as part of the URI to enable the build system
461 to map to the appropriate subdirectory.
462 </note>
453 </para> 463 </para>
454 464
455 <para> 465 <para>