summaryrefslogtreecommitdiffstats
path: root/documentation/yocto-project-qs/yocto-project-qs.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/yocto-project-qs/yocto-project-qs.xml')
-rw-r--r--documentation/yocto-project-qs/yocto-project-qs.xml68
1 files changed, 14 insertions, 54 deletions
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index b1746aec8f..61327f567c 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -895,42 +895,14 @@
895 <para> 895 <para>
896 A good deal that goes into a Yocto Project build is simply 896 A good deal that goes into a Yocto Project build is simply
897 downloading all of the source tarballs. 897 downloading all of the source tarballs.
898 Maybe you have been working with another build system 898 Steps exist that can help you be more efficient with gathering
899 (OpenEmbedded or Angstrom) for which you have built up a sizable 899 source files.
900 directory of source tarballs. 900 For example, you can set up local mirrors that hold your
901 Or, perhaps someone else has such a directory for which you have 901 source tarballs or you can pre-fetch all your source without
902 read access. 902 initiating a build until later.
903 If so, you can save time by adding statements to your 903 For more information, see the
904 configuration file so that the build process checks local 904 "<ulink url='&YOCTO_DOCS_DEV_URL;#working-with-source-files'>Working with Source Files</ulink>"
905 directories first for existing tarballs before checking the 905 section in the Yocto Project Development Manual.
906 Internet.
907 Here is an efficient way to set it up in your
908 <filename>local.conf</filename> file:
909 <literallayout class='monospaced'>
910 SOURCE_MIRROR_URL ?= "file:///home/you/your-download-dir/"
911 INHERIT += "own-mirrors"
912 BB_GENERATE_MIRROR_TARBALLS = "1"
913 # BB_NO_NETWORK = "1"
914 </literallayout>
915 </para>
916
917 <para>
918 In the previous example, the
919 <ulink url='&YOCTO_DOCS_REF_URL;#var-BB_GENERATE_MIRROR_TARBALLS'><filename>BB_GENERATE_MIRROR_TARBALLS</filename></ulink>
920 variable causes the OpenEmbedded build system to generate tarballs
921 of the Git repositories and store them in the
922 <ulink url='&YOCTO_DOCS_REF_URL;#var-DL_DIR'><filename>DL_DIR</filename></ulink>
923 directory.
924 Due to performance reasons, generating and storing these tarballs
925 is not the build system's default behavior.
926 </para>
927
928 <para>
929 You can also use the
930 <ulink url='&YOCTO_DOCS_REF_URL;#var-PREMIRRORS'><filename>PREMIRRORS</filename></ulink>
931 variable.
932 For an example, see the variable's glossary entry in the
933 Yocto Project Reference Manual.
934 </para> 906 </para>
935 </section> 907 </section>
936 908
@@ -949,25 +921,13 @@
949 </para> 921 </para>
950 922
951 <para> 923 <para>
952 Here are some variations on the build process that could be helpful: 924 By default, BitBake aborts when it encounters an error during
953 <itemizedlist> 925 the build.
954 <listitem><para>Fetch all the necessary sources without starting 926 If you want to make sure the build continues even when BitBake
955 the build: 927 encounters an error, use this variation:
956 <literallayout class='monospaced'> 928 <literallayout class='monospaced'>
957 $ bitbake -c fetchall core-image-minimal
958 </literallayout>
959 This variation guarantees that you have all the sources for
960 that BitBake target should you disconnect from the net and
961 want to do the build later offline.</para></listitem>
962 <listitem><para>Specify to continue the build even if BitBake
963 encounters an error.
964 By default, BitBake aborts the build when it encounters an
965 error.
966 This command keeps a faulty build going:
967 <literallayout class='monospaced'>
968 $ bitbake -k core-image-minimal 929 $ bitbake -k core-image-minimal
969 </literallayout></para></listitem> 930 </literallayout>
970 </itemizedlist>
971 </para> 931 </para>
972 932
973 <para> 933 <para>