From 32651058c0ae2263a0684fcefe1a82504a9ac366 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 15 Jan 2018 11:30:54 -0800 Subject: [PATCH] dev-manual, ref-manual: Moved building image to dev-manual Fixes [YOCTO #12370] The section in the ref-manual that overviewed the buld process was redundant and more of a "how-to" topic. I have moved and merged it into the dev-manual into a similar area. (From yocto-docs rev: 44f1351334342629aaa0976f62e64ac4f67166aa) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/Makefile | 3 +- documentation/dev-manual/dev-manual-start.xml | 134 +++++++++++++++-- .../ref-manual/figures/building-an-image.png | Bin 14891 -> 0 bytes documentation/ref-manual/usingpoky.xml | 141 ------------------ 4 files changed, 120 insertions(+), 158 deletions(-) delete mode 100755 documentation/ref-manual/figures/building-an-image.png diff --git a/documentation/Makefile b/documentation/Makefile index e9ec914df9..c08d912302 100644 --- a/documentation/Makefile +++ b/documentation/Makefile @@ -214,7 +214,7 @@ TARFILES = mega-manual.html mega-style.css figures/yocto-environment.png \ figures/wip.png else TARFILES = mega-manual.html mega-style.css \ - figures/building-an-image.png figures/YP-flow-diagram.png \ + figures/YP-flow-diagram.png \ figures/using-a-pre-built-image.png \ figures/poky-title.png figures/buildhistory.png \ figures/buildhistory-web.png \ @@ -282,7 +282,6 @@ XSLTOPTS = --xinclude ALLPREQ = html eclipse tarball TARFILES = ref-manual.html ref-style.css figures/poky-title.png \ figures/buildhistory.png figures/buildhistory-web.png \ - figures/building-an-image.png \ figures/build-workspace-directory.png \ eclipse MANUALS = $(DOC)/$(DOC).html $(DOC)/eclipse diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 4c6c441fe0..dc30659159 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -701,13 +701,16 @@ -
- Performing a Simple Build +
+ Building an Image + In the development environment, you need to build an image whenever + you change hardware support, add or change system libraries, or add + or change services that have dependencies. Several methods exist that allow you to build an image within the Yocto Project. - This procedure shows how to build an image using BitBake from a + This section shows you how to build an image using BitBake from a Linux host. Notes @@ -715,7 +718,7 @@ For information on how to build an image using Toaster, see the - Yocto Project Toaster Manual. + Toaster Manual. For information on how to use @@ -724,6 +727,12 @@ section in the Yocto Project Application Development and the Extensible Software Development Kit (eSDK) manual. + + For a practical example on how to build an image using the + OpenEmbedded build system, see the + "Building Images" + section of the Yocto Project Quick Start. + @@ -736,9 +745,6 @@ For detailed information on the build process using BitBake, see the "Images" section in the Yocto Project Overview Manual. - You can also reference the - "Building Images" - section in the Yocto Project Quick Start. @@ -757,14 +763,30 @@ Initialize the Build Environment: Initialize the build environment by sourcing the build environment script (i.e. - &OE_INIT_FILE;). + &OE_INIT_FILE;): + + $ source &OE_INIT_FILE; [build_dir] + + + When you use the initialization script, the + OpenEmbedded build system uses build as + the default Build Directory in your current work directory. + You can use a build_dir argument + with the script to specify a different build directory. + Tip + A common practice is to use a different Build Directory for + different targets. + For example, ~/build/x86 for a + qemux86 target, and + ~/build/arm for a + qemuarm target. + Make Sure Your local.conf File is Correct: Ensure the conf/local.conf configuration - file, which is found in the - Build Directory, + file, which is found in the Build Directory, is set up how you want it. This file defines many aspects of the build environment including the target machine architecture through the @@ -772,18 +794,100 @@ the packaging format used during the build (PACKAGE_CLASSES), and a centralized tarball download directory through the - DL_DIR variable. + DL_DIR variable. Build the Image: - Build the image using the bitbake command. - For example, the following command builds the + Build the image using the bitbake command: + + $ bitbake target + + + For information on BitBake, see the + BitBake User Manual. + + The target is the name of the + recipe you want to build. + Common targets are the images in + meta/recipes-core/images, + meta/recipes-sato/images, etc. all found + in the + Source Directory. + Or, the target can be the name of a recipe for a specific + piece of software such as BusyBox. + For more details about the images the OpenEmbedded build + system supports, see the + "Images" + chapter in the Yocto Project Reference Manual. + + As an example, the following command builds the core-image-minimal image: $ bitbake core-image-minimal - For information on BitBake, see the - BitBake User Manual. + Once an image has been built, it often needs to be installed. + The images and kernels built by the OpenEmbedded build system + are placed in the Build Directory in + tmp/deploy/images. + For information on how to run pre-built images such as + qemux86 and qemuarm, + see the + Yocto Project Application Development and the Extensible Software Development Kit (eSDK) + manual. + For information about how to install these images, see the + documentation for your particular board or machine. + Build Notes + + + If you experience a build error due to resources + temporarily being unavailable and it appears you + should not be having this issue, it might be due + to the combination of a 4.3+ Linux kernel and + systemd version 228+ + (i.e. see this + link + for information). + + To work around this issue, you can try either + of the following: + + + Try the build again. + + + Modify the "DefaultTasksMax" + systemd parameter + by uncommenting it and setting it to + "infinity". + You can find this parameter in the + system.conf file + located in + /etc/systemd + on most systems. + + + + + Building an image without GNU General Public + License Version 3 (GPLv3), or similarly licensed, + components is supported for only minimal and + base images. + See the + "Images" + chapter in the Yocto Project Reference Manual + for more information. + + + When building an image using GPL components, + you need to maintain your original settings and + not switch back and forth applying different + versions of the GNU General Public License. + If you rebuild using different versions of GPL, + dependency errors might occur due to some components + not being rebuilt. + + + diff --git a/documentation/ref-manual/figures/building-an-image.png b/documentation/ref-manual/figures/building-an-image.png deleted file mode 100755 index 1fbea5ab008e1dc864105851173e7ed64edd4b71..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14891 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

1)XHaLs%xNRo7Wne-? z+&14;8LkDT=GEd3v|nA4NX*Jpjv+B@u<6qp$T^5$wpVF26CL6?>fY;VDQ(xY{Z5WS z@{CrJ4=Q&9icy3e&F>+t0;Tu+=>rfsoxHdTTrh40WFW%j=WryWItvbhqmhSd1C3y) z)1TWd3VPh;;NG_@!oG=E!$s(9w4v(h(s(ZyuqSL{U?Fknr#vPvUJ9T*y z!QxDlTTL?1y)@$+G^X$v*yK7z&2KE*CdN6%wsOplJzfGYZ~D# zHv$m6cV1d%r4Ja^gpT!HwL(dj$}@)2CNGSj>fa*%9!2TSLYc;&h%!AAN3?ih4Q;!{ z*33R-F8g0wsf65P9x=Q1eGZ$cvB>$^wti)hzPRrGaOSn0>*-mA`wTXI3>xB8-SLjN zs=U;}S-dB+Y%3OF3Pg8Z#@hUN{B|iLfyB7l^)j@>@~tz)5Fc#af=yq)`xXN}Eg0uw z&*Kk(P=t19RjA1w6w^Q&&p!<{^sG~C)q`sZDR*YffG+*U9tL<-7dW#m8PeWl1X|k?q4l=k#J{Ms47;PL-f<4~qunj$3eRS>i65t{&EM$1^ ze~lM_0SFJdp5<7;FEfxpSsMPUK7jM3N6!Hy2CEtZow`GsU4_^t!*hk%*%S9hyJZI_ z8{g8?(jtOOrWOi+f1-E>GjS;U*Xv!7L^F?QESzGm6D!8vIZM;aMynC^Uq9JU7WUi) zX=xFRk%LL2{?iAC2m2at93X-f77hes6#(>wms0qL`#~oD>2~PQ`;^)qBv{Waj8zZu zBU37X7H#SNLyL^CI&gIb{S{U|(X*s);(?8#+TDK3ib8~a^HV&=J|AzO@ z`7!$0fVMaf_DB6#PUyx;jQ7fKWuwj&lcS%XTyXY^ueRE#mjBHh2}4uYf_0JedFWH^ zGbKo>UJq)uXMFMgJ-52qSwI{Bmwh|>Zt!w*5D^u}gm6yIT?#`a@+sjv{J>t;<=e*$ zE2q|eQ#z}z9V^=TA}7epVb9;(X-nk!GrC7x0mdqMi%FXZiWU4VQE}!s7+F`B)s0DK z%@3E?aw`A<;}i;Cv#!Q*QB07M#K8qsb^Q3W__E;D69OA%fICuH{*AMjy!hxa#p)S; zl9EW{p6#nNH?;XMHuCMVStWxFzlhQaQYyuQ~e@2ufhE3hNg#=(>^gs%PM;IG$!N#KSG-Q>baU zmR${znS7LE)w!)pOGN6SQ$@}@KiKThTrq9%1QC;ihaEpPK6cvTYb)>CNx3;*%VIB< z&nvYUrOJkHuft=%+Q02rO<6YbzcyMW7s)RaTuB$0^^?F~a6nuH}T7mT6lFZv1E z!ICgfcaQCe{lij$>u7+*)KQU0)}WuPq-aJ$SQl!t_$i~!He`lEIQm6Q>wr13 zD{0W+YGf*`4HFq`+;lQNY}I|ax%U+&)B)ti^X<+n9VXq*(L!Sl)DInC@MC{$L#}CGuszb=1O1MH7l5^gkjw*N|GJW!5};q z)+_iQwp$H_rn^j{gm+~aoYmRO4#T4tfrsWYfZG6x9PArINU|<#9o0F|pMmuY+}8pH zf-f`>rHngJ%hkI5Mw4i_C@6@w0hrhLpO^oIc~?b?u@&hT9=K_FU~uHPX#RXP^0lq* zyeTJXObv*d1ADbR?2VAHw^rmD8T}FlA)v+yGiB7E>Up-69AJ5#>i5^>r_L= z_fd;=&jv3dYf<>3#fvtcBAcvh=C<-zGD-EM=}QZ~-NkC4i(dXR2eRQ}3Vo(+-Wt+f z7lT#6Tpi(7jgCw@=_`mHL8B2hb#XSqsh)j7UzB&*7mAn>;z2Ipyp^^IAeYJ1?oumN zC6u?S{4%1rDXWHYQG29d>Z*_JTfc%|kXmXDd{dBT_7``LtW|`C2oPW5-&&E+gLcmZ z_{=(VK!!4(34i`Trqnjqn}W!zLOwS*OHR>e-@5fdWJvaAOGaXe^eBXiW!FQc!fSF~ zS;~JZ=Lnah%pd34V&VMK*Ulu5GFbXWO+)XY9>XYm#aYfEdNK%{NEG|0#rs6(+S%g- zGSCfKdwjSO@iJn8l6_I13)oy?9)#3r-g%{;Rl#&_6$^u|Bs0 zna2kYAI_F@4stA2DP!KL5(>F`pQjjipi`e3P=x)bq@lrmG^soar>br2YjsAbhheMp z%N?}>abvcUmwjHh3dR7>^p*K(Q4>5>-+mIp0l5VWHI-{@$G1y}{%b0YsCgmt{&yLs z&iJg*!hQ8S*zq1D^qs>h^cDJqywu(7^*ABnH!im2OeNp1Ksr-IZCyy_nbX~ zZ=rmziYPaQL=8g547<0u&p6>G*17>s8+wu@xepGaauq@s@B5EtV(S1b?p>w-diCiG z?dM7>@;i=ZXo;NObhglL3W>SI_;Bbdb7&1aacLOq7(R89E)H+aYNssNC4nYN1HI@o z=!U1Rj*fZSctwE;zRvgV-(QK^B=oejN`AHrdSKfcfk<8|V!{xtH1k!^VR4d_Q%99L zRaAi&!&u}&xMJVaGE7$*ZPmM1&jw=%UhNo}{f9RhQplkmfHCvb@%dh6!AvU$7A?u) zcj_lx`_Zl^7wP4H$-BGuxZ{)77!-5_{is#nEn!RD3RJWxM!zDO0S*|4B*U+<)V~ON zeJV&J$|EkiBKYy44SY4mm_Z>5i8ZLKs?PE7DVOf$h5=|Z!IawzfYs6N{RCJ(mBa-I zysQ9U@}y29O6&bqB(Q5Llry%gbd62AAmk#KBbQMalAYIG<4a@Lg#WrujDbCM!U-C! zGHF8^7$L%*Xg|jLCk8@dZS(Cr{Jq0B5ms|tOx)H2uj0x0UaK2WiFmO&AO9H_sze3= z-P}A`LWBzd@>l&)WWgLEMX7#5Vj7@fVzLT!w)W=9DFq8BGn|$=0?)?w>*h2iXcNq^ z1$M0PUf)Jzp@2QUGd-EDVH~0|p2D14@=f4yn&WF@C4s{xGdlDz#L6xCXouw_<>HIL z8V!H{{$rsNxV31ya37kM%GVwJ4 z!q*uOX=20)Q?3G?KYD|HtS*2K$BO|p;ic8@_df;YhPbq(nsH2A|EC%Fw+V*^Jw2ja z57m47`)K8^wYM8tE1NnvK*>C-)q28OCd$PBo3VG9BzCRB2N4e;g&rVb$Y@N7mJXqE zC0mGJE4N@SFHESQK>K{xbmGjeVjuRZ?G*qf5#3!?aar$7p%4+ppEQZkwKp_ycV8kU z8#y_#A90TVL{b9|lK)Gr%)PkjhY8BBM7<557-ECg*RG>bef2YI!4(+hs*0g;8H{#V z4Z1t)Lcn>KBXB$(^d|^=5TVJX`*(VfK|)f>vU`nu!@r((JM11=!z-*~`S=N4Y}NJt zp)qRB{N{GBbuH*U^Oq8ZM7mKR%2MR3v>moA`(3n|Pi9i1Mu=@5-t5#4iS>W@fIpeH z>3fpOg+1L>AmUv^6W9u21s0HJ`R@Wkc!Ifvr6@_L&j3V_c@kqXmlCZp0}TI|D}%FwvfdAi6%rf^MrmdI=A4(Dwp!dM=u2hceI}; zih`~=jSYFWJrB`dx z=1TiDZe7(fbEiq+SLVBbtz>dq<}467zay!I?4&v@czG5@N=sDY;LttnDEkABNNN z1pV!YTw@SvVM+QPjycV2);9hFI7wd!pw9*R=Ez?BM{q-O3_L%~VLy^mf+uya%gE|`F=*Al*8-d=z)ir(c9X}A{Z!oi^8W8e znjA+eS24?8Q>I^({%=tR9QlCzU(KPlfIy6p_hzm9*GWhK3L4&N>zPCR3|8LsmsA3f z4HPP$s0u-x@n%o7f&Y?evLs}IU@d&^Z;xd7AD+lIjz(_D4f$ov^=XKxquJltdosu^ zk9!Ua<2jgqg5*yxd9d5>-iLQ{AMXgVUkMY$7#jRYxR1IO9he+b7O>+xuwd{wNgIFO zdkdd=4yczDagy&TjDY$3@s~mr13Tk+9o9s~0Fz|XgiVK=BAh>T9(KQGRu$P=TiB!B zk{Q;nL9(yI1iCB?pJgyhDLvrSqK7rd^>*6MN|+&-4GP19>Hi{FmV_ffU7h7K+Zs$& zOfc076D>~2oi{_o1Qcd@H^#~anO_k9hc@yQ`7gONMm{S0-&;+a_l?x4D1b-d$>2w6 zf7;+h(NND;ofcr7$VurNe*a@+39PrZ_=hhj&iU9{qc=@6&pwHE~4&+gl^7 zsc`BZo|*yX^ z3^|>7Lh}HV`%r^&7fsc%P1$yO2SX+B5eL2?5bJ$G8bi(acmv^Iw|T};nX~vGmW3N4 zTeXyVal+|y5}mgjs)DOg^Zh%h2eaf}d(kubI2i6E5^e?44_0BU7QVWGq~OVKi~da% z;LzMf&a07u=Hsksto~R*=wV2sgMv6%q#8Ynm|nED!!WX~I;YWDdw=mOi*J8c3T80O zsjy-A|3-Q8{+a)=ViFEo=885+4~x}%@;{HC2LJJ%VJxn5kY3ljd3KWj+$Sf8e5-nk zf+Xz7I$n9o4)nzVLc4hddm-7>Y}fBQ*?XWa)9b@F`lM59*vdfAxC7*&lyR8SHGM$p0rh1R|~#;gi5{Gc?*? z@@eP#kYo%H{8bk|?X@^SA_!cG>-Jadhj+Z`?(n>H(MuwRe+H3mA~XeFg-3{K&&sW;_?t+Dg=1zVq5~YKJbVWMB@1DeYOfN QAn=4!l2endkv0qaKXjC1u>b%7 diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml index 73b5df88dd..bfca60a99b 100644 --- a/documentation/ref-manual/usingpoky.xml +++ b/documentation/ref-manual/usingpoky.xml @@ -11,147 +11,6 @@ documentation set provide more details on how to use the Yocto Project. -

- Running a Build - - - This section provides a summary of the build process and provides information - for less obvious aspects of the build process. - For general information on how to build an image using the OpenEmbedded build - system, see the - "Building Images" - section of the Yocto Project Quick Start. - - -
- Build Overview - - - In the development environment you will need to build an image whenever you change hardware - support, add or change system libraries, or add or change services that have dependencies. - - - - - - - - Building an Image - - - - - The first thing you need to do is set up the OpenEmbedded build - environment by sourcing the environment setup script - (i.e. - &OE_INIT_FILE;). - Here is an example: - - $ source &OE_INIT_FILE; [build_dir] - - - - - The build_dir argument is optional and specifies the directory the - OpenEmbedded build system uses for the build - - the - Build Directory. - If you do not specify a Build Directory, it defaults to a directory - named build in your current working directory. - A common practice is to use a different Build Directory for different targets. - For example, ~/build/x86 for a qemux86 - target, and ~/build/arm for a qemuarm target. - - - - Once the build environment is set up, you can build a target using: - - $ bitbake target - - - - If you experience a build error due to resources - temporarily being unavailable and it appears you - should not be having this issue, it might be due - to the combination of a 4.3+ Linux kernel and - systemd version 228+ - (i.e. see this - link - for information). - - - - To work around this issue, you can try either - of the following: - - - Try the build again. - - - Modify the "DefaultTasksMax" - systemd parameter - by uncommenting it and setting it to - "infinity". - You can find this parameter in the - system.conf file - located in - /etc/systemd - on most systems. - - - - - - - - The target is the name of the recipe you want to build. - Common targets are the images in meta/recipes-core/images, - meta/recipes-sato/images, etc. all found in the - Source Directory. - Or, the target can be the name of a recipe for a specific piece of software such as - BusyBox. - For more details about the images the OpenEmbedded build system supports, see the - "Images" chapter. - - - - Building an image without GNU General Public License Version - 3 (GPLv3), or similarly licensed, components is supported for - only minimal and base images. - See the "Images" chapter for more information. - -
- -
- Building an Image Using GPL Components - - - When building an image using GPL components, you need to maintain your original - settings and not switch back and forth applying different versions of the GNU - General Public License. - If you rebuild using different versions of GPL, dependency errors might occur - due to some components not being rebuilt. - -
-
- -
- Installing and Using the Result - - - Once an image has been built, it often needs to be installed. - The images and kernels built by the OpenEmbedded build system are placed in the - Build Directory in - tmp/deploy/images. - For information on how to run pre-built images such as qemux86 - and qemuarm, see the - Yocto Project Application Development and the Extensible Software Development Kit (eSDK) - manual. - For information about how to install these images, see the documentation for your - particular board or machine. - -
-
Debugging Tools and Techniques