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