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         xml:id="top"
  18         version="5.0">
  19   <info>
  20     <title>&os; &release; Errata</title>
  21
  22     <author><orgname>The &os; Project</orgname></author>
  23
  24     <pubdate>$FreeBSD$</pubdate>
  25
  26     <copyright>
  27       <year>2018</year>
  28
  29       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  30         Project</holder>
  31     </copyright>
  32
  33     <legalnotice xml:id="trademarks" role="trademarks">
  34       &tm-attrib.freebsd;
  35       &tm-attrib.intel;
  36       &tm-attrib.sparc;
  37       &tm-attrib.general;
  38     </legalnotice>
  39
  40     <abstract>
  41       <para>This document lists errata items for &os; &release;,
  42         containing significant information discovered after the
  43         release or too late in the release cycle to be otherwise
  44         included in the release documentation.  This information
  45         includes security advisories, as well as news relating to the
  46         software or documentation that could affect its operation or
  47         usability.  An up-to-date version of this document should
  48         always be consulted before installing this version of
  49         &os;.</para>
  50
  51       <para>This errata document for &os; &release; will be maintained
  52         until the release of &os; &release.next;.</para>
  53     </abstract>
  54   </info>
  55
  56   <sect1 xml:id="intro">
  57     <title>Introduction</title>
  58
  59     <para>This errata document contains <quote>late-breaking
  60         news</quote> about &os; &release;.  Before installing this
  61       version, it is important to consult this document to learn about
  62       any post-release discoveries or problems that may already have
  63       been found and fixed.</para>
  64
  65     <para>Any version of this errata document actually distributed
  66       with the release (for example, on a CDROM distribution) will be
  67       out of date by definition, but other copies are kept updated on
  68       the Internet and should be consulted as the <quote>current
  69         errata</quote> for this release.  These other copies of the
  70       errata are located at <link
  71         xlink:href="https://www.FreeBSD.org/releases/" />, plus any
  72       sites which keep up-to-date mirrors of this location.</para>
  73
  74     <para>Source and binary snapshots of &os; &release.branch; also
  75       contain up-to-date copies of this document (as of the time of
  76       the snapshot).</para>
  77
  78     <para>For a list of all &os; CERT security advisories, see <link
  79         xlink:href="https://www.FreeBSD.org/security/"/>.</para>
  80   </sect1>
  81
  82   <sect1 xml:id="security">
  83     <title>Security Advisories</title>
  84
  85     &security;
  86   </sect1>
  87
  88   <sect1 xml:id="errata">
  89     <title>Errata Notices</title>
  90
  91     &errata;
  92   </sect1>
  93
  94   <sect1 xml:id="open-issues">
  95     <title>Open Issues</title>
  96
  97     <itemizedlist>
  98       <listitem>
  99         <para>&os;/&arch.i386; installed on ZFS may crash during boot
 100           when the ZFS pool mount is attempted while booting an
 101           unmodified <literal>GENERIC</literal> kernel.</para>
 102
 103         <para>A system tunable has been added as of revision
 104           <literal>r286584</literal> to make the
 105           <literal>kern.kstack_pages</literal> tunable configurable
 106           without recompiling the kernel.</para>
 107
 108         <para>To mitigate system crashes with such configurations,
 109           choose <literal>Escape to loader prompt</literal> in the
 110           boot menu and enter the following lines from &man.loader.8;
 111           prompt, after an <literal>OK</literal>:</para>
 112
 113         <screen>set kern.kstack_pages=4
 114 boot</screen>
 115
 116         <para>Add this line to
 117           <filename>/boot/loader.conf</filename> for the change to
 118           persist across reboots:</para>
 119
 120         <programlisting>kern.kstack_pages=4</programlisting>
 121       </listitem>
 122
 123       <listitem>
 124         <para>[2017-07-25] &os;/&arch.arm64; currently lacks
 125           <acronym>EFI</acronym> real-time clock
 126           (<acronym>RTC</acronym>) support, which may cause the system
 127           to boot with the wrong time set.</para>
 128
 129         <para>As a workaround, either enable &man.ntpdate.8; or
 130           include <literal>ntpd_sync_on_start="YES"</literal> in
 131           &man.rc.conf.5;.</para>
 132       </listitem>
 133
 134       <listitem>
 135         <para>[2017-07-25] A late issue was discovered with
 136           &os;/&arch.arm64; and &quot;root on
 137           <acronym>ZFS</acronym>&quot; installations where the root
 138           <acronym>ZFS</acronym> pool would fail to be located.</para>
 139
 140         <para>There currently is no workaround.</para>
 141       </listitem>
 142
 143       <listitem>
 144         <para>[2017-11-06] An issue with &os; virtual machines with
 145           <application>vagrant</application> was discovered that
 146           affects the <application>VirtualBox</application> where the
 147           virtual machine will not start on the initial boot invoked
 148           with <literal>vagrant up</literal>.</para>
 149
 150         <para>The issue is due to the virtual machine
 151           <acronym>MAC</acronym> being unset, as &os; does not provide
 152           a default <filename>Vagrantfile</filename>.</para>
 153
 154         <para>It has been observed, however, that a subsequent
 155           invocation of <literal>vagrant up</literal> will allow the
 156           virtual machine to successfully boot, allowing access via
 157           <literal>vagrant ssh</literal>.</para>
 158       </listitem>
 159
 160       <listitem>
 161         <para>[2018-06-21] An issue had been discovered late in the
 162           release cycle where removing <acronym>ZFS</acronym> vdevs
 163           from a pool under certain conditions would cause a system
 164           crash when &man.zfsd.8; is enabled in
 165           &man.rc.conf.5;.</para>
 166
 167         <para>At present, it is believed to be limited to removal of
 168           a <literal>mirror</literal> vdev from a pool consisting of
 169           multiple <literal>mirror</literal> vdevs.</para>
 170
 171         <para>See <acronym>PR</acronym> <link
 172             xlink:href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=228750">228750</link>
 173           for more information and updates as the issue is
 174           investigated.</para>
 175       </listitem>
 176     </itemizedlist>
 177   </sect1>
 178
 179   <sect1 xml:id="late-news">
 180     <title>Late-Breaking News</title>
 181
 182     <para>No news.</para>
 183   </sect1>
 184 </article>