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