article.xml revision 270525
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"
12  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
13
14<info>
15  <title>&os; &release.current; Release Notes</title>
16
17  <author>
18    <orgname>The &os; Project</orgname>
19  </author>
20
21  <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 270525 2014-08-25 09:06:45Z gjb $</pubdate>
22
23  <copyright>
24    <year>2000</year>
25    <year>2001</year>
26    <year>2002</year>
27    <year>2003</year>
28    <year>2004</year>
29    <year>2005</year>
30    <year>2006</year>
31    <year>2007</year>
32    <year>2008</year>
33    <year>2009</year>
34    <year>2010</year>
35    <year>2011</year>
36    <year>2012</year>
37    <year>2013</year>
38    <year>2014</year>
39    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
40      Project</holder>
41  </copyright>
42
43  <legalnotice xml:id="trademarks" role="trademarks">
44    &tm-attrib.freebsd;
45    &tm-attrib.ibm;
46    &tm-attrib.ieee;
47    &tm-attrib.intel;
48    &tm-attrib.sparc;
49    &tm-attrib.general;
50  </legalnotice>
51
52  <abstract>
53    <para>The release notes for &os; &release.current; contain
54      a summary of the changes made to the &os; base system on the
55      &release.branch; development line.  This document lists
56      applicable security advisories that were issued since the last
57      release, as well as significant changes to the &os; kernel and
58      userland.  Some brief remarks on upgrading are also
59      presented.</para>
60  </abstract>
61</info>
62
63<sect1 xml:id="intro">
64  <title>Introduction</title>
65
66  <para>This document contains the release notes for &os;
67    &release.current;.  It describes recently added, changed, or
68    deleted features of &os;.  It also provides some notes on
69    upgrading from previous versions of &os;.</para>
70
71  <para releasetype="current">The &release.type; distribution to which
72    these release notes apply represents the latest point along the
73    &release.branch; development branch since &release.branch; was
74    created.  Information regarding pre-built, binary &release.type;
75    distributions along this branch can be found at <uri
76      xlink:href="&release.url;">&release.url;</uri>.</para>
77
78  <para releasetype="snapshot">The &release.type; distribution to
79    which these release notes apply represents a point along the
80    &release.branch; development branch between &release.prev; and the
81    future &release.next;.  Information regarding pre-built, binary
82    &release.type; distributions along this branch can be found at
83    <uri xlink:href="&release.url;">&release.url;</uri>.</para>
84
85  <para releasetype="release">This distribution of &os;
86    &release.current; is a &release.type; distribution.  It can be
87    found at <uri xlink:href="&release.url;">&release.url;</uri> or
88    any of its mirrors.  More information on obtaining this (or other)
89    &release.type; distributions of &os; can be found in the <link
90      xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
91	&os;</quote> appendix</link> to the <link
92      xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
93
94  <para>All users are encouraged to consult the release errata before
95    installing &os;.  The errata document is updated with
96    <quote>late-breaking</quote> information discovered late in the
97    release cycle or after the release.  Typically, it contains
98    information on known bugs, security advisories, and corrections to
99    documentation.  An up-to-date copy of the errata for &os;
100    &release.current; can be found on the &os; Web site.</para>
101</sect1>
102
103<sect1 xml:id="new">
104  <title>What's New</title>
105
106  <para>This section describes the most user-visible new or changed
107    features in &os; since &release.prev;.</para>
108
109  <para>Typical release note items document recent security advisories
110    issued after &release.prev;, new drivers or hardware support, new
111    commands or options, major bug fixes, or contributed software
112    upgrades.  They may also list changes to major ports/packages or
113    release engineering practices.  Clearly the release notes cannot
114    list every single change made to &os; between releases; this
115    document focuses primarily on security advisories, user-visible
116    changes, and major architectural improvements.</para>
117
118  <sect2 xml:id="security">
119    <title>Security Advisories</title>
120
121    <para>&nbsp;</para>
122
123  </sect2>
124
125  <sect2 xml:id="kernel">
126    <title>Kernel Changes</title>
127
128    <para revision="260338">The <literal>vfs.zfs.zio.use_uma</literal>
129      &man.sysctl.8; has been re-enabled.  On multi-CPU machines with
130      enough RAM, this can easily double &man.zfs.8; performance or
131      reduce CPU usage in half.  It was originally disabled due to
132      memory and <acronym>KVA</acronym> exhaustion problem reports,
133      which should be resolved due to several change in the VM
134      subsystem.</para>
135
136    <para revision="260385" contrib="sponsor" sponsor="&ix;">The
137      &man.geom.4; RAID driver has been
138      updated to support unmapped I/O.</para>
139
140    <para revision="260431">A new &man.sysctl.8;,
141      <literal>kern.panic_reboot_wait_time</literal>, has been added,
142      which allows controlling how long the system will wait after
143      &man.panic.9; before rebooting.</para>
144
145    <para revision="260857">The &man.virtio_blk.4; driver has been
146      updated to support unmapped I/O.</para>
147
148    <para revision="260858">The &man.virtio_scsi.4; driver has been
149      updated to support unmapped I/O.</para>
150
151    <para revision="262861">The &man.vt.4; driver has been merged
152      from &os;-CURRENT.  To enable &man.vt.4;, enter
153      <literal>set kern.vty=vt</literal> at the &man.loader.8; prompt
154      during boot, or add <literal>kern.vty=vt</literal> to
155      &man.loader.conf.5; and reboot the system.</para>
156
157    <para revision="262967">Support for MegaRAID Fury cards has been
158      added to the &man.mfi.4; driver.</para>
159
160    <para revision="263024">The &man.aacraid.4; driver has been
161      updated to version 3.2.5.</para>
162
163    <para revision="263122">Support for &man.hwpmc.4; has been added
164      for &powerpc;&nbsp;970 class processors.</para>
165
166    <para revision="263197">Support for ADT7460 and ADT7467 fan
167      controllers found in newer PowerBooks&trade; and
168      iBooks&trade; has been added to the &man.iicbus.4;
169      driver.</para>
170
171    <para revision="263256">A panic triggered by removing
172      a &man.urtwn.4; device has been fixed.</para>
173
174    <para revision="263799">A potential deadlock in the &man.usb.4;
175      stack triggered by detaching USB devices that create character
176      devices has been fixed.</para>
177
178    <para revision="263869">Support for &amd;&nbsp;Family 16h sensor
179      devices has been added to &man.amdtemp.4;.</para>
180
181    <para revision="264522">Support for LUN-based CD changers has been
182      removed from the &man.cd.4; driver.</para>
183
184    <para revision="264734">Support for 9th generation HP host bus
185      adapter cards has been added to &man.ciss.4;.</para>
186
187    <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
188      &man.mpr.4; device has been added,
189      providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
190      controllers.</para>
191
192    <para revision="265536">The <literal>GEOM_VINUM</literal> option
193      is now able to be built both directly into the kernel or as
194      a &man.kldload.8; loadable module.</para>
195
196    <para revision="265610">The &man.uslcom.4; driver has been updated
197      to support 26 new devices.</para>
198
199    <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
200      &man.mrsas.4; driver has been added,
201      providing support for LSI MegaRAID SAS controllers.  The
202      &man.mfi.4; driver will attach to the controller, by default.
203      To enable &man.mrsas.4; add
204      <literal>hw.mfi.mrsas_enable=1</literal> to
205      <filename>/boot/loader.conf</filename>, which turns off
206      &man.mfi.4; device probing.</para>
207
208    <note>
209      <para>At this time, the &man.mfiutil.8; utility and
210	the &os; version of
211	<application>MegaCLI</application> and
212	<application>StorCli</application> do not work with
213	&man.mrsas.4;.</para>
214    </note>
215
216    <para revision="266165">A kernel bug that inhibited proper
217      functionality of the <literal>dev.cpu.0.freq</literal>
218      &man.sysctl.8; on &intel; processors with Turbo
219      Boost&nbsp;&trade; enabled has been fixed.</para>
220
221    <sect3 xml:id="kernel-virtualization">
222      <title>Virtualization Support</title>
223
224      <para revision="259450">Support for &microsoft; Hyper-V
225	has been added to &os;/i386 as loadable modules, however
226	not available in the <filename>GENERIC</filename> kernel
227	configuration.</para>
228
229      <para revision="261090">The &man.bhyve.4; hypervisor now
230	supports soft power-off functionality via the ACPI S5
231	state.</para>
232    </sect3>
233
234    <sect3 xml:id="kernel-arm">
235      <title>ARM Support</title>
236
237      <para revision="259355">The <filename>WANDBOARD</filename>
238	kernel configuration file has been added.</para>
239
240      <para revision="265067">Boot devices may now be specified by
241	setting a u-boot environment variable.  If a boot device is
242	not specified, the probe mechanism will be used.  To specify
243	the boot device, set the
244	<literal>loaderdev=<replaceable>device</replaceable></literal>
245	u-boot environment variable.</para>
246    </sect3>
247
248    <sect3 xml:id="boot">
249      <title>Boot Loader Changes</title>
250
251      <para revision="262701">A kernel selection menu has been added
252	to &man.loader.8;.  If the <quote>beastie menu</quote> is
253	enabled, the kernel to boot may be selected from the kernel
254	selection menu.  Additional kernels may be listed in
255	&man.loader.conf.5; as a comma- or space-separated list.  By
256	default, <literal>kernel</literal> and
257	<literal>kernel.old</literal> are listed.</para>
258    </sect3>
259
260    <sect3 xml:id="proc">
261      <title>Hardware Support</title>
262
263      <para>&nbsp;</para>
264
265      <sect4 xml:id="mm">
266	<title>Multimedia Support</title>
267
268	<para>&nbsp;</para>
269
270      </sect4>
271
272      <sect4 xml:id="net-if">
273	<title>Network Interface Support</title>
274
275	<para revision="259453">Support for Ralink RT5370 and
276	  RT5372 chipsets has been added to the &man.run.4;
277	  driver.</para>
278
279	<para revision="260120">Firmware for the &man.run.4; driver
280	  has been updated to version 0.33.</para>
281
282	<para revision="261868">Support for the Ralink RT3593
283	  chipset has been added to the &man.run.4; driver.</para>
284
285	<para revision="261972">The &man.nve.4; driver is now
286	  deprecated, and the &man.nfe.4; driver should be used
287	  instead.</para>
288
289	<para revision="262137">Support for the &man.axge.4; driver
290	  has been added.  This driver supports the ASIX AX88178A and
291	  AX88179 USB ethernet adapters.  The AX88178A supports USB
292	  2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
293
294	<para revision="262363">The &man.urndis.4; driver has been
295	  imported from OpenBSD.</para>
296
297	<para revision="264866">Support for multiple
298	  transmitter/receiver queues has been added to the
299	  &man.vmx.4; driver.</para>
300
301	<note>
302	  <para>The &os;&nbsp;guest operating system must have
303	    <acronym>MSIX</acronym> enabled as a prerequisite for
304	    multiple queues.</para>
305	</note>
306
307	<para revision="265345">Support for the ASUS USB-N10 Nano
308	  wireless card has been added to the &man.urtwn.4;
309	  driver.</para>
310      </sect4>
311    </sect3>
312
313    <sect3 xml:id="net-proto">
314      <title>Network Protocols</title>
315
316      <para>&nbsp;</para>
317
318    </sect3>
319
320    <sect3 xml:id="disks">
321      <title>Disks and Storage</title>
322
323      <para revision="259328" contrib="sponsor"
324	sponsor="&ff;">The &man.geom.8; <literal>label</literal> class
325	is now aware of resized partitions.  This corrects an issue
326	where <command>geom resize</command> would resize the
327	partition, but the label provider in <filename
328	  class="directory">/dev/gptid/</filename> would not be
329	resized.</para>
330
331      <para revision="260502">The &man.gmirror.8;
332	utility now has a <literal>resize</literal> command, making
333	it easier to resize the size of a mirror when all of its
334	components have been replaced.</para>
335
336      <para revision="268091">Support for the
337	<literal>disklabel64</literal> partitioning scheme has been
338	added to &man.gpart.8;.</para>
339    </sect3>
340
341    <sect3 xml:id="fs">
342      <title>File Systems</title>
343
344      <para revision="260178" contrib="vendor"
345	vendor="&netflix;">A new flag, <literal>-R</literal>,
346	has been added to the &man.fsck.ffs.8; utility.  When used,
347	&man.fsck.ffs.8; will restart itself when too many critical
348	errors have been detected.</para>
349
350      <para revision="263407">The &man.zfs.8; filesystem has been
351	updated to implement <quote>bookmarks</quote>.  See
352	&man.zfs.8; for further details.</para>
353    </sect3>
354  </sect2>
355
356  <sect2 xml:id="userland">
357    <title>Userland Changes</title>
358
359    <para revision="260177" contrib="sponsor"
360      sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
361      <literal>-b</literal>, which outputs the existing buses and
362      their parents.</para>
363
364    <para revision="262075">The &man.newsyslog.8; utility has been
365      updated to rotate files based on the actual file size instead
366      of the blocks on disk.  This matches the behavior documented in
367      &man.newsyslog.conf.5;.</para>
368
369    <para revision="262384">The location of the &man.rctl.8;
370      configuration file can now be overridden in &man.rc.conf.5;.
371      To use a non-default location, set <literal>rctl_rules</literal>
372      in &man.rc.conf.5; to the location of the file.</para>
373
374    <para revision="262855">The <application>ATF</application> test
375      suite has been updated to version 0.20.</para>
376
377    <para revision="263019">The <literal>libucl</literal> library
378      (Unified Configuration Library) has been merged from
379      &os;-CURRENT.</para>
380
381    <para revision="263020">The &man.pkg.7; bootstrapping utility has
382      been synced with the version in &os;-CURRENT.</para>
383
384    <para revision="263403">The &man.zfs.8; userland utility has been
385      updated to include aliases for <command>snapshot</command>,
386      which allows use of <command>zfs list -t snap</command> and
387      <command>zfs snap</command>.</para>
388
389    <para revision="263405">The &man.zfs.8; userland utility has been
390      updated to include a new flag to <command>zfs list</command>,
391      <literal>-p</literal>, which when specified, prints the output
392      in a parsable format.</para>
393
394    <para revision="263508">The &man.clang.1;/llvm suite has been
395      updated to version 3.4.</para>
396
397    <para revision="263783">The Blowfish password format
398      implementation updated.  Support for &dollar;2b&dollar; has
399      been added, allowing use of passwords greater than 256
400      characters long.</para>
401
402    <para revision="264497">The &man.iconv.3; library has been
403      updated to match NetBSD, providing several bug fixes.</para>
404
405    <para revision="265265">The &man.date.1; utility has been updated
406      to include a new flag, <literal>-R</literal>, which prints the
407      date and time output as specified in RFC 2822.</para>
408
409    <para revision="265533">The &man.bc.1; utility has been updated to
410      version 1.1, in sync with the version in OpenBSD.</para>
411
412    <para revision="265604" contrib="vendor"
413      vendor="&netflix;">The &man.pmcstat.8; utility has been
414      updated to include a new flag, <literal>-a</literal>, which when
415      specified, produces a full stack track on the sampled
416      points.</para>
417
418    <para revision="265701">The &man.netstat.8; and &man.route.8;
419      utilities have been updated to include a shorthand equivalent
420      to the <literal>-f inet</literal> and <literal>-f
421	inet6</literal> address specifiers, <literal>-4</literal> and
422      <literal>-6</literal>, respectively.</para>
423
424    <para revision="266279">The &man.ps.1; utility has been
425      updated to include the <literal>-J</literal> flag, used to
426      filter output by matching &man.jail.8; IDs and names.
427      Additionally, argument <literal>0</literal> can be used to
428      <literal>-J</literal> to only list processes running on the
429      host system.</para>
430
431    <para revision="266280">The &man.top.1; utility has been updated
432      to filter by &man.jail.8; ID or name, in followup to the
433      &man.ps.1; change in <literal>r265229</literal>.</para>
434
435    <para revision="266890">The &man.pmcstat.8; utility has been
436      updated to include a new flag, <literal>-l</literal>, which
437      ends event collection after the specified number of
438      seconds.</para>
439
440    <para revision="267113">The default &man.newsyslog.conf.5; now
441      includes files in the
442      <filename>/etc/newsyslog.conf.d/</filename> and
443      <filename>/usr/local/etc/newsyslog.conf.d/</filename>
444      directories by default for &man.newsyslog.8;.</para>
445
446    <para revision="267236">A new flag, <quote>onifconsole</quote> has
447      been added to <filename>/etc/ttys</filename>.  This allows the
448      system to provide a login prompt via serial console if the
449      device is an active kernel console, otherwise it is equivalent
450      to <literal>off</literal>.</para>
451
452    <para revision="268161">The &man.mkimg.1; utility has been merged
453      from &os;-CURRENT.</para>
454
455    <sect3 xml:id="rc-scripts">
456      <title><filename>/etc/rc.d</filename> Scripts</title>
457
458      <para revision="264438">The <filename>network.subr</filename>
459	&man.rc.8; script has been updated to loosen the requirement
460	of listing network aliases in numeric order.  Previously,
461	a network alias of
462	<literal>_alias<replaceable>2</replaceable></literal>
463	would not be created if
464	<literal>_alias<replaceable>1</replaceable></literal> was
465	not defined.</para>
466    </sect3>
467  </sect2>
468
469  <sect2 xml:id="contrib">
470    <title>Contributed Software</title>
471
472    <para revision="263285">The &man.xz.1; utility has been updated
473      to a post-5.0.5 snapshot.</para>
474
475    <para revision="263369" contrib="sponsor"
476      sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
477      been updated to the r196322 snapshot.</para>
478
479    <para revision="263906">The timezone database has been updated to
480      version tzdata2014b.</para>
481
482    <para revision="264377"><application>OpenSSH</application> has
483      been updated to version 6.6p1.</para>
484
485    <para revision="264911">The &man.nc.1; utility has been updated
486      to match the version in OpenBSD 5.5.</para>
487
488    <para revision="266692"><application>Sendmail</application>
489      has been updated to 8.14.9.</para>
490
491    <para revision="267258"><application>OpenSSL</application> has
492      been updated to version 1.0.1h.</para>
493  </sect2>
494
495  <sect2 xml:id="ports">
496    <title>Ports/Packages Collection Infrastructure</title>
497
498    <para>&nbsp;</para>
499
500  </sect2>
501
502  <sect2 xml:id="releng">
503    <title>Release Engineering and Integration</title>
504
505    <para revision="263028">The &man.services.mkdb.8; utility has
506      been updated to include endianness awareness, allowing the
507      <filename>services.db</filename> database to be created as
508      part of the release build, regardless of native- or
509      cross-built releases.</para>
510  </sect2>
511
512  <sect2 xml:id="doc">
513    <title>Documentation</title>
514
515    <para>&nbsp;</para>
516
517  </sect2>
518</sect1>
519
520<sect1 xml:id="upgrade">
521  <title>Upgrading from Previous Releases of &os;</title>
522
523  <para arch="amd64,i386">Binary upgrades between RELEASE versions
524    (and snapshots of the various security branches) are supported
525    using the &man.freebsd-update.8; utility.  The binary upgrade
526    procedure will update unmodified userland utilities, as well as
527    unmodified GENERIC or SMP kernels distributed as a part of an
528    official &os; release.  The &man.freebsd-update.8; utility
529    requires that the host being upgraded have Internet
530    connectivity.</para>
531
532  <para>Source-based upgrades (those based on recompiling the &os;
533    base system from source code) from previous versions are
534    supported, according to the instructions in
535    <filename>/usr/src/UPDATING</filename>.</para>
536
537  <important>
538    <para>Upgrading &os; should only be attempted after
539      backing up <emphasis>all</emphasis> data and configuration
540      files.</para>
541  </important>
542</sect1>
543</article>
544