release/doc/en_US.ISO8859-1/relnotes/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         "../../../share/xml/freebsd50.dtd" [
   4 <!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
   5  %release;
   6 ]>
   7 <article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
   8 <info>
   9   <title>&os; &release.current; Release Notes</title>
  10
  11   <author>
  12     <orgname>The &os; Project</orgname>
  13   </author>
  14
  15   <pubdate>$FreeBSD$</pubdate>
  16
  17   <copyright>
  18     <year>2000</year>
  19     <year>2001</year>
  20     <year>2002</year>
  21     <year>2003</year>
  22     <year>2004</year>
  23     <year>2005</year>
  24     <year>2006</year>
  25     <year>2007</year>
  26     <year>2008</year>
  27     <year>2009</year>
  28     <year>2010</year>
  29     <year>2011</year>
  30     <year>2012</year>
  31     <year>2013</year>
  32     <year>2014</year>
  33     <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
  34   </copyright>
  35
  36   <legalnotice xml:id="trademarks" role="trademarks">
  37     &tm-attrib.freebsd;
  38     &tm-attrib.ibm;
  39     &tm-attrib.ieee;
  40     &tm-attrib.intel;
  41     &tm-attrib.sparc;
  42     &tm-attrib.general;
  43   </legalnotice>
  44
  45   <abstract>
  46     <para>The release notes for &os; &release.current; contain
  47       a summary of the changes made to the &os; base system on the
  48       &release.branch; development line.  This document lists
  49       applicable security advisories that were issued since the last
  50       release, as well as significant changes to the &os; kernel and
  51       userland.  Some brief remarks on upgrading are also
  52       presented.</para>
  53   </abstract>
  54 </info>
  55
  56 <sect1 xml:id="intro">
  57   <title>Introduction</title>
  58
  59   <para>This document contains the release notes for &os;
  60     &release.current;.  It describes recently added, changed, or
  61     deleted features of &os;.  It also provides some notes on
  62     upgrading from previous versions of &os;.</para>
  63
  64   <para releasetype="current">The &release.type; distribution to which
  65     these release notes apply represents the latest point along the
  66     &release.branch; development branch since &release.branch; was
  67     created.  Information regarding pre-built, binary &release.type;
  68     distributions along this branch can be found at <uri
  69       xlink:href="&release.url;">&release.url;</uri>.</para>
  70
  71   <para releasetype="snapshot">The &release.type; distribution to
  72     which these release notes apply represents a point along the
  73     &release.branch; development branch between &release.prev; and the
  74     future &release.next;.  Information regarding pre-built, binary
  75     &release.type; distributions along this branch can be found at
  76     <uri xlink:href="&release.url;">&release.url;</uri>.</para>
  77
  78   <para releasetype="release">This distribution of &os;
  79     &release.current; is a &release.type; distribution.  It can be
  80     found at <uri xlink:href="&release.url;">&release.url;</uri> or
  81     any of its mirrors.  More information on obtaining this (or other)
  82     &release.type; distributions of &os; can be found in the <link
  83       xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  84         &os;</quote> appendix</link> to the <link
  85       xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
  86
  87   <para>All users are encouraged to consult the release errata before
  88     installing &os;.  The errata document is updated with
  89     <quote>late-breaking</quote> information discovered late in the
  90     release cycle or after the release.  Typically, it contains
  91     information on known bugs, security advisories, and corrections to
  92     documentation.  An up-to-date copy of the errata for &os;
  93     &release.current; can be found on the &os; Web site.</para>
  94 </sect1>
  95
  96 <sect1 xml:id="new">
  97   <title>What's New</title>
  98
  99   <para>This section describes the most user-visible new or changed
 100     features in &os; since &release.prev;.</para>
 101
 102   <para>Typical release note items document recent security advisories
 103     issued after &release.prev;, new drivers or hardware support, new
 104     commands or options, major bug fixes, or contributed software
 105     upgrades.  They may also list changes to major ports/packages or
 106     release engineering practices.  Clearly the release notes cannot
 107     list every single change made to &os; between releases; this
 108     document focuses primarily on security advisories, user-visible
 109     changes, and major architectural improvements.</para>
 110
 111   <sect2 xml:id="security">
 112     <title>Security Advisories</title>
 113
 114     <para>&nbsp;</para>
 115
 116   </sect2>
 117
 118   <sect2 xml:id="kernel">
 119     <title>Kernel Changes</title>
 120
 121     <para revision="260338">The <literal>vfs.zfs.zio.use_uma</literal>
 122       &man.sysctl.8; has been re-enabled.  On multi-CPU machines with
 123       enough RAM, this can easily double &man.zfs.8; performance or
 124       reduce CPU usage in half.  It was originally disabled due to
 125       memory and <acronym>KVA</acronym> exhaustion problem reports,
 126       which should be resolved due to several change in the VM
 127       subsystem.</para>
 128
 129     <para revision="260385">The &man.geom.4; RAID driver has been
 130       updated to support unmapped I/O.</para>
 131
 132     <para revision="260431">A new &man.sysctl.8;,
 133       <literal>kern.panic_reboot_wait_time</literal>, has been added,
 134       which allows controlling how long the system will wait after
 135       &man.panic.9; before rebooting.</para>
 136
 137     <para revision="265388">The &man.mpr.4; device has been added,
 138       providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
 139       controllers.</para>
 140
 141     <para revision="265922">The &man.mrsas.4; driver has been added,
 142       providing support for LSI MegaRAID SAS controllers.  The
 143       &man.mfi.4; driver will attach to the controller, by default.
 144       To enable &man.mrsas.4; add
 145       <literal>hw.mfi.mrsas_enable=1</literal> to
 146       <filename>/boot/loader.conf</filename>, which turns off
 147       &man.mfi.4; device probing.</para>
 148
 149     <note>
 150       <para>At this time, the &man.mfiutil.8; utility and
 151         the &os; version of
 152         <application>MegaCLI</application> and
 153         <application>StorCli</application> do not work with
 154         &man.mrsas.4;.</para>
 155     </note>
 156
 157     <para revision="266165">A kernel bug that inhibited proper
 158       functionality of the <literal>dev.cpu.0.freq</literal>
 159       &man.sysctl.8; on &intel; processors with Turbo
 160       Boost&nbsp;&trade; enabled has been fixed.</para>
 161
 162     <sect3 xml:id="kernel-virtualization">
 163       <title>Virtualization support</title>
 164
 165       <para>&nbsp;</para>
 166
 167     </sect3>
 168
 169     <sect3 xml:id="kernel-arm">
 170       <title>ARM support</title>
 171
 172       <para>&nbsp;</para>
 173
 174     </sect3>
 175
 176     <sect3 xml:id="boot">
 177       <title>Boot Loader Changes</title>
 178
 179       <para>&nbsp;</para>
 180
 181     </sect3>
 182
 183     <sect3 xml:id="proc">
 184       <title>Hardware Support</title>
 185
 186       <para>&nbsp;</para>
 187
 188       <sect4 xml:id="mm">
 189         <title>Multimedia Support</title>
 190
 191         <para>&nbsp;</para>
 192
 193       </sect4>
 194
 195       <sect4 xml:id="net-if">
 196         <title>Network Interface Support</title>
 197
 198         <para>&nbsp;</para>
 199
 200       </sect4>
 201     </sect3>
 202
 203     <sect3 xml:id="net-proto">
 204       <title>Network Protocols</title>
 205
 206       <para>&nbsp;</para>
 207
 208     </sect3>
 209
 210     <sect3 xml:id="disks">
 211       <title>Disks and Storage</title>
 212
 213       <para>&nbsp;</para>
 214
 215     </sect3>
 216
 217     <sect3 xml:id="fs">
 218       <title>File Systems</title>
 219
 220       <para>&nbsp;</para>
 221
 222     </sect3>
 223   </sect2>
 224
 225   <sect2 xml:id="userland">
 226     <title>Userland Changes</title>
 227
 228     <para revision="260177">A new flag is added to &man.camcontrol.8;,
 229       <literal>-b</literal>, which outputs the existing buses and
 230       their parents.</para>
 231
 232     <para revision="266279">The &man.ps.1; utility has been
 233       updated to include the <literal>-J</literal> flag, used to
 234       filter output by matching &man.jail.8; IDs and names.
 235       Additionally, argument <literal>0</literal> can be used to
 236       <literal>-J</literal> to only list processes running on the
 237       host system.</para>
 238
 239     <para revision="266280">The &man.top.1; utility has been updated
 240       to filter by &man.jail.8; ID or name, in followup to the
 241       &man.ps.1; change in <literal>r265229</literal>.</para>
 242
 243     <sect3 xml:id="rc-scripts">
 244       <title><filename>/etc/rc.d</filename> Scripts</title>
 245
 246       <para>&nbsp;</para>
 247
 248     </sect3>
 249   </sect2>
 250
 251   <sect2 xml:id="contrib">
 252     <title>Contributed Software</title>
 253
 254     <para revision="264377"><application>OpenSSH</application> has
 255       been updated to version 6.6p1.</para>
 256
 257     <para revision="266692"><application>Sendmail</application>
 258       has been updated to 8.14.9.</para>
 259
 260   </sect2>
 261
 262   <sect2 xml:id="ports">
 263     <title>Ports/Packages Collection Infrastructure</title>
 264
 265     <para>&nbsp;</para>
 266
 267   </sect2>
 268
 269   <sect2 xml:id="releng">
 270     <title>Release Engineering and Integration</title>
 271
 272     <para>&nbsp;</para>
 273
 274   </sect2>
 275
 276   <sect2 xml:id="doc">
 277     <title>Documentation</title>
 278
 279     <para>&nbsp;</para>
 280
 281   </sect2>
 282 </sect1>
 283
 284 <sect1 xml:id="upgrade">
 285   <title>Upgrading from Previous Releases of &os;</title>
 286
 287   <para arch="amd64,i386">Binary upgrades between RELEASE versions
 288     (and snapshots of the various security branches) are supported
 289     using the &man.freebsd-update.8; utility.  The binary upgrade
 290     procedure will update unmodified userland utilities, as well as
 291     unmodified GENERIC or SMP kernels distributed as a part of an
 292     official &os; release.  The &man.freebsd-update.8; utility
 293     requires that the host being upgraded have Internet
 294     connectivity.</para>
 295
 296   <para>Source-based upgrades (those based on recompiling the &os;
 297     base system from source code) from previous versions are
 298     supported, according to the instructions in
 299     <filename>/usr/src/UPDATING</filename>.</para>
 300
 301   <important>
 302     <para>Upgrading &os; should only be attempted after
 303       backing up <emphasis>all</emphasis> data and configuration
 304       files.</para>
 305   </important>
 306 </sect1>
 307 </article>