article.xml revision 265984 
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 265984 2014-05-13 22:43:02Z 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> exhastion 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    <sect3 xml:id="kernel-virtualization">
158      <title>Virtualization support</title>
159
160      <para>&nbsp;</para>
161
162    </sect3>
163
164    <sect3 xml:id="kernel-arm">
165      <title>ARM support</title>
166
167      <para>&nbsp;</para>
168
169    </sect3>
170
171    <sect3 xml:id="boot">
172      <title>Boot Loader Changes</title>
173
174      <para>&nbsp;</para>
175
176    </sect3>
177
178    <sect3 xml:id="proc">
179      <title>Hardware Support</title>
180
181      <para>&nbsp;</para>
182
183      <sect4 xml:id="mm">
184	<title>Multimedia Support</title>
185
186	<para>&nbsp;</para>
187
188      </sect4>
189
190      <sect4 xml:id="net-if">
191	<title>Network Interface Support</title>
192
193	<para>&nbsp;</para>
194
195      </sect4>
196    </sect3>
197
198    <sect3 xml:id="net-proto">
199      <title>Network Protocols</title>
200
201      <para>&nbsp;</para>
202
203    </sect3>
204
205    <sect3 xml:id="disks">
206      <title>Disks and Storage</title>
207
208      <para>&nbsp;</para>
209
210    </sect3>
211
212    <sect3 xml:id="fs">
213      <title>File Systems</title>
214
215      <para>&nbsp;</para>
216
217    </sect3>
218  </sect2>
219
220  <sect2 xml:id="userland">
221    <title>Userland Changes</title>
222
223    <para revision="260177">A new flag is added to &man.camcontrol.8;,
224      <literal>-b</literal>, which outputs the existing buses and
225      their parents.</para>
226
227    <sect3 xml:id="rc-scripts">
228      <title><filename>/etc/rc.d</filename> Scripts</title>
229
230      <para>&nbsp;</para>
231
232    </sect3>
233  </sect2>
234
235  <sect2 xml:id="contrib">
236    <title>Contributed Software</title>
237
238    <para revision="264377"><application>OpenSSH</application> has
239      been updated to version 6.6p1.</para>
240
241  </sect2>
242
243  <sect2 xml:id="ports">
244    <title>Ports/Packages Collection Infrastructure</title>
245
246    <para>&nbsp;</para>
247
248  </sect2>
249
250  <sect2 xml:id="releng">
251    <title>Release Engineering and Integration</title>
252
253    <para>&nbsp;</para>
254
255  </sect2>
256
257  <sect2 xml:id="doc">
258    <title>Documentation</title>
259
260    <para>&nbsp;</para>
261
262  </sect2>
263</sect1>
264
265<sect1 xml:id="upgrade">
266  <title>Upgrading from Previous Releases of &os;</title>
267
268  <para arch="amd64,i386">Binary upgrades between RELEASE versions
269    (and snapshots of the various security branches) are supported
270    using the &man.freebsd-update.8; utility.  The binary upgrade
271    procedure will update unmodified userland utilities, as well as
272    unmodified GENERIC or SMP kernels distributed as a part of an
273    official &os; release.  The &man.freebsd-update.8; utility
274    requires that the host being upgraded have Internet
275    connectivity.</para>
276
277  <para>Source-based upgrades (those based on recompiling the &os;
278    base system from source code) from previous versions are
279    supported, according to the instructions in
280    <filename>/usr/src/UPDATING</filename>.</para>
281
282  <important>
283    <para>Upgrading &os; should only be attempted after
284      backing up <emphasis>all</emphasis> data and configuration
285      files.</para>
286  </important>
287</sect1>
288</article>
289