summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/migration.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r--documentation/ref-manual/migration.xml231
1 files changed, 231 insertions, 0 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 3dc141c552..f5c87bdd9e 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -2013,6 +2013,237 @@
2013 </section> 2013 </section>
2014</section> 2014</section>
2015 2015
2016<section id='moving-to-the-yocto-project-1.8-release'>
2017 <title>Moving to the Yocto Project 1.8 Release</title>
2018
2019 <para>
2020 This section provides migration information for moving to the
2021 Yocto Project 1.8 Release from the prior release.
2022 </para>
2023
2024 <section id='migration-1.8-removed-recipes'>
2025 <title>Removed Recipes</title>
2026
2027 <para>
2028 The following recipes have been removed:
2029 <itemizedlist>
2030 <listitem><para><filename>owl-video</filename>:
2031 Functionality replaced by <filename>gst-player</filename>.
2032 </para></listitem>
2033 <listitem><para><filename>gaku</filename>:
2034 Functionality replaced by <filename>gst-player</filename>.
2035 </para></listitem>
2036 <listitem><para><filename>gnome-desktop</filename>:
2037 No longer needed.
2038 </para></listitem>
2039 <listitem><para><filename>gsettings-desktop-schemas</filename>:
2040 No longer needed.
2041 </para></listitem>
2042 <listitem><para><filename>python-argparse</filename>:
2043 The <filename>argparse</filename> module is already
2044 provided in the default Python distribution in a
2045 package named <filename>python-argparse</filename>.
2046 Consequently, the separate
2047 <filename>python-argparse</filename> recipe is no
2048 longer needed.
2049 </para></listitem>
2050 <listitem><para><filename>telepathy-python, libtelepathy, telepathy-glib, telepathy-idle, telepathy-mission-control</filename>:
2051 All these recipes have moved to
2052 <filename>meta-oe</filename> and are consequently no
2053 longer needed by any recipes in OpenEmbedded-Core.
2054 </para></listitem>
2055 <listitem><para><filename>linux-yocto_3.10</filename> and <filename>linux-yocto_3.17</filename>:
2056 Support for the linux-yocto 3.10 and 3.17 kernels has been
2057 dropped.
2058 Support for the 3.14 kernel remains, while support for
2059 3.19 kernel has been added.
2060 </para></listitem>
2061 <listitem><para><filename>poky-feed-config-opkg</filename>:
2062 No longer needed.
2063 </para></listitem>
2064 <listitem><para><filename>libav 0.8.x</filename>:
2065 <filename>libav 9.x</filename> is now used.
2066 </para></listitem>
2067 <listitem><para><filename>sed-native</filename>:
2068 No longer needed.
2069 A working version of <filename>sed</filename> is expected
2070 to be provided by the host distribution.
2071 </para></listitem>
2072 </itemizedlist>
2073 </para>
2074 </section>
2075
2076 <section id='migration-1.8-bluez'>
2077 <title>BlueZ 4.x / 5.x Selection</title>
2078
2079 <para>
2080 Proper built-in support for selecting BlueZ 5.x in preference
2081 to the default of 4.x now exists.
2082 To use BlueZ 5.x, simply add "bluez5" to your
2083 <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>
2084 value.
2085 If you had previously added append files
2086 (<filename>*.bbappend</filename>) to make this selection, you can
2087 now remove them.
2088 </para>
2089
2090 <para>
2091 Additionally, a
2092 <link linkend='ref-classes-bluetooth'><filename>bluetooth</filename></link>
2093 class has been added to make selection of the appropriate bluetooth
2094 support within a recipe a little easier.
2095 If you wish to make use of this class in a recipe, add something
2096 such as the following:
2097 <literallayout class='monospaced'>
2098 inherit bluetooth
2099 PACKAGECONFIG ??= "${@bb.utils.contains('DISTRO_FEATURES', 'bluetooth', '${BLUEZ}', '', d)}
2100 PACKAGECONFIG[bluez4] = "--enable-bluetooth,--disable-bluetooth,bluez4"
2101 PACKAGECONFIG[bluez5] = "--enable-bluez5,--disable-bluez5,bluez5"
2102 </literallayout>
2103 </para>
2104 </section>
2105
2106 <section id='migration-1.8-ssl'>
2107 <title>SSL 3.0 is Now Disabled in OpenSSL</title>
2108
2109 <para>
2110 SSL 3.0 is now disabled when building OpenSSL.
2111 Disabling SSL 3.0 avoids any lingering instances of the POODLE
2112 vulnerability.
2113 If you feel you must re-enable SSL 3.0, then you can add an
2114 append file (<filename>*.bbappend</filename>) for the
2115 <filename>openssl</filename> recipe to remove "-no-ssl3"
2116 from
2117 <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link>.
2118 </para>
2119 </section>
2120
2121 <section id='migration-1.8-default-sysroot-poisoning'>
2122 <title>Default Sysroot Poisoning</title>
2123
2124 <para>
2125 <filename>gcc's</filename> default sysroot and include directories
2126 are now "poisoned".
2127 In other words, the sysroot and include directories are being
2128 redirected to a non-existent location in order to catch when
2129 host directories are being used due to the correct options not
2130 being passed.
2131 This poisoning applies both to the cross-compiler used within the
2132 build and to the cross-compiler produced in the SDK.
2133 </para>
2134
2135 <para>
2136 If this change causes something in the build to fail, it almost
2137 certainly means the various compiler flags and commands are not
2138 being passed correctly to the underlying piece of software.
2139 In such cases, you need to take corrective steps.
2140 </para>
2141 </section>
2142
2143 <section id='migration-1.8-rebuild-improvements'>
2144 <title>Rebuild Improvements</title>
2145
2146 <para>
2147 Changes have been made to the
2148 <link linkend='ref-classes-base'><filename>base</filename></link>,
2149 <link linkend='ref-classes-autotools'><filename>autotools</filename></link>,
2150 and
2151 <link linkend='ref-classes-cmake'><filename>cmake</filename></link>
2152 classes to clean out generated files when the
2153 <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>
2154 task needs to be re-executed.
2155 </para>
2156
2157 <para>
2158 One of the improvements is to attempt to run "make clean" during
2159 the <filename>do_configure</filename> task if a
2160 <filename>Makefile</filename> exists.
2161 Some software packages do not provide a working clean target
2162 within their make files.
2163 If you have such recipes, you need to set
2164 <link linkend='var-CLEANBROKEN'><filename>CLEANBROKEN</filename></link>
2165 to "1".
2166 <literallayout class='monospaced'>
2167 CLEANBROKEN = "1"
2168 </literallayout>
2169 </para>
2170 </section>
2171
2172 <section id='migration-1.8-qa-check-and-validation-changes'>
2173 <title>QA Check and Validation Changes</title>
2174
2175 <para>
2176 The following QA Check and Validation Changes have occurred:
2177 <itemizedlist>
2178 <listitem><para>
2179 Usage of
2180 <link linkend='var-PRINC'><filename>PRINC</filename></link>
2181 previously triggered a warning.
2182 It now triggers an error.
2183 You should remove any remaining usage of
2184 <filename>PRINC</filename> in any recipe or append file.
2185 </para></listitem>
2186 <listitem><para>
2187 An additional QA check has been added to detect usage of
2188 <filename>${D}</filename> in
2189 <link linkend='var-FILES'><filename>FILES</filename></link>
2190 values where
2191 <link linkend='var-D'><filename>D</filename></link> values
2192 should not be used at all.
2193 The same check ensures that <filename>$D</filename> is used
2194 in
2195 <filename>pkg_preinst/pkg_postinst/pkg_prerm/pkg_postrm</filename>
2196 functions.
2197 </para></listitem>
2198 <listitem><para>
2199 <link linkend='var-S'><filename>S</filename></link> now
2200 needs to be set to a valid value within a recipe.
2201 If <filename>S</filename> is not set in the recipe, the
2202 directory is not automatically created.
2203 If <filename>S</filename> does not point to a directory
2204 that exists at the time the
2205 <link linkend='ref-tasks-unpack'><filename>do_unpack</filename></link>
2206 task finishes, a warning will be shown.
2207 </para></listitem>
2208 <listitem><para>
2209 <link linkend='var-LICENSE'><filename>LICENSE</filename></link>
2210 is now validated for correct formatting of multiple
2211 licenses.
2212 If the format is invalid (e.g. multiple licenses are
2213 specified with no operators to specify how the multiple
2214 licenses interact), then a warning will be shown.
2215 </para></listitem>
2216 </itemizedlist>
2217 </para>
2218 </section>
2219
2220 <section id='migration-1.8-miscellaneous-changes'>
2221 <title>Miscellaneous Changes</title>
2222
2223 <para>
2224 The following miscellaneous changes have occurred:
2225 <itemizedlist>
2226 <listitem><para>
2227 The <filename>send-error-report</filename> script now
2228 expects a "-s" option to be specified before the server
2229 address.
2230 This assumes a server address is being specified.
2231 </para></listitem>
2232 <listitem><para>
2233 The <filename>oe-pkgdata-util</filename> script now
2234 expects a "-p" option to be specified before the
2235 <filename>pkgdata</filename> directory, which is now
2236 optional.
2237 If the <filename>pkgdata</filename> directory is not
2238 specified, the script will run BitBake to query
2239 <link linkend='var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></link>
2240 from the build environment.
2241 </para></listitem>
2242 </itemizedlist>
2243 </para>
2244 </section>
2245</section>
2246
2016</chapter> 2247</chapter>
2017<!-- 2248<!--
2018vim: expandtab tw=80 ts=4 2249vim: expandtab tw=80 ts=4