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