release/doc/en_US.ISO8859-1/errata/article.xml

   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 % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
   8 %sponsor;
   9 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
  10 %vendor;
  11 <!ENTITY security SYSTEM "../../share/xml/security.xml">
  12 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
  13 ]>
  14
  15 <article xmlns="http://docbook.org/ns/docbook"
  16         xmlns:xlink="http://www.w3.org/1999/xlink"
  17         version="5.0">
  18   <info>
  19     <title>&os; &release; Errata</title>
  20
  21     <author><orgname>The &os; Project</orgname></author>
  22
  23     <pubdate>$FreeBSD$</pubdate>
  24
  25     <copyright>
  26       <year>2017</year>
  27
  28       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  29         Project</holder>
  30     </copyright>
  31
  32     <legalnotice xml:id="trademarks" role="trademarks">
  33       &tm-attrib.freebsd;
  34       &tm-attrib.intel;
  35       &tm-attrib.sparc;
  36       &tm-attrib.general;
  37     </legalnotice>
  38
  39     <abstract>
  40       <para>This document lists errata items for &os; &release;,
  41         containing significant information discovered after the
  42         release or too late in the release cycle to be otherwise
  43         included in the release documentation.  This information
  44         includes security advisories, as well as news relating to the
  45         software or documentation that could affect its operation or
  46         usability.  An up-to-date version of this document should
  47         always be consulted before installing this version of
  48         &os;.</para>
  49
  50       <para>This errata document for &os; &release; will be maintained
  51         until the release of &os; &release.next;.</para>
  52     </abstract>
  53   </info>
  54
  55   <sect1 xml:id="intro">
  56     <title>Introduction</title>
  57
  58     <para>This errata document contains <quote>late-breaking
  59         news</quote> about &os; &release; Before installing this
  60       version, it is important to consult this document to learn about
  61       any post-release discoveries or problems that may already have
  62       been found and fixed.</para>
  63
  64     <para>Any version of this errata document actually distributed
  65       with the release (for example, on a CDROM distribution) will be
  66       out of date by definition, but other copies are kept updated on
  67       the Internet and should be consulted as the <quote>current
  68         errata</quote> for this release.  These other copies of the
  69       errata are located at <link
  70         xlink:href="https://www.FreeBSD.org/releases/" />, plus any
  71       sites which keep up-to-date mirrors of this location.</para>
  72
  73     <para>Source and binary snapshots of &os; &release.branch; also
  74       contain up-to-date copies of this document (as of the time of
  75       the snapshot).</para>
  76
  77     <para>For a list of all &os; CERT security advisories, see <link
  78         xlink:href="https://www.FreeBSD.org/security/"/>.</para>
  79   </sect1>
  80
  81   <sect1 xml:id="security">
  82     <title>Security Advisories</title>
  83
  84     &security;
  85   </sect1>
  86
  87   <sect1 xml:id="errata">
  88     <title>Errata Notices</title>
  89
  90     &errata;
  91   </sect1>
  92
  93   <sect1 xml:id="open-issues">
  94     <title>Open Issues</title>
  95
  96     <itemizedlist>
  97       <listitem>
  98         <para>&os;/&arch.i386; installed on ZFS may crash during boot
  99           when the ZFS pool mount is attempted while booting an
 100           unmodified <literal>GENERIC</literal> kernel.</para>
 101
 102         <para>A system tunable has been added as of revision
 103           <literal>r286584</literal> to make the
 104           <literal>kern.kstack_pages</literal> tunable configurable
 105           without recompiling the kernel.</para>
 106
 107         <para>To mitigate system crashes with such configurations,
 108           chose <literal>Escape to loader prompt</literal> in the boot
 109           menu and enter the following lines from &man.loader.8;
 110           prompt, after an <literal>OK</literal>:</para>
 111
 112         <screen>set kern.kstack_pages=4
 113 boot</screen>
 114
 115         <para>Add this line to
 116           <filename>/boot/loader.conf</filename> for the change to
 117           persist across reboots:</para>
 118
 119         <programlisting>kern.kstack_pages=4</programlisting>
 120       </listitem>
 121
 122       <listitem>
 123         <para>The size of the <acronym>GPT</acronym> enabled
 124           <acronym>ZFS</acronym> boot blocks
 125           (<filename>/boot/gptzfsboot</filename>) has increased past
 126           82K.  Systems upgraded from older releases may experience
 127           a problem where the size of the existing
 128           &quot;freebsd-boot&quot; partition is too small to hold the
 129           new <filename>gptzfsboot</filename>.</para>
 130
 131         <para>Systems where the boot partition is immediately followed
 132           by the swap partition, such as those installed via
 133           &man.bsdinstall.8;, can resize the swap partition slightly
 134           using the &man.gpart.8; <literal>resize</literal> command,
 135           so space can be reclaimed to increase the size of the
 136           freebsd-boot partition.</para>
 137       </listitem>
 138
 139       <listitem>
 140         <para>Due to a bug in earlier versions of &man.clang.1; that
 141           is difficult to work around in the upgrade process, to
 142           upgrade the system from sources via buildworld to -CURRENT
 143           or &release;, it is necessary to upgrade machines running
 144           10.x to revision r286033.  Source-based upgrades from
 145           10.3-RELEASE are not affected.  This differs from the
 146           historical situation where one could generally upgrade from
 147           anywhere on earlier stable branches, so caution should be
 148           exercised.</para>
 149       </listitem>
 150     </itemizedlist>
 151   </sect1>
 152
 153   <sect1 xml:id="late-news">
 154     <title>Late-Breaking News</title>
 155
 156     <para>No news.</para>
 157   </sect1>
 158 </article>