article.xml revision 319347
1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3 "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [ 4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" 5 "http://www.FreeBSD.org/release/XML/release.ent"> 6%release; 7<!ENTITY security PUBLIC "-//FreeBSD//ENTITIES Security Advisory List//EN" 8 "http://www.FreeBSD.org/release/XML/share/xml/security.xml"> 9<!ENTITY errata PUBLIC "-//FreeBSD//ENTITIES Errata List//EN" 10 "http://www.FreeBSD.org/release/XML/share/xml/errata.xml"> 11]> 12 13<article xmlns="http://docbook.org/ns/docbook" 14 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> 15 16 <info> 17 <title>&os; &release.prev; Errata</title> 18 19 <author><orgname>The &os; Project</orgname></author> 20 21 <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/errata/article.xml 319347 2017-05-31 17:42:06Z gjb $</pubdate> 22 23 <copyright> 24 <year>2016</year> 25 26 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 27 Project</holder> 28 </copyright> 29 30 <legalnotice xml:id="trademarks" role="trademarks"> 31 &tm-attrib.freebsd; 32 &tm-attrib.intel; 33 &tm-attrib.sparc; 34 &tm-attrib.general; 35 </legalnotice> 36 37 <abstract> 38 <para>This document lists errata items for &os; &release.prev;, 39 containing significant information discovered after the 40 release or too late in the release cycle to be otherwise 41 included in the release documentation. This information 42 includes security advisories, as well as news relating to the 43 software or documentation that could affect its operation or 44 usability. An up-to-date version of this document should 45 always be consulted before installing this version of 46 &os;.</para> 47 48 <para>This errata document for &os; &release.prev; will be 49 maintained until the release of &os; &release.next;.</para> 50 </abstract> 51 </info> 52 53 <sect1 xml:id="intro"> 54 <title>Introduction</title> 55 56 <para>This errata document contains <quote>late-breaking 57 news</quote> about &os; &release.prev; Before installing this 58 version, it is important to consult this document to learn about 59 any post-release discoveries or problems that may already have 60 been found and fixed.</para> 61 62 <para>Any version of this errata document actually distributed 63 with the release (for example, on a CDROM distribution) will be 64 out of date by definition, but other copies are kept updated on 65 the Internet and should be consulted as the <quote>current 66 errata</quote> for this release. These other copies of the 67 errata are located at <link 68 xlink:href="https://www.FreeBSD.org/releases/" />, plus any 69 sites which keep up-to-date mirrors of this location.</para> 70 71 <para>Source and binary snapshots of &os; &release.branch; also 72 contain up-to-date copies of this document (as of the time of 73 the snapshot).</para> 74 75 <para>For a list of all &os; CERT security advisories, see <link 76 xlink:href="https://www.FreeBSD.org/security/"/>.</para> 77 </sect1> 78 79 <sect1 xml:id="security"> 80 <title>Security Advisories</title> 81 82 &security; 83 </sect1> 84 85 <sect1 xml:id="errata"> 86 <title>Errata Notices</title> 87 88 &errata; 89 </sect1> 90 91 <sect1 xml:id="open-issues"> 92 <title>Open Issues</title> 93 94 <itemizedlist> 95 <listitem> 96 <para>&os;/&arch.i386; &release.prev; running as a guest 97 operating system on <application>VirtualBox</application> 98 can have a problem with disk I/O access. It depends on some 99 specific hardware configuration and does not depend on a 100 specific version of <application>VirtualBox</application> or 101 host operating system.</para> 102 103 <para>It has been reported that instability may be present on 104 virtual machines running on other hypervisors, such as Xen 105 or KVM.</para> 106 107 <para>It causes various errors and makes &os; quite unstable. 108 Although the cause is still unclear, disabling unmapped I/O 109 works as a workaround. To disable it, choose 110 <literal>Escape to loader prompt</literal> in the boot menu 111 and enter the following lines from &man.loader.8; prompt, 112 after an <literal>OK</literal>:</para> 113 114 <screen>set vfs.unmapped_buf_allowed=0 115boot</screen> 116 117 <para>Note that the following line has to be added to 118 <filename>/boot/loader.conf</filename> after a boot. It 119 disables unmapped I/O at every boot:</para> 120 121 <programlisting>vfs.unmapped_buf_allowed=0</programlisting> 122 </listitem> 123 124 <listitem> 125 <para>&os;/&arch.i386; &release.prev; installed on ZFS 126 may crash during boot when the ZFS pool mount is attempted 127 while booting an unmodified <literal>GENERIC</literal> 128 kernel.</para> 129 130 <para>As described in <filename>/usr/src/UPDATING</filename> 131 entry <literal>20121223</literal>, rebuilding the kernel 132 with <literal>options KSTACK_PAGES=4</literal> has been 133 observed to resolve the boot-time crash. This, however, is 134 not an ideal solution for inclusion in the 135 <literal>GENERIC</literal> kernel configuration, as 136 increasing <literal>KSTACK_PAGES</literal> implicitly 137 decreases available usermode threads in an environment that 138 is already resource-starved.</para> 139 140 <para>Taking into account the heavy resource requirements of 141 ZFS, in addition to the &arch.i386;-specific tuning 142 requirements for general workloads, using ZFS with the 143 &os;/&arch.i386; <literal>GENERIC</literal> kernel 144 is strongly discouraged.</para> 145 146 <para>If installing &os;/&arch.i386; on ZFS, it is possible to 147 configure the system after installation to increase the 148 <literal>KSTACK_PAGES</literal>.</para> 149 150 <para>When prompted by &man.bsdinstall.8; to perform 151 additional post-installation configuration to the system, 152 select <guibutton>[ YES ]</guibutton>.</para> 153 154 <para>This procedure requires the system sources available 155 locally. If the <literal>System source code</literal> 156 distribution was not selected during installation, it can 157 be obtained using <application>svnlite</application>:</para> 158 159 <screen>&prompt.root; mkdir -p /usr/src 160&prompt.root; svnlite co svn://svn.freebsd.org/base/releng/10.2 /usr/src</screen> 161 162 <para>Build the <literal>kernel-toolchain</literal> required 163 to rebuild the kernel:</para> 164 165 <screen>&prompt.root; make -C /usr/src kernel-toolchain</screen> 166 167 <para>Next, create a kernel configuration file to increase the 168 <literal>KSTACK_PAGES</literal> option:</para> 169 170 <screen>&prompt.root; printf "include GENERIC\noptions KSTACK_PAGES=4\n" > <filename>/usr/src/sys/i386/conf/<replaceable>ZFS</replaceable></filename></screen> 171 172 <para>Then build and install the 173 <replaceable>ZFS</replaceable> kernel:</para> 174 175 <screen>&prompt.root; make -C /usr/src buildkernel KERNCONF=<replaceable>ZFS</replaceable> 176&prompt.root; make -C /usr/src installkernel KERNCONF=<replaceable>ZFS</replaceable></screen> 177 178 <warning> 179 <para>It is extremely important to take note that, by 180 default, &man.freebsd-update.8; will install the 181 <literal>GENERIC</literal> kernel configuration, and 182 as such, &man.freebsd-update.8; consumers are strongly 183 encouraged to avoid &os;-provided kernel binary upgrades 184 with such configurations.</para> 185 </warning> 186 </listitem> 187 188 <listitem> 189 <para>Due to an incompatibility between &man.bsdconfig.8; 190 and &man.pkg.8;, packages included on the &os; dvd 191 installer will not be recognized by 192 &man.bsdconfig.8;.</para> 193 194 <para>To install packages from the <literal>dvd1.iso</literal> 195 installer, create the <filename 196 class="directory">/dist</filename> target directory, and 197 manually mount the <literal>dvd1.iso</literal> 198 <acronym>ISO</acronym>:</para> 199 200 <screen>&prompt.root; mkdir -p /dist 201&prompt.root; mount -t cd9660 /dev/<replaceable>cd0</replaceable> /dist</screen> 202 203 <note> 204 <para>Be sure to use the correct <filename 205 class="directory">/dev</filename> device path for the 206 <literal>dvd1.iso</literal> <acronym>ISO</acronym> 207 installer.</para> 208 </note> 209 210 <para>Next, set <envar>REPOS_DIR</envar> to the path of the 211 <filename class="directory">repos/</filename> directory 212 within the installer so &man.pkg.8; will use the correct 213 repository metadata.</para> 214 215 <para>If using &man.sh.1;:</para> 216 217 <screen>&prompt.root; export REPOS_DIR=/dist/packages/repos</screen> 218 219 <para>If using &man.csh.1;:</para> 220 221 <screen>&prompt.root; setenv REPOS_DIR /dist/packages/repos</screen> 222 223 <note> 224 <para>Keep in mind that <envar>REPOS_DIR</envar> will need 225 to be set again after the current shell session is 226 terminated, if continuing to use the packages provided on 227 the <literal>dvd1.iso</literal> installer.</para> 228 </note> 229 230 <para>Finally, bootstrap &man.pkg.8; from the 231 <acronym>ISO</acronym>, and install required 232 packages:</para> 233 234 <screen>&prompt.root; pkg bootstrap 235&prompt.root; pkg install <replaceable>xorg-server</replaceable> <replaceable>xorg</replaceable> <replaceable>gnome3</replaceable> [...]</screen> 236 </listitem> 237 238 <listitem> 239 <para>An issue was discovered where the &man.netstat.1; 240 <literal>-s</literal> option will cause a segmentation fault 241 on systems with <literal>IPSEC</literal> compiled into the 242 kernel. The issue was resolved in the 243 <literal>stable/10</literal> branch, and an Errata Notice is 244 planned after &release.prev; is released.</para> 245 246 <para>[2015-08-19] Resolved as FreeBSD-EN-15:12.</para> 247 </listitem> 248 249 <listitem> 250 <para>An issue was discovered that causes &man.make.1; to 251 generate noisy output when doing source-based upgrades from 252 &os; 9.3 and earlier. The issue was reported in PR 202277, 253 and after investigation and determining the issue does not 254 cause source-based upgrades to fail, a post-release Errata 255 Notice is planned.</para> 256 257 <para>[2015-08-19] Resolved as FreeBSD-EN-15:11.</para> 258 </listitem> 259 260 <listitem> 261 <para>An issue with &os; virtual machines with 262 <application>vagrant</application> was discovered that 263 affects the <application>VirtualBox</application> where the 264 virtual machine will not start on the initial boot invoked 265 with <literal>vagrant up</literal>.</para> 266 267 <para>The issue is due to the virtual machine 268 <acronym>MAC</acronym> being unset, as &os; does not provide 269 a default <filename>Vagrantfile</filename>.</para> 270 271 <para>It has been observed, however, that a subsequent 272 invocation of <literal>vagrant up</literal> will allow the 273 virtual machine to successfully boot, allowing access via 274 <literal>vagrant ssh</literal>.</para> 275 </listitem> 276 277 <listitem> 278 <para>[2015-08-16] An error was discovered in the release 279 notes for &os; &release.prev; regarding the 280 <literal>drm</literal> device driver. The entry for r282199 281 states the driver was updated to match the version &linux; 282 3.8.13 version, however the entry should have noted the 283 change affects device-independent code, and does not bring 284 the <literal>drm</literal> driver fully in line with the 285 stated &linux; version.</para> 286 </listitem> 287 </itemizedlist> 288 </sect1> 289 290 <sect1 xml:id="late-news"> 291 <title>Late-Breaking News</title> 292 293 <para>No news.</para> 294 </sect1> 295</article> 296