article.xml revision 270375
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<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
7 %sponsor;
8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
9 %vendor;
10]>
11<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
12<info>
13  <title>&os; &release.current; Release Notes</title>
14
15  <author>
16    <orgname>The &os; Project</orgname>
17  </author>
18
19  <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 270375 2014-08-22 20:32:25Z gjb $</pubdate>
20
21  <copyright>
22    <year>2000</year>
23    <year>2001</year>
24    <year>2002</year>
25    <year>2003</year>
26    <year>2004</year>
27    <year>2005</year>
28    <year>2006</year>
29    <year>2007</year>
30    <year>2008</year>
31    <year>2009</year>
32    <year>2010</year>
33    <year>2011</year>
34    <year>2012</year>
35    <year>2013</year>
36    <year>2014</year>
37    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
38  </copyright>
39
40  <legalnotice xml:id="trademarks" role="trademarks">
41    &tm-attrib.freebsd;
42    &tm-attrib.ibm;
43    &tm-attrib.ieee;
44    &tm-attrib.intel;
45    &tm-attrib.sparc;
46    &tm-attrib.general;
47  </legalnotice>
48
49  <abstract>
50    <para>The release notes for &os; &release.current; contain
51      a summary of the changes made to the &os; base system on the
52      &release.branch; development line.  This document lists
53      applicable security advisories that were issued since the last
54      release, as well as significant changes to the &os; kernel and
55      userland.  Some brief remarks on upgrading are also
56      presented.</para>
57  </abstract>
58</info>
59
60<sect1 xml:id="intro">
61  <title>Introduction</title>
62
63  <para>This document contains the release notes for &os;
64    &release.current;.  It describes recently added, changed, or
65    deleted features of &os;.  It also provides some notes on
66    upgrading from previous versions of &os;.</para>
67
68  <para releasetype="current">The &release.type; distribution to which
69    these release notes apply represents the latest point along the
70    &release.branch; development branch since &release.branch; was
71    created.  Information regarding pre-built, binary &release.type;
72    distributions along this branch can be found at <uri
73      xlink:href="&release.url;">&release.url;</uri>.</para>
74
75  <para releasetype="snapshot">The &release.type; distribution to
76    which these release notes apply represents a point along the
77    &release.branch; development branch between &release.prev; and the
78    future &release.next;.  Information regarding pre-built, binary
79    &release.type; distributions along this branch can be found at
80    <uri xlink:href="&release.url;">&release.url;</uri>.</para>
81
82  <para releasetype="release">This distribution of &os;
83    &release.current; is a &release.type; distribution.  It can be
84    found at <uri xlink:href="&release.url;">&release.url;</uri> or
85    any of its mirrors.  More information on obtaining this (or other)
86    &release.type; distributions of &os; can be found in the <link
87      xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
88	&os;</quote> appendix</link> to the <link
89      xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
90
91  <para>All users are encouraged to consult the release errata before
92    installing &os;.  The errata document is updated with
93    <quote>late-breaking</quote> information discovered late in the
94    release cycle or after the release.  Typically, it contains
95    information on known bugs, security advisories, and corrections to
96    documentation.  An up-to-date copy of the errata for &os;
97    &release.current; can be found on the &os; Web site.</para>
98</sect1>
99
100<sect1 xml:id="new">
101  <title>What's New</title>
102
103  <para>This section describes the most user-visible new or changed
104    features in &os; since &release.prev;.</para>
105
106  <para>Typical release note items document recent security advisories
107    issued after &release.prev;, new drivers or hardware support, new
108    commands or options, major bug fixes, or contributed software
109    upgrades.  They may also list changes to major ports/packages or
110    release engineering practices.  Clearly the release notes cannot
111    list every single change made to &os; between releases; this
112    document focuses primarily on security advisories, user-visible
113    changes, and major architectural improvements.</para>
114
115  <sect2 xml:id="security">
116    <title>Security Advisories</title>
117
118    <para>&nbsp;</para>
119
120  </sect2>
121
122  <sect2 xml:id="kernel">
123    <title>Kernel Changes</title>
124
125    <para revision="260338">The <literal>vfs.zfs.zio.use_uma</literal>
126      &man.sysctl.8; has been re-enabled.  On multi-CPU machines with
127      enough RAM, this can easily double &man.zfs.8; performance or
128      reduce CPU usage in half.  It was originally disabled due to
129      memory and <acronym>KVA</acronym> exhaustion problem reports,
130      which should be resolved due to several change in the VM
131      subsystem.</para>
132
133    <para revision="260385" contrib="sponsor" sponsor="&ix;">The
134      &man.geom.4; RAID driver has been
135      updated to support unmapped I/O.</para>
136
137    <para revision="260431">A new &man.sysctl.8;,
138      <literal>kern.panic_reboot_wait_time</literal>, has been added,
139      which allows controlling how long the system will wait after
140      &man.panic.9; before rebooting.</para>
141
142    <para revision="260857">The &man.virtio_blk.4; driver has been
143      updated to support unmapped I/O.</para>
144
145    <para revision="260858">The &man.virtio_scsi.4; driver has been
146      updated to support unmapped I/O.</para>
147
148    <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
149      &man.mpr.4; device has been added,
150      providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
151      controllers.</para>
152
153    <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
154      &man.mrsas.4; driver has been added,
155      providing support for LSI MegaRAID SAS controllers.  The
156      &man.mfi.4; driver will attach to the controller, by default.
157      To enable &man.mrsas.4; add
158      <literal>hw.mfi.mrsas_enable=1</literal> to
159      <filename>/boot/loader.conf</filename>, which turns off
160      &man.mfi.4; device probing.</para>
161
162    <note>
163      <para>At this time, the &man.mfiutil.8; utility and
164	the &os; version of
165	<application>MegaCLI</application> and
166	<application>StorCli</application> do not work with
167	&man.mrsas.4;.</para>
168    </note>
169
170    <para revision="266165">A kernel bug that inhibited proper
171      functionality of the <literal>dev.cpu.0.freq</literal>
172      &man.sysctl.8; on &intel; processors with Turbo
173      Boost&nbsp;&trade; enabled has been fixed.</para>
174
175    <sect3 xml:id="kernel-virtualization">
176      <title>Virtualization support</title>
177
178      <para revision="259450">Support for &microsoft; Hyper-V
179	has been added to &os;/i386 as loadable modules, however
180	not available in the <filename>GENERIC</filename> kernel
181	configuration.</para>
182
183      <para revision="261090">The &man.bhyve.4; hypervisor now
184	supports soft power-off functionality via the ACPI S5
185	state.</para>
186    </sect3>
187
188    <sect3 xml:id="kernel-arm">
189      <title>ARM support</title>
190
191      <para revision="259355">The <filename>WANDBOARD</filename>
192	kernel configuration file has been added.</para>
193
194    </sect3>
195
196    <sect3 xml:id="boot">
197      <title>Boot Loader Changes</title>
198
199      <para>&nbsp;</para>
200
201    </sect3>
202
203    <sect3 xml:id="proc">
204      <title>Hardware Support</title>
205
206      <para>&nbsp;</para>
207
208      <sect4 xml:id="mm">
209	<title>Multimedia Support</title>
210
211	<para>&nbsp;</para>
212
213      </sect4>
214
215      <sect4 xml:id="net-if">
216	<title>Network Interface Support</title>
217
218	<para revision="259453">Support for Ralink RT5370 and
219	  RT5372 chipsets has been added.</para>
220
221	<para revision="260120">Firmware for the &man.run.4; driver
222	  has been updated to version 0.33.</para>
223
224	<para revision="261868">Support for the Ralink RT3593
225	  chipset has been added.</para>
226
227	<para revision="261972">The &man.nve.4; driver is now
228	  deprecated, and the &man.nfe.4; driver should be used
229	  instead.</para>
230      </sect4>
231    </sect3>
232
233    <sect3 xml:id="net-proto">
234      <title>Network Protocols</title>
235
236      <para>&nbsp;</para>
237
238    </sect3>
239
240    <sect3 xml:id="disks">
241      <title>Disks and Storage</title>
242
243      <para revision="259328" contrib="sponsor"
244	sponsor="&ff;">The &man.geom.8; <literal>label</literal> class
245	is now aware of resized partitions.  This corrects an issue
246	where <command>geom resize</command> would resize the
247	partition, but the label provider in <filename
248	  class="directory">/dev/gptid/</filename> would not be
249	resized.</para>
250
251      <para revision="260502">The &man.gmirror.8;
252	utility now has a <literal>resize</literal> command, making
253	it easier to resize the size of a mirror when all of its
254	components have been replaced.</para>
255
256      <para revision="268091">Support for the
257	<literal>disklabel64</literal> partitioning scheme has been
258	added to &man.gpart.8;.</para>
259    </sect3>
260
261    <sect3 xml:id="fs">
262      <title>File Systems</title>
263
264      <para revision="260178" contrib="vendor"
265	vendor="&netflix;">A new flag, <literal>-R</literal>,
266	has been added to the &man.fsck.ffs.8; utility.  When used,
267	&man.fsck.ffs.8; will restart itself when too many critical
268	errors have been detected.</para>
269    </sect3>
270  </sect2>
271
272  <sect2 xml:id="userland">
273    <title>Userland Changes</title>
274
275    <para revision="260177" contrib="sponsor"
276      sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
277      <literal>-b</literal>, which outputs the existing buses and
278      their parents.</para>
279
280    <para revision="262075">The &man.newsyslog.8; utility has been
281      updated to rotate files based on the actual file size instead
282      of the blocks on disk.  This matches the behavior documented in
283      &man.newsyslog.conf.5;.</para>
284
285    <para revision="266279">The &man.ps.1; utility has been
286      updated to include the <literal>-J</literal> flag, used to
287      filter output by matching &man.jail.8; IDs and names.
288      Additionally, argument <literal>0</literal> can be used to
289      <literal>-J</literal> to only list processes running on the
290      host system.</para>
291
292    <para revision="266280">The &man.top.1; utility has been updated
293      to filter by &man.jail.8; ID or name, in followup to the
294      &man.ps.1; change in <literal>r265229</literal>.</para>
295
296    <para revision="266890">The &man.pmcstat.8; utility has been
297      updated to include a new flag, <literal>-l</literal>, which
298      ends event collection after the specified number of
299      seconds.</para>
300
301    <para revision="267113">The default &man.newsyslog.conf.5; now
302      includes files in the
303      <filename>/etc/newsyslog.conf.d/</filename> and
304      <filename>/usr/local/etc/newsyslog.conf.d/</filename>
305      directories by default for &man.newsyslog.8;.</para>
306
307    <para revision="267236">A new flag, <quote>onifconsole</quote> has
308      been added to <filename>/etc/ttys</filename>.  This allows the
309      system to provide a login prompt via serial console if the
310      device is an active kernel console, otherwise it is equivalent
311      to <literal>off</literal>.</para>
312
313    <para revision="268161">The &man.mkimg.1; utility has been merged
314      from &os;-CURRENT.</para>
315
316    <sect3 xml:id="rc-scripts">
317      <title><filename>/etc/rc.d</filename> Scripts</title>
318
319      <para>&nbsp;</para>
320
321    </sect3>
322  </sect2>
323
324  <sect2 xml:id="contrib">
325    <title>Contributed Software</title>
326
327    <para revision="264377"><application>OpenSSH</application> has
328      been updated to version 6.6p1.</para>
329
330    <para revision="266692"><application>Sendmail</application>
331      has been updated to 8.14.9.</para>
332
333    <para revision="267258"><application>OpenSSL</application> has
334      been updated to version 1.0.1h.</para>
335  </sect2>
336
337  <sect2 xml:id="ports">
338    <title>Ports/Packages Collection Infrastructure</title>
339
340    <para>&nbsp;</para>
341
342  </sect2>
343
344  <sect2 xml:id="releng">
345    <title>Release Engineering and Integration</title>
346
347    <para>&nbsp;</para>
348
349  </sect2>
350
351  <sect2 xml:id="doc">
352    <title>Documentation</title>
353
354    <para>&nbsp;</para>
355
356  </sect2>
357</sect1>
358
359<sect1 xml:id="upgrade">
360  <title>Upgrading from Previous Releases of &os;</title>
361
362  <para arch="amd64,i386">Binary upgrades between RELEASE versions
363    (and snapshots of the various security branches) are supported
364    using the &man.freebsd-update.8; utility.  The binary upgrade
365    procedure will update unmodified userland utilities, as well as
366    unmodified GENERIC or SMP kernels distributed as a part of an
367    official &os; release.  The &man.freebsd-update.8; utility
368    requires that the host being upgraded have Internet
369    connectivity.</para>
370
371  <para>Source-based upgrades (those based on recompiling the &os;
372    base system from source code) from previous versions are
373    supported, according to the instructions in
374    <filename>/usr/src/UPDATING</filename>.</para>
375
376  <important>
377    <para>Upgrading &os; should only be attempted after
378      backing up <emphasis>all</emphasis> data and configuration
379      files.</para>
380  </important>
381</sect1>
382</article>
383