summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/migration.xml
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-11-09 20:32:26 (GMT)
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-11-22 12:20:52 (GMT)
commit506bbde78309b90d52b64d1d6e7e265e1bae73ea (patch)
tree9a977125ace7d76c4791c6716f993960327c96a7 /documentation/ref-manual/migration.xml
parent2103d41b2e65240605bfb1b457e54f2540ac281f (diff)
downloadpoky-506bbde78309b90d52b64d1d6e7e265e1bae73ea.tar.gz
ref-manual: Updates to the 2.6 migration section.
This is the completed first draft. (From yocto-docs rev: 45d39b7655ea5b515c8dda91249a84ee19387099) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r--documentation/ref-manual/migration.xml244
1 files changed, 235 insertions, 9 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 9b67115..8082a54 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -5969,6 +5969,136 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5969 </para> 5969 </para>
5970 </section> 5970 </section>
5971 5971
5972 <section id='migration-2.6-serial-console-deprecated'>
5973 <title><filename>SERIAL_CONSOLE</filename> Deprecated</title>
5974
5975 <para>
5976 The
5977 <link linkend='var-SERIAL_CONSOLE'><filename>SERIAL_CONSOLE</filename></link>
5978 variable has been functionally replaced by the
5979 <link linkend='var-SERIAL_CONSOLES'><filename>SERIAL_CONSOLES</filename></link>
5980 variable for some time.
5981 With the Yocto Project 2.6 release,
5982 <filename>SERIAL_CONSOLE</filename> has been officially deprecated.
5983 </para>
5984
5985 <para>
5986 <filename>SERIAL_CONSOLE</filename> will continue to work as
5987 before for the 2.6 release.
5988 However, for the sake of future compatibility, it is recommended
5989 that you replace all instances of
5990 <filename>SERIAL_CONSOLE</filename> with
5991 <filename>SERIAL_CONSOLES</filename>.
5992 <note>
5993 The only difference in usage is that
5994 <filename>SERIAL_CONSOLES</filename> expects entries to be
5995 separated using semicolons as compared to
5996 <filename>SERIAL_CONSOLE</filename>, which expects spaces.
5997 </note>
5998 </para>
5999 </section>
6000
6001 <section id='migration-2.6-poky-sets-unknown-configure-option-to-qa-error'>
6002 <title>Configure Script Reports Unknown Options as Errors</title>
6003
6004 <para>
6005 If the configure script reports an unknown option, this now
6006 triggers a QA error instead of a warning.
6007 Any recipes that previously got away with specifying such unknown
6008 options now need to be fixed.
6009 </para>
6010 </section>
6011
6012 <section id='migration-2.6-override-changes'>
6013 <title>Override Changes</title>
6014
6015 <para>
6016 The following changes have occurred:
6017 <itemizedlist>
6018 <listitem><para>
6019 <emphasis>The <filename>virtclass-native</filename> and
6020 <filename>virtclass-nativesdk</filename> Overrides Have
6021 Been Removed:</emphasis>
6022 The <filename>virtclass-native</filename> and
6023 <filename>virtclass-nativesdk</filename> overrides have
6024 been deprecated since 2012 in favor of
6025 <filename>class-native</filename> and
6026 <filename>class-nativesdk</filename>, respectively.
6027 Both <filename>virtclass-native</filename> and
6028 <filename>virtclass-nativesdk</filename> are now dropped.
6029 <note>
6030 The <filename>virtclass-multilib-</filename> overrides
6031 for multilib are still valid.
6032 </note>
6033 </para></listitem>
6034 <listitem><para>
6035 <emphasis>The <filename>forcevariable</filename>
6036 Override Now Has a Higher Priority Than
6037 <filename>libc</filename> Overrides:</emphasis>
6038 The <filename>forcevariable</filename> override is
6039 documented to be the highest priority override.
6040 However, due to a long-standing quirk of how
6041 <link linkend='var-OVERRIDES'><filename>OVERRIDES</filename></link>
6042 is set, the <filename>libc</filename> overrides (e.g.
6043 <filename>libc-glibc</filename>,
6044 <filename>libc-musl</filename>, and so forth) erroneously
6045 had a higher priority.
6046 This issue is now corrected.</para>
6047
6048 <para>It is likely this change will not cause any
6049 problems.
6050 However, it is possible with some unusual configurations
6051 that you might see a change in behavior if you were
6052 relying on the previous behavior.
6053 Be sure to check how you use
6054 <filename>forcevariable</filename> and
6055 <filename>libc-*</filename> overrides in your custom
6056 layers and configuration files to ensure they make sense.
6057 </para></listitem>
6058 <listitem><para>
6059 <emphasis>The <filename>build-${BUILD_OS}</filename>
6060 Override Has Been Removed:</emphasis>
6061 The <filename>build-${BUILD_OS}</filename>, which is
6062 typically <filename>build-linux</filename>, override has
6063 been removed because building on a host operating system
6064 other than a recent version of Linux is neither supported
6065 nor recommended.
6066 Dropping the override avoids giving the impression that
6067 other host operating systems might be supported.
6068 </para></listitem>
6069 </itemizedlist>
6070 </para>
6071 </section>
6072
6073 <section id='migration-2.6-systemd-configuration-now-split-out-to-system-conf'>
6074 <title><filename>systemd</filename> Configuration is Now Split Into <filename>systemd-conf</filename></title>
6075
6076 <para>
6077 The configuration for the <filename>systemd</filename> recipe
6078 has been moved into a <filename>system-conf</filename> recipe.
6079 Moving this configuration to a separate recipe avoids the
6080 <filename>systemd</filename> recipe from becoming machine-specific
6081 for cases where machine-specific configurations need to be applied
6082 (e.g. for <filename>qemu*</filename> machines).
6083 </para>
6084
6085 <para>
6086 Currently, the new recipe packages the following files:
6087 <literallayout class='monospaced'>
6088 ${sysconfdir}/machine-id
6089 ${sysconfdir}/systemd/coredump.conf
6090 ${sysconfdir}/systemd/journald.conf
6091 ${sysconfdir}/systemd/logind.conf
6092 ${sysconfdir}/systemd/system.conf
6093 ${sysconfdir}/systemd/user.conf
6094 </literallayout>
6095 If you previously used BitBake append files to append the
6096 <filename>systemd</filename> recipe to change any of the
6097 listed files, you must do so for the
6098 <filename>systemd-conf</filename> recipe instead.
6099 </para>
6100 </section>
6101
5972 <section id='migration-2.6-automatic-testing-changes'> 6102 <section id='migration-2.6-automatic-testing-changes'>
5973 <title>Automatic Testing Changes</title> 6103 <title>Automatic Testing Changes</title>
5974 6104
@@ -6023,16 +6153,26 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
6023 <title>BitBake Changes</title> 6153 <title>BitBake Changes</title>
6024 6154
6025 <para> 6155 <para>
6026 The "_remove" operator now preserves whitespace. 6156 The following BitBake changes occurred:
6027 Consequently, when specifying list items to remove, be aware 6157 <itemizedlist>
6028 that leading and trailing whitespace resulting from the 6158 <listitem><para>
6029 removal is retained. 6159 The "_remove" operator now preserves whitespace.
6030 </para> 6160 Consequently, when specifying list items to remove, be
6161 aware that leading and trailing whitespace resulting from
6162 the removal is retained.</para>
6031 6163
6032 <para> 6164 <para>See the
6033 See the 6165 "<ulink url='&YOCTO_DOCS_BB_URL;#removing-override-style-syntax'>Removal (Override Style Syntax)</ulink>"
6034 "<ulink url='&YOCTO_DOCS_BB_URL;#removing-override-style-syntax'>Removal (Override Style Syntax)</ulink>" 6166 section in the BitBake User Manual for a detailed example.
6035 section in the BitBake User Manual for a detailed example. 6167 </para></listitem>
6168 <listitem><para>
6169 The server logfile
6170 <filename>bitbake-cookerdaemon.log</filename> is now always
6171 placed in the
6172 <link linkend='build-directory'>Build Directory</link>
6173 instead of the current directory.
6174 </para></listitem>
6175 </itemizedlist>
6036 </para> 6176 </para>
6037 </section> 6177 </section>
6038 6178
@@ -6056,6 +6196,92 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
6056 errors. 6196 errors.
6057 </para> 6197 </para>
6058 </section> 6198 </section>
6199
6200 <section id='migration-2.6-miscellaneous-changes'>
6201 <title>Miscellaneous Changes</title>
6202
6203 <para>
6204 The following miscellaneous changes occurred:
6205 <itemizedlist>
6206 <listitem><para>
6207 Default to using the Thumb-2 instruction set for armv7a
6208 and above.
6209 If you have any custom recipes that build software that
6210 needs to be built with the ARM instruction set, change the
6211 recipe to set the instruction set as follows:
6212 <literallayout class='monospaced'>
6213 ARM_INSTRUCTION_SET = "arm"
6214 </literallayout>
6215 </para></listitem>
6216 <listitem><para>
6217 <filename>run-postinsts</filename> no longer uses
6218 <filename>/etc/*-postinsts</filename> for
6219 <filename>dpkg/opkg</filename> in favor of built-in
6220 postinst support.
6221 <note>
6222 RPM behavior remains unchanged.
6223 </note>
6224 </para></listitem>
6225 <listitem><para>
6226 The <filename>NOISO</filename> and
6227 <filename>NOHDD</filename> variables are no longer used.
6228 You now control building <filename>*.iso</filename> and
6229 <filename>*.hddimg</filename> image types directly
6230 by using the
6231 <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link>
6232 variable.
6233 </para></listitem>
6234 <listitem><para>
6235 The <filename>scripts/contrib/mkefidisk.sh</filename>
6236 has been removed in favor of Wic.
6237 </para></listitem>
6238 <listitem><para>
6239 <filename>kernel-modules</filename> has been removed from
6240 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>
6241 for <filename>qemumips</filename> and
6242 <filename>qemumips64</filename> machines.
6243 Removal also impacts the <filename>x86-base.inc</filename>
6244 file.
6245 <note>
6246 <filename>genericx86</filename> and
6247 <filename>genericx86-64</filename> retain
6248 <filename>kernel-modules</filename> as part of the
6249 <filename>RRECOMMENDS</filename> variable setting.
6250 </note>
6251 </para></listitem>
6252 <listitem><para>
6253 The <filename>LGPLv2_WHITELIST_GPL-3.0</filename>
6254 variable has been removed.
6255 If you are setting this variable in your configuration,
6256 set or append it to the
6257 <filename>WHITELIST_GPL-3.0</filename> variable instead.
6258 </para></listitem>
6259 <listitem><para>
6260 <filename>${ASNEEDED}</filename> is now included in
6261 the
6262 <link linkend='var-TARGET_LDFLAGS'><filename>TARGET_LDFLAGS</filename></link>
6263 variable directly.
6264 The remaining definitions from
6265 <filename>meta/conf/distro/include/as-needed.inc</filename>
6266 have been moved to corresponding recipes.
6267 </para></listitem>
6268 <listitem><para>
6269 Support for DSA host keys has been dropped from the
6270 OpenSSH recipes.
6271 If you are still using DSA keys, you must switch over to a
6272 more secure algorithm as recommended by the OpenSSH
6273 upstream.
6274 </para></listitem>
6275 <listitem><para>
6276 The <filename>dhcp</filename> recipe now uses the
6277 <filename>dhcpd6.conf</filename> configuration file in
6278 <filename>dhcpd6.service</filename> for IPv6 DHCP rather
6279 than re-using <filename>dhcpd.conf</filename>, which is
6280 now reserved for IPv4.
6281 </para></listitem>
6282 </itemizedlist>
6283 </para>
6284 </section>
6059</section> 6285</section>
6060</chapter> 6286</chapter>
6061<!-- 6287<!--