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