article.xml revision 274368
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]> 8 9<article xmlns="http://docbook.org/ns/docbook" 10 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> 11 12 <info> 13 <title>&os; &release.current; Errata </title> 14 15 <author><orgname>The &os; Project</orgname></author> 16 17 <pubdate>$FreeBSD: releng/10.1/release/doc/en_US.ISO8859-1/errata/article.xml 274368 2014-11-11 05:46:10Z gjb $</pubdate> 18 19 <copyright> 20 <year>2014</year> 21 22 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 23 Project</holder> 24 </copyright> 25 26 <legalnotice xml:id="trademarks" role="trademarks"> 27 &tm-attrib.freebsd; 28 &tm-attrib.intel; 29 &tm-attrib.sparc; 30 &tm-attrib.general; 31 </legalnotice> 32 33 <abstract> 34 <para>This document lists errata items for &os; &release.current;, 35 containing significant information discovered after the 36 release or too late in the release cycle to be otherwise 37 included in the release documentation. This information 38 includes security advisories, as well as news relating to the 39 software or documentation that could affect its operation or 40 usability. An up-to-date version of this document should 41 always be consulted before installing this version of 42 &os;.</para> 43 44 <para>This errata document for &os; &release.current; will be 45 maintained until the release of &os; &release.next;.</para> 46 </abstract> 47 </info> 48 49 <sect1 xml:id="intro"> 50 <title>Introduction</title> 51 52 <para>This errata document contains <quote>late-breaking 53 news</quote> about &os; &release.current; before installing this 54 version, it is important to consult this document to learn about 55 any post-release discoveries or problems that may already have 56 been found and fixed.</para> 57 58 <para>Any version of this errata document actually distributed 59 with the release (for example, on a CDROM distribution) will be 60 out of date by definition, but other copies are kept updated on 61 the Internet and should be consulted as the <quote>current 62 errata</quote> for this release. These other copies of the 63 errata are located at <link 64 xlink:href="http://www.FreeBSD.org/releases/" />, plus any 65 sites which keep up-to-date mirrors of this location.</para> 66 67 <para>Source and binary snapshots of &os; &release.branch; also 68 contain up-to-date copies of this document (as of the time of 69 the snapshot).</para> 70 71 <para>For a list of all &os; CERT security advisories, see <link 72 xlink:href="http://www.FreeBSD.org/security/"/> or <link 73 xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CERT/"/>.</para> 74 </sect1> 75 76 <sect1 xml:id="security"> 77 <title>Security Advisories</title> 78 79 <informaltable frame="none" pgwide="0"> 80 <tgroup cols="3"> 81 <colspec colwidth="1*" /> 82 <colspec colwidth="1*" /> 83 <colspec colwidth="3*" /> 84 <thead> 85 <row> 86 <entry>Advisory</entry> 87 <entry>Date</entry> 88 <entry>Topic</entry> 89 </row> 90 </thead> 91 92 <tbody> 93 <row> 94 <entry>No advisories.</entry> 95 <entry> </entry> 96 <entry> </entry> 97 </row> 98 </tbody> 99 </tgroup> 100 </informaltable> 101 </sect1> 102 103 <sect1 xml:id="open-issues"> 104 <title>Open Issues</title> 105 106 <itemizedlist> 107 <listitem> 108 <para>&os;/&arch.i386; &release.current; running as a guest 109 operating system on <application>VirtualBox</application> 110 can have a problem with disk I/O access. It depends on some 111 specific hardware configuration and does not depend on a 112 specific version of <application>VirtualBox</application> or 113 host operating system.</para> 114 115 <para>It causes various errors and makes &os; quite unstable. 116 Although the cause is still unclear, disabling unmapped I/O 117 works as a workaround. To disable it, choose 118 <literal>Escape to loader prompt</literal> in the boot menu 119 and enter the following lines from &man.loader.8; prompt, 120 after an <literal>OK</literal>:</para> 121 122 <screen>set vfs.unmapped_buf_allowed=0 123boot</screen> 124 125 <para>Note that the following line has to be added to 126 <filename>/boot/loader.conf</filename> after a boot. It 127 disables unmapped I/O at every boot:</para> 128 129 <programlisting>vfs.unmapped_buf_allowed=0</programlisting> 130 131 <para>[2014-04-03 update] It has been reported that 132 instability may be present on virtual machines running 133 on other hypervisors, such as Xen or KVM.</para> 134 </listitem> 135 136 <listitem> 137 <para>&os;/&arch.i386; &release.current; configured with 138 a multi-disk ZFS dataset (mirror, raidz1, raidz2, raidz3) 139 may crash during boot when the ZFS pool mount is attempted 140 while booting an unmodified <literal>GENERIC</literal> 141 kernel.</para> 142 143 <para>As described in <filename>/usr/src/UPDATING</filename> 144 entry <literal>20121223</literal>, rebuilding the kernel 145 with <literal>options KSTACK_PAGES=4</literal> has been 146 observed to resolve the boot-time crash. This, however, is 147 not an ideal solution for inclusion in the 148 <literal>GENERIC</literal> kernel configuration, as 149 increasing <literal>KSTACK_PAGES</literal> implicitly 150 decreases available usermode threads in an environment that 151 is already resource-starved.</para> 152 153 <para>Taking into account the heavy resource requirements of 154 ZFS, in addition to the &arch.i386;-specific tuning 155 requirements for general workloads, using ZFS with the 156 &os;/&arch.i386; <literal>GENERIC</literal> kernel 157 is strongly discouraged.</para> 158 159 <warning> 160 <para>It is extremely important to take note that, by 161 default, &man.freebsd-update.8; will install the 162 <literal>GENERIC</literal> kernel configuration, and 163 as such, &man.freebsd-update.8; consumers are strongly 164 encouraged to avoid &os;-provided kernel binary upgrades 165 with such configurations.</para> 166 </warning> 167 168 <note> 169 <para>Although there is slight change in how the crash 170 manifests on &os;/&arch.i386; between &release.prev; and 171 &release.current;, and given the date of the 172 <filename>/usr/src/UPDATING</filename> entry, there is no 173 evidence suggesting this is a regression between 174 &os; &release.prev; and &os; &release.current; 175 directly.</para> 176 </note> 177 </listitem> 178 179 <listitem> 180 <para>Due to an incompatibility between &man.bsdconfig.8; 181 and &man.pkg.8; version 1.3, packages included on the 182 &os; dvd installer will not be recognized by 183 &man.bsdconfig.8;.</para> 184 185 <para>To install packages from the <literal>dvd1.iso</literal> 186 installer, create the <filename 187 class="directory">/dist</filename> target directory, and 188 manually mount the <literal>dvd1.iso</literal> 189 <acronym>ISO</acronym>:</para> 190 191 <screen>&prompt.root; mkdir -p /dist 192&prompt.root; mount -t cd9660 /dev/<replaceable>cd0</replaceable> /dist</screen> 193 194 <note> 195 <para>Be sure to use the correct <filename 196 class="directory">/dev</filename> device path for the 197 <literal>dvd1.iso</literal> <acronym>ISO</acronym> 198 installer.</para> 199 </note> 200 201 <para>Next, set <envar>REPOS_DIR</envar> to the path of the 202 <filename class="directory">repos/</filename> directory 203 within the installer so &man.pkg.8; will use the correct 204 repository metadata.</para> 205 206 <para>If using &man.sh.1;:</para> 207 208 <screen>&prompt.root; export REPOS_DIR=/dist/packages/repos</screen> 209 210 <para>If using &man.csh.1;:</para> 211 212 <screen>&prompt.root; setenv REPOS_DIR /dist/packages/repos</screen> 213 214 <note> 215 <para>Keep in mind that <envar>REPOS_DIR</envar> will need 216 to be set again after the current shell session is 217 terminated, if continuing to use the packages provided on 218 the <literal>dvd1.iso</literal> installer.</para> 219 </note> 220 221 <para>Finally, bootstrap &man.pkg.8; from the 222 <acronym>ISO</acronym>, and install required 223 packages:</para> 224 225 <screen>&prompt.root; pkg bootstrap 226&prompt.root; pkg install <replaceable>xorg-server</replaceable> <replaceable>xorg</replaceable> <replaceable>gnome2</replaceable> [...]</screen> 227 </listitem> 228 </itemizedlist> 229 </sect1> 230 231 <sect1 xml:id="late-news"> 232 <title>Late-Breaking News</title> 233 234 <para>No news.</para> 235 </sect1> 236</article> 237