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