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. |
