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