From 40fde06345c61ca77bb40341e048673613f9932f Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 4 Feb 2013 12:56:16 -0600 Subject: ref-manual: Edits to the question on how source code is fetched. Updated the question that asks "How doe the OpenEmbedded build system obtain source code and will it work behind my firewall or proxy server?". Some of the variables did not have links or proper font type. (From yocto-docs rev: be1f665b480a47483595381c9a837892100007e8) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/faq.xml | 81 ++++++++++++++++++++++++---------------- 1 file changed, 49 insertions(+), 32 deletions(-) diff --git a/documentation/ref-manual/faq.xml b/documentation/ref-manual/faq.xml index 176573de28..370f65f380 100644 --- a/documentation/ref-manual/faq.xml +++ b/documentation/ref-manual/faq.xml @@ -485,30 +485,38 @@ - How does the OpenEmbedded build system obtain source code and will it work behind my - firewall or proxy server? + How does the OpenEmbedded build system obtain source code and + will it work behind my firewall or proxy server? - The way the build system obtains source code is highly configurable. - You can setup the build system to get source code in most environments if - HTTP transport is available. + The way the build system obtains source code is highly + configurable. + You can setup the build system to get source code in most + environments if HTTP transport is available. - When the build system searches for source code, it first tries the local download directory. - If that location fails, Poky tries PREMIRRORS, the upstream source, - and then MIRRORS in that order. + When the build system searches for source code, it first + tries the local download directory. + If that location fails, Poky tries + PREMIRRORS, + the upstream source, and then + MIRRORS + in that order. - By default, the OpenEmbedded build system uses the Yocto Project source PREMIRRORS - for SCM-based sources, - upstreams for normal tarballs, and then falls back to a number of other mirrors - including the Yocto Project source mirror if those fail. + Assuming your distribution is "poky", the OpenEmbedded build + system uses the Yocto Project source + PREMIRRORS by default for SCM-based + sources, upstreams for normal tarballs, and then falls back + to a number of other mirrors including the Yocto Project + source mirror if those fail. - As an example, you could add a specific server for Poky to attempt before any - others by adding something like the following to the local.conf + As an example, you could add a specific server for the + build system to attempt before any others by adding something + like the following to the local.conf configuration file: PREMIRRORS_prepend = "\ @@ -519,26 +527,29 @@ - These changes cause Poky to intercept Git, FTP, HTTP, and HTTPS - requests and direct them to the http:// sources mirror. - You can use file:// URLs to point to local directories - or network shares as well. + These changes cause the build system to intercept Git, FTP, + HTTP, and HTTPS requests and direct them to the + http:// sources mirror. + You can use file:// URLs to point to + local directories or network shares as well. Aside from the previous technique, these options also exist: BB_NO_NETWORK = "1" - This statement tells BitBake to throw an error instead of trying to access the - Internet. - This technique is useful if you want to ensure code builds only from local sources. + This statement tells BitBake to issue an error instead of + trying to access the Internet. + This technique is useful if you want to ensure code builds + only from local sources. Here is another technique: BB_FETCH_PREMIRRORONLY = "1" - This statement limits Poky to pulling source from the PREMIRRORS only. + This statement limits Poky to pulling source from the + PREMIRRORS only. Again, this technique is useful for reproducing builds. @@ -548,12 +559,15 @@ This statement tells Poky to generate mirror tarballs. This technique is useful if you want to create a mirror server. - If not, however, the technique can simply waste time during the build. + If not, however, the technique can simply waste time during + the build. - Finally, consider an example where you are behind an HTTP-only firewall. - You could make the following changes to the local.conf - configuration file as long as the PREMIRROR server is up to date: + Finally, consider an example where you are behind an + HTTP-only firewall. + You could make the following changes to the + local.conf configuration file as long as + the PREMIRRORS server is up to date: PREMIRRORS_prepend = "\ ftp://.*/.* http://www.yoctoproject.org/sources/ \n \ @@ -561,14 +575,17 @@ https://.*/.* http://www.yoctoproject.org/sources/ \n" BB_FETCH_PREMIRRORONLY = "1" - These changes would cause Poky to successfully fetch source over HTTP and - any network accesses to anything other than the PREMIRROR would fail. + These changes would cause the build system to successfully + fetch source over HTTP and any network accesses to anything + other than the PREMIRRORS would fail. - The build system also honors the standard shell environment variables - http_proxy, ftp_proxy, - https_proxy, and all_proxy - to redirect requests through proxy servers. + The build system also honors the standard shell environment + variables http_proxy, + ftp_proxy, + https_proxy, and + all_proxy to redirect requests through + proxy servers. -- cgit v1.2.3-54-g00ecf