diff options
Diffstat (limited to 'documentation/sdk-manual/sdk-appendix-customizing.xml')
-rw-r--r-- | documentation/sdk-manual/sdk-appendix-customizing.xml | 48 |
1 files changed, 25 insertions, 23 deletions
diff --git a/documentation/sdk-manual/sdk-appendix-customizing.xml b/documentation/sdk-manual/sdk-appendix-customizing.xml index 3ee0d7c90a..7a438725b6 100644 --- a/documentation/sdk-manual/sdk-appendix-customizing.xml +++ b/documentation/sdk-manual/sdk-appendix-customizing.xml | |||
@@ -17,11 +17,11 @@ | |||
17 | 17 | ||
18 | <para> | 18 | <para> |
19 | The extensible SDK primarily consists of a pre-configured copy of | 19 | The extensible SDK primarily consists of a pre-configured copy of |
20 | the build system from which it was produced. | 20 | the OpenEmbedded build system from which it was produced. |
21 | Thus, the SDK's configuration is derived using that build system. | 21 | Thus, the SDK's configuration is derived using that build system. |
22 | However, filters exist that are applied such as the following that | 22 | However, filters such as the following exist that the OpenEmbedded |
23 | are applied to <filename>local.conf</filename> and | 23 | build system applies to <filename>local.conf</filename> and |
24 | <filename>auto.conf</filename> when present: | 24 | <filename>auto.conf</filename> when these files are present: |
25 | <itemizedlist> | 25 | <itemizedlist> |
26 | <listitem><para> | 26 | <listitem><para> |
27 | Variables whose values start with "/" are excluded since the | 27 | Variables whose values start with "/" are excluded since the |
@@ -44,8 +44,9 @@ | |||
44 | Variables listed in | 44 | Variables listed in |
45 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_WHITELIST'><filename>SDK_LOCAL_CONF_WHITELIST</filename></ulink> | 45 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_LOCAL_CONF_WHITELIST'><filename>SDK_LOCAL_CONF_WHITELIST</filename></ulink> |
46 | are included. | 46 | are included. |
47 | Including these variables overrides either of the above two | 47 | Including a variable in the value of |
48 | conditions. | 48 | <filename>SDK_LOCAL_CONF_WHITELIST</filename> overrides either |
49 | of the above two conditions. | ||
49 | The default value is blank. | 50 | The default value is blank. |
50 | </para></listitem> | 51 | </para></listitem> |
51 | <listitem><para> | 52 | <listitem><para> |
@@ -68,9 +69,9 @@ | |||
68 | when present, are appended to the end of | 69 | when present, are appended to the end of |
69 | <filename>conf/local.conf</filename> within the produced SDK, without | 70 | <filename>conf/local.conf</filename> within the produced SDK, without |
70 | any filtering. | 71 | any filtering. |
71 | Not filtering these contents is particularly useful if you want to | 72 | The <filename>sdk-extra.conf</filename> file is particularly useful |
72 | set a variable value just for the SDK and not the build system used to | 73 | if you want to set a variable value just for the SDK and not the |
73 | create the SDK. | 74 | OpenEmbedded build system used to create the SDK. |
74 | </para> | 75 | </para> |
75 | </section> | 76 | </section> |
76 | 77 | ||
@@ -141,14 +142,14 @@ | |||
141 | appear in | 142 | appear in |
142 | <ulink url='&YOCTO_DOCS_REF_URL;#var-COREBASE'><filename>COREBASE</filename></ulink> | 143 | <ulink url='&YOCTO_DOCS_REF_URL;#var-COREBASE'><filename>COREBASE</filename></ulink> |
143 | (other than layers that are enabled through | 144 | (other than layers that are enabled through |
144 | <filename>bblayers.conf</filename>), then must list these | 145 | <filename>bblayers.conf</filename>), then you must list these |
145 | files in | 146 | files in |
146 | <ulink url='&YOCTO_DOCS_REF_URL;#var-COREBASE_FILES'><filename>COREBASE_FILES</filename></ulink> | 147 | <ulink url='&YOCTO_DOCS_REF_URL;#var-COREBASE_FILES'><filename>COREBASE_FILES</filename></ulink> |
147 | so that the files are copied into the SDK. | 148 | so that the files are copied into the SDK. |
148 | </para></listitem> | 149 | </para></listitem> |
149 | <listitem><para> | 150 | <listitem><para> |
150 | If your build system setup uses a different environment setup | 151 | If your OpenEmbedded build system setup uses a different |
151 | script other than | 152 | environment setup script other than |
152 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> | 153 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink> |
153 | or | 154 | or |
154 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>, | 155 | <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>, |
@@ -270,15 +271,16 @@ | |||
270 | <itemizedlist> | 271 | <itemizedlist> |
271 | <listitem><para> | 272 | <listitem><para> |
272 | If the mirror value you are setting is appropriate to | 273 | If the mirror value you are setting is appropriate to |
273 | be set for both the build system that is actually | 274 | be set for both the OpenEmbedded build system that is |
274 | building the SDK and the SDK itself (i.e. the mirror | 275 | actually building the SDK and the SDK itself (i.e. the |
275 | is accessible in both places or it will fail quickly | 276 | mirror is accessible in both places or it will fail |
276 | on the build system side, and its contents will not | 277 | quickly on the OpenEmbedded build system side, and its |
277 | interfere with the build), then you can set the | 278 | contents will not interfere with the build), then you |
278 | variable in your <filename>local.conf</filename> | 279 | can set the variable in your |
279 | or custom distro configuration file. | 280 | <filename>local.conf</filename> or custom distro |
280 | You can "whitelist" the variable through the SDK by | 281 | configuration file. |
281 | adding the following: | 282 | You can then "whitelist" the variable through |
283 | to the SDK by adding the following: | ||
282 | <literallayout class='monospaced'> | 284 | <literallayout class='monospaced'> |
283 | SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" | 285 | SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" |
284 | </literallayout> | 286 | </literallayout> |
@@ -324,8 +326,8 @@ | |||
324 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_EXT_TYPE'><filename>SDK_EXT_TYPE</filename></ulink> | 326 | <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_EXT_TYPE'><filename>SDK_EXT_TYPE</filename></ulink> |
325 | to "minimal" produces an SDK installer that is around 35 Mbytes in | 327 | to "minimal" produces an SDK installer that is around 35 Mbytes in |
326 | size, which downloads and installs quickly. | 328 | size, which downloads and installs quickly. |
327 | You need to realize, though, that the installer does not install any | 329 | You need to realize, though, that the minimal installer does not |
328 | libraries or tools out of the box. | 330 | install any libraries or tools out of the box. |
329 | These must be installed either "on the fly" or through actions you | 331 | These must be installed either "on the fly" or through actions you |
330 | perform using <filename>devtool</filename> or explicitly with the | 332 | perform using <filename>devtool</filename> or explicitly with the |
331 | <filename>devtool sdk-install</filename> command. | 333 | <filename>devtool sdk-install</filename> command. |