summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-02-04 12:17:21 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-02-14 17:24:02 +0000
commit38670f4719e93bee2c468ed6ec278b3b5beaa92e (patch)
tree53bc531e4e054633a7c186e09aa7891afcfda0c9 /documentation/ref-manual
parentc28948d9c3c021ba07665c869ff762e288a1621b (diff)
downloadpoky-38670f4719e93bee2c468ed6ec278b3b5beaa92e.tar.gz
ref-manual: Added PREMIRRORS glossary entry.
(From yocto-docs rev: a91e562db5c1581cb88f0254f8d5a170296f3e41) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml45
1 files changed, 45 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index dabf05989e..959b8c3418 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2487,6 +2487,51 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2487 </glossdef> 2487 </glossdef>
2488 </glossentry> 2488 </glossentry>
2489 2489
2490 <glossentry id='var-PREMIRRORS'><glossterm>PREMIRRORS</glossterm>
2491 <glossdef>
2492 <para>
2493 Specifies additional paths from which the OpenEmbedded
2494 build system gets source code.
2495 When the build system searches for source code, it first
2496 tries the local download directory.
2497 If that location fails, the build system tries locations
2498 defined by <filename>PREMIRRORS</filename>, the upstream
2499 source, and then locations specified by
2500 <link linkend='var-MIRRORS'><filename>MIRRORS</filename></link>
2501 in that order.
2502 </para>
2503
2504 <para>
2505 Assuming your distribution
2506 (<link linkend='var-DISTRO'><filename>DISTRO</filename></link>)
2507 is "poky", the default value for
2508 <filename>PREMIRRORS</filename> is defined in the
2509 <filename>conf/distro/poky.conf</filename> file in the
2510 <filename>meta-yocto</filename> Git repository.
2511 </para>
2512
2513 <para>
2514 Typically, you could add a specific server for the
2515 build system to attempt before any others by adding
2516 something like the following to the
2517 <filename>local.conf</filename> configuration file in the
2518 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>:
2519 <literallayout class='monospaced'>
2520 PREMIRRORS_prepend = "\
2521 git://.*/.* http://www.yoctoproject.org/sources/ \n \
2522 ftp://.*/.* http://www.yoctoproject.org/sources/ \n \
2523 http://.*/.* http://www.yoctoproject.org/sources/ \n \
2524 https://.*/.* http://www.yoctoproject.org/sources/ \n"
2525 </literallayout>
2526 These changes cause the build system to intercept
2527 Git, FTP, HTTP, and HTTPS requests and direct them to
2528 the <filename>http://</filename> sources mirror.
2529 You can use <filename>file://</filename> URLs to point
2530 to local directories or network shares as well.
2531 </para>
2532 </glossdef>
2533 </glossentry>
2534
2490 <glossentry id='var-PRINC'><glossterm>PRINC</glossterm> 2535 <glossentry id='var-PRINC'><glossterm>PRINC</glossterm>
2491 <glossdef> 2536 <glossdef>
2492 <para>Causes the <filename>PR</filename> variable of 2537 <para>Causes the <filename>PR</filename> variable of