article.xml revision 270469
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 270469 2014-08-24 14:21:21Z 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="262861">The &man.vt.4; driver has been merged
149      from &os;-CURRENT.  To enable &man.vt.4;, enter
150      <literal>set kern.vty=vt</literal> at the &man.loader.8; prompt
151      during boot, or add <literal>kern.vty=vt</literal> to
152      &man.loader.conf.5; and reboot the system.</para>
153
154    <para revision="262967">Support for MegaRAID Fury cards has been
155      added to the &man.mfi.4; driver.</para>
156
157    <para revision="263024">The &man.aacraid.4; driver has been
158      updated to version 3.2.5.</para>
159
160    <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
161      &man.mpr.4; device has been added,
162      providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
163      controllers.</para>
164
165    <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
166      &man.mrsas.4; driver has been added,
167      providing support for LSI MegaRAID SAS controllers.  The
168      &man.mfi.4; driver will attach to the controller, by default.
169      To enable &man.mrsas.4; add
170      <literal>hw.mfi.mrsas_enable=1</literal> to
171      <filename>/boot/loader.conf</filename>, which turns off
172      &man.mfi.4; device probing.</para>
173
174    <note>
175      <para>At this time, the &man.mfiutil.8; utility and
176	the &os; version of
177	<application>MegaCLI</application> and
178	<application>StorCli</application> do not work with
179	&man.mrsas.4;.</para>
180    </note>
181
182    <para revision="266165">A kernel bug that inhibited proper
183      functionality of the <literal>dev.cpu.0.freq</literal>
184      &man.sysctl.8; on &intel; processors with Turbo
185      Boost&nbsp;&trade; enabled has been fixed.</para>
186
187    <sect3 xml:id="kernel-virtualization">
188      <title>Virtualization support</title>
189
190      <para revision="259450">Support for &microsoft; Hyper-V
191	has been added to &os;/i386 as loadable modules, however
192	not available in the <filename>GENERIC</filename> kernel
193	configuration.</para>
194
195      <para revision="261090">The &man.bhyve.4; hypervisor now
196	supports soft power-off functionality via the ACPI S5
197	state.</para>
198    </sect3>
199
200    <sect3 xml:id="kernel-arm">
201      <title>ARM support</title>
202
203      <para revision="259355">The <filename>WANDBOARD</filename>
204	kernel configuration file has been added.</para>
205
206    </sect3>
207
208    <sect3 xml:id="boot">
209      <title>Boot Loader Changes</title>
210
211      <para revision="262701">A kernel selection menu has been added
212	to &man.loader.8;.  If the <quote>beastie menu</quote> is
213	enabled, the kernel to boot may be selected from the kernel
214	selection menu.  Additional kernels may be listed in
215	&man.loader.conf.5; as a comma- or space-separated list.  By
216	default, <literal>kernel</literal> and
217	<literal>kernel.old</literal> are listed.</para>
218    </sect3>
219
220    <sect3 xml:id="proc">
221      <title>Hardware Support</title>
222
223      <para>&nbsp;</para>
224
225      <sect4 xml:id="mm">
226	<title>Multimedia Support</title>
227
228	<para>&nbsp;</para>
229
230      </sect4>
231
232      <sect4 xml:id="net-if">
233	<title>Network Interface Support</title>
234
235	<para revision="259453">Support for Ralink RT5370 and
236	  RT5372 chipsets has been added to the &man.run.4;
237	  driver.</para>
238
239	<para revision="260120">Firmware for the &man.run.4; driver
240	  has been updated to version 0.33.</para>
241
242	<para revision="261868">Support for the Ralink RT3593
243	  chipset has been added to the &man.run.4; driver.</para>
244
245	<para revision="261972">The &man.nve.4; driver is now
246	  deprecated, and the &man.nfe.4; driver should be used
247	  instead.</para>
248
249	<para revision="262137">Support for the &man.axge.4; driver
250	  has been added.  This driver supports the ASIX AX88178A and
251	  AX88179 USB ethernet adapters.  The AX88178A supports USB
252	  2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
253
254	<para revision="262363">The &man.urndis.4; driver has been
255	  imported from OpenBSD.</para>
256      </sect4>
257    </sect3>
258
259    <sect3 xml:id="net-proto">
260      <title>Network Protocols</title>
261
262      <para>&nbsp;</para>
263
264    </sect3>
265
266    <sect3 xml:id="disks">
267      <title>Disks and Storage</title>
268
269      <para revision="259328" contrib="sponsor"
270	sponsor="&ff;">The &man.geom.8; <literal>label</literal> class
271	is now aware of resized partitions.  This corrects an issue
272	where <command>geom resize</command> would resize the
273	partition, but the label provider in <filename
274	  class="directory">/dev/gptid/</filename> would not be
275	resized.</para>
276
277      <para revision="260502">The &man.gmirror.8;
278	utility now has a <literal>resize</literal> command, making
279	it easier to resize the size of a mirror when all of its
280	components have been replaced.</para>
281
282      <para revision="268091">Support for the
283	<literal>disklabel64</literal> partitioning scheme has been
284	added to &man.gpart.8;.</para>
285    </sect3>
286
287    <sect3 xml:id="fs">
288      <title>File Systems</title>
289
290      <para revision="260178" contrib="vendor"
291	vendor="&netflix;">A new flag, <literal>-R</literal>,
292	has been added to the &man.fsck.ffs.8; utility.  When used,
293	&man.fsck.ffs.8; will restart itself when too many critical
294	errors have been detected.</para>
295    </sect3>
296  </sect2>
297
298  <sect2 xml:id="userland">
299    <title>Userland Changes</title>
300
301    <para revision="260177" contrib="sponsor"
302      sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
303      <literal>-b</literal>, which outputs the existing buses and
304      their parents.</para>
305
306    <para revision="262075">The &man.newsyslog.8; utility has been
307      updated to rotate files based on the actual file size instead
308      of the blocks on disk.  This matches the behavior documented in
309      &man.newsyslog.conf.5;.</para>
310
311    <para revision="262384">The location of the &man.rctl.8;
312      configuration file can now be overridden in &man.rc.conf.5;.
313      To use a non-default location, set <literal>rctl_rules</literal>
314      in &man.rc.conf.5; to the location of the file.</para>
315
316    <para revision="262855">The <application>ATF</application> test
317      suite has been updated to version 0.20.</para>
318
319    <para revision="263019">The <literal>libucl</literal> library
320      (Unified Configuration Library) has been merged from
321      &os;-CURRENT.</para>
322
323    <para revision="263020">The &man.pkg.7; bootstrapping utility has
324      been synced with the version in &os;-CURRENT.</para>
325
326    <para revision="263046">The timezone database has been updated to
327      version tzdata2014a.</para>
328
329    <para revision="266279">The &man.ps.1; utility has been
330      updated to include the <literal>-J</literal> flag, used to
331      filter output by matching &man.jail.8; IDs and names.
332      Additionally, argument <literal>0</literal> can be used to
333      <literal>-J</literal> to only list processes running on the
334      host system.</para>
335
336    <para revision="266280">The &man.top.1; utility has been updated
337      to filter by &man.jail.8; ID or name, in followup to the
338      &man.ps.1; change in <literal>r265229</literal>.</para>
339
340    <para revision="266890">The &man.pmcstat.8; utility has been
341      updated to include a new flag, <literal>-l</literal>, which
342      ends event collection after the specified number of
343      seconds.</para>
344
345    <para revision="267113">The default &man.newsyslog.conf.5; now
346      includes files in the
347      <filename>/etc/newsyslog.conf.d/</filename> and
348      <filename>/usr/local/etc/newsyslog.conf.d/</filename>
349      directories by default for &man.newsyslog.8;.</para>
350
351    <para revision="267236">A new flag, <quote>onifconsole</quote> has
352      been added to <filename>/etc/ttys</filename>.  This allows the
353      system to provide a login prompt via serial console if the
354      device is an active kernel console, otherwise it is equivalent
355      to <literal>off</literal>.</para>
356
357    <para revision="268161">The &man.mkimg.1; utility has been merged
358      from &os;-CURRENT.</para>
359
360    <sect3 xml:id="rc-scripts">
361      <title><filename>/etc/rc.d</filename> Scripts</title>
362
363      <para>&nbsp;</para>
364
365    </sect3>
366  </sect2>
367
368  <sect2 xml:id="contrib">
369    <title>Contributed Software</title>
370
371    <para revision="264377"><application>OpenSSH</application> has
372      been updated to version 6.6p1.</para>
373
374    <para revision="266692"><application>Sendmail</application>
375      has been updated to 8.14.9.</para>
376
377    <para revision="267258"><application>OpenSSL</application> has
378      been updated to version 1.0.1h.</para>
379  </sect2>
380
381  <sect2 xml:id="ports">
382    <title>Ports/Packages Collection Infrastructure</title>
383
384    <para>&nbsp;</para>
385
386  </sect2>
387
388  <sect2 xml:id="releng">
389    <title>Release Engineering and Integration</title>
390
391    <para revision="263028">The &man.services.mkdb.8; utility has
392      been updated to include endianness awareness, allowing the
393      <filename>services.db</filename> database to be created as
394      part of the release build, regardless of native- or
395      cross-built releases.</para>
396  </sect2>
397
398  <sect2 xml:id="doc">
399    <title>Documentation</title>
400
401    <para>&nbsp;</para>
402
403  </sect2>
404</sect1>
405
406<sect1 xml:id="upgrade">
407  <title>Upgrading from Previous Releases of &os;</title>
408
409  <para arch="amd64,i386">Binary upgrades between RELEASE versions
410    (and snapshots of the various security branches) are supported
411    using the &man.freebsd-update.8; utility.  The binary upgrade
412    procedure will update unmodified userland utilities, as well as
413    unmodified GENERIC or SMP kernels distributed as a part of an
414    official &os; release.  The &man.freebsd-update.8; utility
415    requires that the host being upgraded have Internet
416    connectivity.</para>
417
418  <para>Source-based upgrades (those based on recompiling the &os;
419    base system from source code) from previous versions are
420    supported, according to the instructions in
421    <filename>/usr/src/UPDATING</filename>.</para>
422
423  <important>
424    <para>Upgrading &os; should only be attempted after
425      backing up <emphasis>all</emphasis> data and configuration
426      files.</para>
427  </important>
428</sect1>
429</article>
430