article.xml revision 266516
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: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 266516 2014-05-21 18:58:31Z gjb $</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  </sect2>
258
259  <sect2 xml:id="ports">
260    <title>Ports/Packages Collection Infrastructure</title>
261
262    <para>&nbsp;</para>
263
264  </sect2>
265
266  <sect2 xml:id="releng">
267    <title>Release Engineering and Integration</title>
268
269    <para>&nbsp;</para>
270
271  </sect2>
272
273  <sect2 xml:id="doc">
274    <title>Documentation</title>
275
276    <para>&nbsp;</para>
277
278  </sect2>
279</sect1>
280
281<sect1 xml:id="upgrade">
282  <title>Upgrading from Previous Releases of &os;</title>
283
284  <para arch="amd64,i386">Binary upgrades between RELEASE versions
285    (and snapshots of the various security branches) are supported
286    using the &man.freebsd-update.8; utility.  The binary upgrade
287    procedure will update unmodified userland utilities, as well as
288    unmodified GENERIC or SMP kernels distributed as a part of an
289    official &os; release.  The &man.freebsd-update.8; utility
290    requires that the host being upgraded have Internet
291    connectivity.</para>
292
293  <para>Source-based upgrades (those based on recompiling the &os;
294    base system from source code) from previous versions are
295    supported, according to the instructions in
296    <filename>/usr/src/UPDATING</filename>.</para>
297
298  <important>
299    <para>Upgrading &os; should only be attempted after
300      backing up <emphasis>all</emphasis> data and configuration
301      files.</para>
302  </important>
303</sect1>
304</article>
305