]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - release/doc/en_US.ISO8859-1/relnotes/article.xml
Note r269398 adds RFC5661 support.
[FreeBSD/stable/10.git] / release / doc / en_US.ISO8859-1 / relnotes / article.xml
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$</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
72       which these release notes apply represents the latest point
73       along the &release.branch; development branch since
74       &release.branch; was created.  Information regarding pre-built,
75       binary &release.type; distributions along this branch can be
76       found at <uri
77         xlink:href="&release.url;">&release.url;</uri>.</para>
78
79     <para releasetype="snapshot">The &release.type; distribution to
80       which these release notes apply represents a point along the
81       &release.branch; development branch between &release.prev; and
82       the future &release.next;.  Information regarding pre-built,
83       binary &release.type; distributions along this branch can be
84       found at <uri
85         xlink:href="&release.url;">&release.url;</uri>.</para>
86
87     <para releasetype="release">This distribution of &os;
88       &release.current; is a &release.type; distribution.  It can be
89       found at <uri xlink:href="&release.url;">&release.url;</uri> or
90       any of its mirrors.  More information on obtaining this (or
91       other) &release.type; distributions of &os; can be found in the
92       <link
93         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
94           &os;</quote> appendix</link> to the <link
95         xlink:href="&url.books.handbook;/">&os;
96         Handbook</link>.</para>
97
98     <para>All users are encouraged to consult the release errata
99       before installing &os;.  The errata document is updated with
100       <quote>late-breaking</quote> information discovered late in the
101       release cycle or after the release.  Typically, it contains
102       information on known bugs, security advisories, and corrections
103       to documentation.  An up-to-date copy of the errata for &os;
104       &release.current; can be found on the &os; Web site.</para>
105   </sect1>
106
107   <sect1 xml:id="new">
108     <title>What's New</title>
109
110     <para>This section describes the most user-visible new or changed
111       features in &os; since &release.prev;.</para>
112
113     <para>Typical release note items document recent security
114       advisories issued after &release.prev;, new drivers or hardware
115       support, new commands or options, major bug fixes, or
116       contributed software upgrades.  They may also list changes to
117       major ports/packages or release engineering practices.  Clearly
118       the release notes cannot list every single change made to &os;
119       between releases; this document focuses primarily on security
120       advisories, user-visible changes, and major architectural
121       improvements.</para>
122
123     <sect2 xml:id="security">
124       <title>Security Advisories</title>
125
126       <para>&nbsp;</para>
127
128     </sect2>
129
130     <sect2 xml:id="kernel">
131       <title>Kernel Changes</title>
132
133       <para revision="260431">A new &man.sysctl.8;,
134         <literal>kern.panic_reboot_wait_time</literal>, has been
135         added, which allows controlling how long the system will wait
136         after &man.panic.9; before rebooting.</para>
137
138       <para revision="262861">The &man.vt.4; driver has been merged
139         from &os;-CURRENT.  To enable &man.vt.4;, enter
140         <literal>set kern.vty=vt</literal> at the &man.loader.8;
141         prompt during boot, or add <literal>kern.vty=vt</literal> to
142         &man.loader.conf.5; and reboot the system.</para>
143
144       <para revision="263122">Support for &man.hwpmc.4; has been added
145         for &powerpc;&nbsp;970 class processors.</para>
146
147       <para revision="263197">Support for ADT7460 and ADT7467 fan
148         controllers found in newer PowerBooks&trade; and
149         iBooks&trade; has been added to the &man.iicbus.4;
150         driver.</para>
151
152       <para revision="263256">A panic triggered by removing
153         a &man.urtwn.4; device has been fixed.</para>
154
155       <para revision="263799">A potential deadlock in the &man.usb.4;
156         stack triggered by detaching USB devices that create character
157         devices has been fixed.</para>
158
159       <para revision="263869">Support for &amd;&nbsp;Family 16h sensor
160         devices has been added to &man.amdtemp.4;.</para>
161
162       <para revision="265610">The &man.uslcom.4; driver has been
163         updated to support 26 new devices.</para>
164
165       <para revision="266165">A kernel bug that inhibited proper
166         functionality of the <literal>dev.cpu.0.freq</literal>
167         &man.sysctl.8; on &intel; processors with Turbo
168         Boost&trade; enabled has been fixed.</para>
169
170       <para revision="266436">The &man.uart.4; driver has been
171         updated to include support for the &intel;&nbsp;Lynx Point
172         KT <acronym>AMT</acronym> serial port.</para>
173
174       <para revision="266594">The <literal>radeonkms(4)</literal>
175         driver has been updated to include 32-bit &man.ioctl.2;
176         support, allowing 32-bit applications to run on a 64-bit
177         system.</para>
178
179       <para revision="266718">A bug that would prevent
180         a &man.jail.8; from setting the correct IPv4 source address
181         with some operations that required
182         <literal>security.jail.allow_raw_sockets</literal> has been
183         fixed.</para>
184
185       <para revision="266911">The &man.hwpmc.4; driver has been
186         updated to support core events from the Atom&trade;
187         Silvermont architecture.</para>
188
189       <para revision="268046">The &man.oce.4; driver has been updated
190         with vendor-supplied fixes for big endian support, and 20GB/s
191         and 25GB/s link speeds.</para>
192
193       <para revision="270630">The &os;&nbsp;virtual memory subsystem
194         has been updated to implement <quote>fast path</quote> for
195         the page fault handler.</para>
196
197       <sect3 xml:id="kernel-virtualization">
198         <title>Virtualization Support</title>
199
200         <para revision="259450">Support for &microsoft; Hyper-V
201           has been added to &os;/i386 as loadable modules, however
202           not available in the <filename>GENERIC</filename> kernel
203           configuration.</para>
204
205         <para revision="261090">The &man.bhyve.4; hypervisor now
206           supports soft power-off functionality via the ACPI S5
207           state.</para>
208
209         <para revision="267399">Support for &os;/i386 guests has been
210           added to &man.bhyve.4;.</para>
211
212         <para revision="267427">Support for virtualized
213           <literal>XSAVE</literal> has been added to &man.bhyve.4;,
214           allowing guest operating systems to use
215           <literal>XSAVE</literal> and
216           <literal>XSAVE</literal>-enabled features, such as
217           <acronym>AVX</acronym>.</para>
218
219         <para revision="268932">The &man.bhyve.4; hypervisor now
220           supports booting from a &man.zfs.8; filesystem.</para>
221
222         <para revision="268933">A new driver, &man.virtio_random.4;,
223           has been added, which allows &os; virtual machines to
224           harvest entropy from the hypervisor.</para>
225
226         <para revision="270159">The &man.bhyve.4; hypervisor has been
227           synced with the version in &os;-CURRENT.</para>
228
229         <para>A number of enhancements have been added, and several
230           bug fixes, including:</para>
231
232         <itemizedlist>
233           <listitem>
234             <para>Post-mortem debugging has been added when
235               a guest virtual machine exits with an
236               <quote><acronym>EPT</acronym> Misconfiguration</quote>
237               error.</para>
238           </listitem>
239
240           <listitem>
241             <para>The hypervisor &man.virtio.4; <acronym>API</acronym>
242               has been expanded from 32- to 64-bit.</para>
243           </listitem>
244
245           <listitem>
246             <para>Support for identifying capabilities of the virtual
247               <acronym>CPU</acronym> has been added.</para>
248           </listitem>
249
250           <listitem>
251             <para>Support for emulating legacy x86 task
252               switching has been added.</para>
253           </listitem>
254
255           <listitem>
256             <para>Support to list the VT-x features in base kernel
257               &man.dmesg.8; has been added.</para>
258           </listitem>
259
260           <listitem>
261             <para>Support for extended PCI configuration space
262               has been added.</para>
263           </listitem>
264         </itemizedlist>
265       </sect3>
266
267       <sect3 xml:id="kernel-arm">
268         <title>ARM Support</title>
269
270         <para revision="259355">The <filename>WANDBOARD</filename>
271           kernel configuration file has been added.</para>
272
273         <para revision="265067">Boot devices may now be specified by
274           setting a u-boot environment variable.  If a boot device is
275           not specified, the probe mechanism will be used.  To specify
276           the boot device, set the
277           <literal>loaderdev=<replaceable>device</replaceable></literal>
278           u-boot environment variable.</para>
279
280         <para revision="266000">The <literal>nexus(4)</literal> driver
281           has been updated to include <quote>Flattened Device
282             Tree</quote> support, replacing the &man.fdtbus.4; driver
283           in most cases.</para>
284
285         <para revision="266105">The &man.gpioiic.4; and
286           &man.gpioled.4; have been merged from &os;-CURRENT.</para>
287
288         <para revision="266379">The <literal>ZEDBOARD</literal> kernel
289           configuration file has been updated to include
290           <acronym>SMP</acronym> support.</para>
291       </sect3>
292
293       <sect3 xml:id="boot">
294         <title>Boot Loader Changes</title>
295
296         <para revision="262701">A kernel selection menu has been added
297           to &man.loader.8;.  If the <quote>beastie menu</quote> is
298           enabled, the kernel to boot may be selected from the kernel
299           selection menu.  Additional kernels may be listed in
300           &man.loader.conf.5; as a comma- or space-separated list.  By
301           default, <literal>kernel</literal> and
302           <literal>kernel.old</literal> are listed.</para>
303       </sect3>
304
305       <sect3 xml:id="proc">
306         <title>Hardware Support</title>
307
308         <para>&nbsp;</para>
309
310         <sect4 xml:id="mm">
311           <title>Multimedia Support</title>
312
313           <para>&nbsp;</para>
314
315         </sect4>
316
317         <sect4 xml:id="net-if">
318           <title>Network Interface Support</title>
319
320           <para revision="259453">Support for Ralink RT5370 and
321             RT5372 chipsets has been added to the &man.run.4;
322             driver.</para>
323
324           <para revision="260120">Firmware for the &man.run.4; driver
325             has been updated to version 0.33.</para>
326
327           <para revision="261868">Support for the Ralink RT3593
328             chipset has been added to the &man.run.4; driver.</para>
329
330           <para revision="261972">The &man.nve.4; driver is now
331             deprecated, and the &man.nfe.4; driver should be used
332             instead.</para>
333
334           <para revision="262137">Support for the &man.axge.4; driver
335             has been added.  This driver supports the ASIX AX88178A
336             and AX88179 USB ethernet adapters.  The AX88178A supports
337             USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
338
339           <para revision="262363">The &man.urndis.4; driver has been
340             imported from OpenBSD.</para>
341
342           <para revision="264866">Support for multiple
343             transmitter/receiver queues has been added to the
344             &man.vmx.4; driver.</para>
345
346           <note>
347             <para>The &os;&nbsp;guest operating system must have
348               <acronym>MSIX</acronym> enabled as a prerequisite for
349               multiple queues.</para>
350           </note>
351
352           <para revision="265345">Support for the ASUS USB-N10 Nano
353             wireless card has been added to the &man.urtwn.4;
354             driver.</para>
355
356           <para revision="266212">Transmission checksum offloading has
357             been disabled for the RTL8168C and RTL8168CP chipsets in
358             the &man.re.4; driver for TCP and UDP frames.  This is
359             due to a report of UDP datagrams with IP options
360             generating corrupt frames.</para>
361
362           <para revision="266578">Preliminary support has been added
363             to the &man.urtwn.4; driver for the Realtek RTL8188EUS and
364             RTL8188ETV chipsets.</para>
365
366           <para revision="267694">A bug in the fast receiver buffer
367             recycle path has been fixed in the &man.cxgbe.4;
368             driver.</para>
369
370           <para revision="267849" contrib="vendor"
371             vendor="&chelsio;">The bundled &man.cxgbe.4; firmware for
372             T4 and T5 cards has been updated to version
373             1.11.27.0.</para>
374
375           <para revision="269196">The &man.em.4; driver has been
376             updated to version 7.4.2.</para>
377
378           <para revision="269975">The &man.ixgbe.4; tunables have been
379             renamed to match their &man.sysctl.8; counterparts:</para>
380
381           <informaltable frame="none" pgwide="0">
382             <tgroup cols="2">
383               <colspec colwidth="1*"/>
384               <colspec colwidth="1*"/>
385               <thead>
386                 <row>
387                   <entry>Old Name</entry>
388                   <entry>New Name</entry>
389                 </row>
390               </thead>
391
392               <tbody>
393                 <row>
394                   <entry><literal>hw.ixgbe.enable_aim</literal></entry>
395                   <entry><literal>hw.ix.enable_aim</literal></entry>
396                 </row>
397
398                 <row>
399                   <entry><literal>hw.ixgbe.max_interrupt_rate</literal></entry>
400                   <entry><literal>hw.ix.max_interrupt_rate</literal></entry>
401                 </row>
402
403                 <row>
404                   <entry><literal>hw.ixgbe.rx_process_limit</literal></entry>
405                   <entry><literal>hw.ix.rx_process_limit</literal></entry>
406                 </row>
407
408                 <row>
409                   <entry><literal>hw.ixgbe.tx_process_limit</literal></entry>
410                   <entry><literal>hw.ix.tx_process_limit</literal></entry>
411                 </row>
412
413                 <row>
414                   <entry><literal>hw.ixgbe.enable_msix</literal></entry>
415                   <entry><literal>hw.ix.enable_msix</literal></entry>
416                 </row>
417
418                 <row>
419                   <entry><literal>hw.ixgbe.num_queues</literal></entry>
420                   <entry><literal>hw.ix.num_queues</literal></entry>
421                 </row>
422
423                 <row>
424                   <entry><literal>hw.ixgbe.txd</literal></entry>
425                   <entry><literal>hw.ix.txd</literal></entry>
426                 </row>
427
428                 <row>
429                   <entry><literal>hw.ixgbe.rxd</literal></entry>
430                   <entry><literal>hw.ix.rxd</literal></entry>
431                 </row>
432
433                 <row>
434                   <entry><literal>hw.ixgbe.unsupported_sfp</literal></entry>
435                   <entry><literal>hw.ix.unsupported_sfp</literal></entry>
436                 </row>
437               </tbody>
438             </tgroup>
439           </informaltable>
440
441           <para>Be sure to update &man.loader.conf.5; if using the
442             old tunables before upgrading to
443             &os;&nbsp;&release.current;.</para>
444
445           <para revision="270061">The &man.if.nf10bmac.4; driver has
446             been merged from &os;-CURRENT to support the NetFPGA-10G
447             Embedded CPU Ethernet Core.</para>
448
449           <para revision="270297">The &man.cxgbe.4; driver has been
450             updated to support &man.netmap.4; for the T5 10G/40G
451             cards.</para>
452
453           <para revision="270509">The &man.vtnet.4; driver has been
454             updated to support &man.netmap.4;.</para>
455
456           <para revision="270514">The &man.urtwn.4; driver has been
457             updated to support the ASUS USB-AC51 wireless card.</para>
458
459           <para revision="270631">The &intel;&nbsp;XL710 ethernet
460             controller driver, <literal>ixlv(4)</literal>, has been
461             merged from &os;-CURRENT.</para>
462         </sect4>
463       </sect3>
464
465       <sect3 xml:id="net-proto">
466         <title>Network Protocols</title>
467
468         <para revision="265946">Support for the UDP-Lite protocol
469           (RFC 3828) has been added to the IPv4 and IPv6
470           stacks.</para>
471
472         <para revision="267771">A bug in &man.sctp.4; that would allow
473           two listening sockets bound to the same port has been
474           fixed.</para>
475       </sect3>
476
477       <sect3 xml:id="disks">
478         <title>Disks and Storage</title>
479
480         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
481           &man.geom.4; got I/O direct dispatch support.
482           When safety requirements are met, it allows to avoid passing
483           I/O requests to GEOM g_up/g_down thread, executing them directly
484           in the caller context. That allows to avoid CPU bottlenecks in
485           g_up/g_down threads, plus avoid several context switches per I/O.
486           </para>
487
488         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
489           &man.geom.4; RAID driver has been
490           updated to support unmapped I/O.</para>
491
492         <para revision="260387" contrib="sponsor" sponsor="&ix;">The
493           &man.cam.4; got finer-grained locking, direct dispatch and
494           multi-queue support.
495           Combined with &man.geom.4; direct dispatch that allows to
496           reduce lock congestion and improve SMP scalability of the
497           SCSI/ATA stack.
498           </para>
499
500         <para revision="260478">The &man.geom.8;
501           <literal>GEOM_MULTIPATH</literal> class got automatic live
502           resize support.</para>
503
504         <para revision="260857">The &man.virtio_blk.4; driver has been
505           updated to support unmapped I/O.</para>
506
507         <para revision="260858">The &man.virtio_scsi.4; driver has been
508           updated to support unmapped I/O.</para>
509
510         <para revision="264522">Support for LUN-based CD changers has
511           been removed from the &man.cd.4; driver.</para>
512
513         <para revision="264734">Support for 9th generation HP host bus
514           adapter cards has been added to &man.ciss.4;.</para>
515
516         <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
517           &man.mpr.4; device has been added,
518           providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
519           controllers.</para>
520
521         <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
522           &man.mrsas.4; driver has been added,
523           providing support for LSI MegaRAID SAS controllers.  The
524           &man.mfi.4; driver will attach to the controller, by default.
525           To enable &man.mrsas.4; add
526           <literal>hw.mfi.mrsas_enable=1</literal> to
527           <filename>/boot/loader.conf</filename>, which turns off
528           &man.mfi.4; device probing.</para>
529
530         <note>
531           <para>At this time, the &man.mfiutil.8; utility and
532             the &os; version of
533             <application>MegaCLI</application> and
534             <application>StorCli</application> do not work with
535             &man.mrsas.4;.</para>
536         </note>
537
538         <para revision="266608">Fixed accounting of BIO_FLUSH operation
539           in &man.geom.8; <literal>GEOM_DISK</literal> class</para>
540
541         <para revision="266610">The &man.gstat.8;
542           utility now has a <literal>-o</literal> option, to
543           display "other" operatins (e.g. BIO_FLUSH).</para>
544
545         <para revision="267084">The &man.mfi.4; driver has been
546           updated to include support for unmapped I/O.</para>
547
548         <para revision="267457">The &man.hpt27xx.4; driver has been
549           updated with various vendor-supplied bug fixes.</para>
550
551         <para revision="270130" contrib="sponsor"
552           sponsor="&citrix.rd;">Support for unmapped I/O has been added
553           to the &man.xen.4; <literal>blkfront</literal> driver.</para>
554
555         <para revision="259328" contrib="sponsor" sponsor="&ff;">The
556           &man.geom.8; <literal>label</literal> class is now aware of
557           resized partitions.  This corrects an issue where
558           <command>geom resize</command> would resize the partition,
559           but the label provider in <filename
560             class="directory">/dev/gptid/</filename> would not be
561           resized.</para>
562
563         <para revision="260502">The &man.gmirror.8;
564           utility now has a <literal>resize</literal> command, making
565           it easier to resize the size of a mirror when all of its
566           components have been replaced.</para>
567
568         <para revision="262967">Support for MegaRAID Fury cards has been
569           added to the &man.mfi.4; driver.</para>
570
571         <para revision="263024">The &man.aacraid.4; driver has been
572           updated to version 3.2.5.</para>
573
574         <para revision="265536">The <literal>GEOM_VINUM</literal> option
575           is now able to be built both directly into the kernel or as
576           a &man.kldload.8; loadable module.</para>
577
578         <para revision="265912">The &man.geom.8;
579           <literal>GEOM_PART</literal> class has been updated to
580           support automatic partition resizing.  Changes to the
581           partition size are not saved to disk until
582           <command>gpart commit</command> is run, and prior to saving,
583           can be reverted with <command>gpart undo</command>.</para>
584
585         <para revision="266220">The &man.geom.uncompress.4; module is
586           built by default which, similar to &man.geom.uzip.4;,
587           provides support for compressed, read-only disk
588           images.</para>
589
590         <para revision="268091">Support for the
591           <literal>disklabel64</literal> partitioning scheme has been
592           added to &man.gpart.8;.</para>
593
594         <para revision="270552">A new &man.sysctl.8; and
595           &man.loader.8; tunable,
596           <literal>kern.geom.part.mbr.enforce_chs</literal> has been
597           added to the &man.geom.8; <literal>MBR</literal> partition
598           class.  When set to a non-zero value,
599           <literal>GEOM_PART_MBR</literal> will automatically
600           recalculate the user-specified offset and size for alignment
601           with the disk geometry.</para>
602
603         <para contrib="sponsor" sponsor="&ix;">CAM Target Layer (CTL)
604          got many impromenets:</para>
605         <itemizedlist>
606           <listitem>
607             <para>Support for UNMAP, WRITE SAME, COMPARE AND WRITE, XCOPY
608                 and some other SCSI commands was added to support VMWare VAAI
609                 and Microsoft ODX storage acceleration.</para>
610           </listitem>
611           <listitem>
612             <para revision="265642">READ/WRITE size limitations were removed
613                 by supporting multiple data moves per command.</para>
614           </listitem>
615           <listitem>
616             <para revision="268556">Finer-grained per-LUN locking and
617                 multiple worker threads for better SMP scapability.</para>
618           </listitem>
619           <listitem>
620             <para revision="269297">Memory consumption reduced by several
621                 times by disabling some never used functionality.</para>
622           </listitem>
623           <listitem>
624             <para revision="269298">The maximum number of
625                 <acronym>SCSI</acronym> ports increased from 32 to 128</para>
626           </listitem>
627           <listitem>
628             <para revision="269429">Improved ZVOL integration for better
629                 performance.</para>
630           </listitem>
631         </itemizedlist>
632       </sect3>
633
634       <sect3 xml:id="fs">
635         <title>File Systems</title>
636
637         <para revision="260338">The
638           <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been
639           re-enabled.  On multi-CPU machines with enough RAM, this can
640           easily double &man.zfs.8; performance or reduce CPU usage in
641           half.  It was originally disabled due to memory and
642           <acronym>KVA</acronym> exhaustion problem reports, which
643           should be resolved due to several change in the VM
644           subsystem.</para>
645
646         <para revision="260178" contrib="vendor"
647           vendor="&netflix;">A new flag, <literal>-R</literal>,
648           has been added to the &man.fsck.ffs.8; utility.  When used,
649           &man.fsck.ffs.8; will restart itself when too many critical
650           errors have been detected.</para>
651
652         <para revision="263407">The &man.zfs.8; filesystem has been
653           updated to implement <quote>bookmarks</quote>.  See
654           &man.zfs.8; for further details.</para>
655
656         <para revision="266122">The &man.zfs.8; filesystem has been
657           updated to allow tuning the minimum <quote>ashift</quote>
658           value when creating new top-level virtual devices (vdevs).
659           To set the minimum ashift value, for example when creating
660           a &man.zpool.8; on <quote>Advanced Format</quote> drives,
661           set the <literal>vfs.zfs.min_auto_ashift</literal>
662           &man.sysctl.8; accordingly.</para>
663
664         <para revision="266612">The <literal>libzfs</literal> thread
665           pool <acronym>API</acronym> has been imported from
666           OpenSolaris, and adapted for &os;.  This change allows
667           parallel disk scanning, which can reduce &man.zpool.8;
668           overall import time in some workloads.</para>
669
670         <para revision="269651">The &man.restore.8; utility has been
671           updated to prevent assertion failures when restoring
672           a <acronym>UFS</acronym> filesystem dump to
673           a <acronym>ZFS</acronym> filesystem by writing restored
674           files in block sizes that are a multiple of 1024.</para>
675
676         <para revision="269774">Two &man.sysctl.8;s have been added
677           to the &man.zfs.8; filesystem:</para>
678
679         <itemizedlist>
680           <listitem>
681             <para>
682               <literal>vfs.zfs.mg_fragmentation_threshold</literal>:&nbsp;The
683               percentage of the metaslab group size that should be
684               considered eligible for allocation, unless all metaslab
685               groups within the metaslab class have also crossed this
686               threshold.</para>
687           </listitem>
688
689           <listitem>
690             <para>
691               <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>:&nbsp;The
692               maximum percentage of metaslab fragmentation level to
693               keep their active state</para>
694           </listitem>
695         </itemizedlist>
696
697         <para revision="269846">The default &man.zfs.8;
698           <acronym>ARC</acronym> hash table size has been increased,
699           and a new &man.loader.8; tunable,
700           <literal>vfs.zfs.arc_average_blocksize</literal>, has been
701           added.  Previously, the hash table could be too small, which
702           would lead to long hash chains and limit performance for
703           cached reads.  The
704           <literal>vfs.zfs.arc_average_blocksize</literal> tunable
705           allows overriding the default block size.  The previous
706           default was 65536, and default of the new &man.loader.8;
707           tunable is 8192.</para>
708
709         <para revision="270157">The Fast File System
710           (<acronym>FFS</acronym>) has been updated to support
711           multi-threaded soft updates.  Previously, soft updates were
712           handled by a single thread, and as of this change, now have
713           one thread per <acronym>FFS</acronym> mountpoint.</para>
714       </sect3>
715     </sect2>
716
717     <sect2 xml:id="userland">
718       <title>Userland Changes</title>
719
720       <para revision="260177" contrib="sponsor"
721         sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
722         <literal>-b</literal>, which outputs the existing buses and
723         their parents.</para>
724
725       <para revision="262075">The &man.newsyslog.8; utility has been
726         updated to rotate files based on the actual file size instead
727         of the blocks on disk.  This matches the behavior documented
728         in &man.newsyslog.conf.5;.</para>
729
730       <para revision="262384">The location of the &man.rctl.8;
731         configuration file can now be overridden in &man.rc.conf.5;.
732         To use a non-default location, set
733         <literal>rctl_rules</literal> in &man.rc.conf.5; to the
734         location of the file.</para>
735
736       <para revision="262855">The <application>ATF</application> test
737         suite has been updated to version 0.20.</para>
738
739       <para revision="263019">The <literal>libucl</literal> library
740         (Unified Configuration Library) has been merged from
741         &os;-CURRENT.</para>
742
743       <para revision="263020">The &man.pkg.7; bootstrapping utility
744         has been synced with the version in &os;-CURRENT.</para>
745
746       <para revision="263403">The &man.zfs.8; userland utility has
747         been updated to include aliases for
748         <command>snapshot</command>, which allows use of <command>zfs
749           list -t snap</command> and <command>zfs
750           snap</command>.</para>
751
752       <para revision="263405">The &man.zfs.8; userland utility has
753         been updated to include a new flag to <command>zfs
754           list</command>, <literal>-p</literal>, which when specified,
755         prints the output in a parsable format.</para>
756
757       <para revision="263783">The Blowfish password format
758         implementation updated.  Support for &dollar;2b&dollar; has
759         been added, allowing use of passwords greater than 256
760         characters long.</para>
761
762       <para revision="264497">The &man.iconv.3; library has been
763         updated to match NetBSD, providing several bug fixes.</para>
764
765       <para revision="265265">The &man.date.1; utility has been
766         updated to include a new flag, <literal>-R</literal>, which
767         prints the date and time output as specified in RFC
768         2822.</para>
769
770       <para revision="265533">The &man.bc.1; utility has been updated
771         to version 1.1, in sync with the version in OpenBSD.</para>
772
773       <para revision="265604" contrib="vendor"
774         vendor="&netflix;">The &man.pmcstat.8; utility has been
775         updated to include a new flag, <literal>-a</literal>, which
776         when specified, produces a full stack track on the sampled
777         points.</para>
778
779       <para revision="265701">The &man.netstat.8; and &man.route.8;
780         utilities have been updated to include a shorthand equivalent
781         to the <literal>-f inet</literal> and <literal>-f
782           inet6</literal> address specifiers, <literal>-4</literal>
783         and <literal>-6</literal>, respectively.</para>
784
785       <para revision="265879">The &man.crypt.3; library now defaults
786         to SHA512 for password hashing.</para>
787
788       <para revision="266014">The &man.gvinum.8; utility has been
789         updated to allow forceful configuration reset with the
790         <literal>-f</literal> flag.  Additionally, a bug that would
791         prevent <literal>-f</literal> from properly creating
792         a &man.gvinum.8; configuration has been fixed.</para>
793
794       <para revision="266029">The &man.login.conf.5; file now takes
795         precedence over the shell-specific environment files.  In
796         particular, the <literal>PATH</literal>,
797         <literal>BLOCKSIZE</literal> variables are commented from
798         <filename>/usr/share/skel/dot.profile</filename>, and the
799         <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
800         <literal>umask</literal> variables have been commented from
801         <filename>/usr/share/skel/dot.cshrc</filename>.</para>
802
803       <para revision="266272">The &man.binmiscctl.8; userland utility
804         and related image activator features have been merged from
805         &os;-CURRENT.</para>
806
807       <para revision="266279">The &man.ps.1; utility has been
808         updated to include the <literal>-J</literal> flag, used to
809         filter output by matching &man.jail.8; IDs and names.
810         Additionally, argument <literal>0</literal> can be used to
811         <literal>-J</literal> to only list processes running on the
812         host system.</para>
813
814       <para revision="266280">The &man.top.1; utility has been updated
815         to filter by &man.jail.8; ID or name, in followup to the
816         &man.ps.1; change in <literal>r265229</literal>.</para>
817
818       <para revision="266610">The &man.gstat.8; utility has been
819         updated to include a new flag, <literal>-o</literal>.  When
820         set, &man.gstat.8; will display statistics for operations
821         such as <literal>BIO_FLUSH</literal>.</para>
822
823       <para revision="266632">The &man.fetch.3; library has been
824         updated to look for root <acronym>SSL</acronym> certificates
825         in <filename class="directory">/usr/local/etc/ssl/</filename>
826         before <filename
827           class="directory">/etc/ssl/</filename>.</para>
828
829       <para revision="266715">The &man.clang.1;/llvm suite has been
830         updated to version 3.4.1.</para>
831
832       <para revision="266816">The Blowfish password format
833         has been changed to &dollar;2b&dollar; by default.</para>
834
835       <para revision="266888">The amount of data collected for
836         &man.hwpmc.4; has been updated to work with modern processors
837         and larger amounts of available memory.</para>
838
839       <para revision="266890">The &man.pmcstat.8; utility has been
840         updated to include a new flag, <literal>-l</literal>, which
841         ends event collection after the specified number of
842         seconds.</para>
843
844       <para revision="266953">The &man.mergemaster.8; utility has
845         been updated to avoid printing
846         <quote><filename>/var/tmp/temproot</filename>
847           disappeared</quote> if there is nothing to compare.</para>
848
849       <para revision="267056">The &os; installer, &man.bsdinstall.8;,
850         has been updated to include optional
851         &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
852         devices when installing onto a full &man.zfs.8; filesystem.
853         Additionally, the parent &man.zfs.8; dataset is now configured
854         with <literal>lz4</literal> compression enabled.</para>
855
856       <para revision="267113">The default &man.newsyslog.conf.5; now
857         includes files in the
858         <filename>/etc/newsyslog.conf.d/</filename> and
859         <filename>/usr/local/etc/newsyslog.conf.d/</filename>
860         directories by default for &man.newsyslog.8;.</para>
861
862       <para revision="267161">The &man.realpath.1; utility has been
863         updated to return <literal>ENOTDIR</literal> on paths
864         components <quote>.</quote> and <quote>..</quote> that are
865         not directories, such as <filename
866           class="directory">/dev/null/.</filename> or <filename
867           class="directory">/dev/null/..</filename>.</para>
868
869       <para revision="267236">A new flag, <quote>onifconsole</quote>
870         has been added to <filename>/etc/ttys</filename>.  This allows
871         the system to provide a login prompt via serial console if the
872         device is an active kernel console, otherwise it is equivalent
873         to <literal>off</literal>.</para>
874
875       <para revision="267341">Support for legacy
876         <acronym>PCI</acronym> devices has been removed from
877         &man.bhyve.8;.</para>
878
879       <para revision="267450">The &man.bhyve.8; userland utility
880         has been updated to include SMBIOS support.  A new flag has
881         been added, <literal>-U</literal>, which allows specifying the
882         UUID of the guest in the System Information structure.</para>
883
884       <para revision="267734">The &os;&nbsp;Project has migrated
885         from the <application>GNATS</application> bug tracking system
886         to <application>Bugzilla</application>.  The &man.send-pr.1;
887         utility used for submitting problem reports has been replaced
888         with a stub shell script that instructs to use the Bugzilla
889         web interface.</para>
890
891       <para revision="267747">The &man.patch.1; utility has been
892         updated to include a <literal>--dry-run</literal> flag, which
893         is equivalent to <literal>--check</literal> and
894         <literal>-C</literal>.</para>
895
896       <para revision="267878">A bug in &man.bsdgrep.1; that would
897         prevent patterns from being matched under certain conditions
898         has been fixed.</para>
899
900       <para revision="267979">The &man.procstat.1; utility has been
901         updated to include two new flags, <literal>-r</literal> and
902         <literal>-H</literal>.  When <literal>-r</literal> is
903         specified, &man.procstat.1; will print current resource usage
904         about the process(es).  When <literal>-H</literal> is
905         specified, &man.procstat.1; will print information about
906         threads rather than the process(es).</para>
907
908       <note>
909         <para>The <literal>-H</literal> flag is currently only used
910           with <literal>-r</literal> to display resource usage for
911           individual threads, rather than the entire process.</para>
912       </note>
913
914       <para revision="268019">The &man.sed.1; utility has been
915         updated to include a new flag, <literal>-u</literal>, which
916         enables unbuffered output when specified.</para>
917
918       <para revision="268161">The &man.mkimg.1; utility has been
919         merged from &os;-CURRENT.</para>
920
921       <para revision="268700" contrib="sponsor"
922         sponsor="&spectralogic;">The &man.camcontrol.8; has been
923         updated to include a new <literal>persist</literal> command,
924         which allows issuing <command>SCSI PERSISTENT RESERVE
925           IN</command> and <command>SCSI PERSISTENT RESERVE
926           OUT</command>.</para>
927
928       <para revision="268791">The &man.gstat.8; utility has been
929         updated to include a new flag, <literal>-p</literal>, which
930         displays only physical providers when specified.</para>
931
932       <para revision="268903">The &man.kldstat.8; utility has been
933         updated to allow <literal>-q</literal> to be specified when
934         also specifying <literal>-n
935           <replaceable>module.ko</replaceable></literal>.</para>
936
937       <para revision="269177">The &man.mkimg.1; utility has been
938         updated to include support for both fixed- and
939         dynamically-allocated images for the <acronym>VHD</acronym>
940         and <acronym>VMDK</acronym> formats.</para>
941
942       <para revision="269220">The &man.random.4; entropy collection
943         script, <filename>/usr/libexec/save-entropy</filename>, no
944         longer runs within &man.jail.8; environments.</para>
945
946       <para revision="269397">The &man.bhyve.8; wrapper script,
947         <filename>/usr/share/examples/bhyve/vmrun.sh</filename>,
948         has been synced with &os;-CURRENT.</para>
949
950       <para>This update includes:</para>
951
952       <itemizedlist>
953         <listitem>
954           <para>A new flag, <literal>-e</literal>, has been added,
955             which is used to set &man.loader.8; environment
956             variables.</para>
957         </listitem>
958
959         <listitem>
960           <para>A new flag, <literal>-C</literal>, has been added,
961             which is used to specify the guest console device.</para>
962         </listitem>
963
964         <listitem>
965           <para>A new flag, <literal>-H</literal>, has been added,
966             which is used to pass the host path to
967             &man.bhyveload.8;.</para>
968         </listitem>
969
970         <listitem>
971           <para>Support for multiple disk and &man.tap.4; devices
972             has been added.</para>
973         </listitem>
974
975         <listitem>
976           <para>The <literal>-I</literal> flag has been
977             removed.</para>
978         </listitem>
979       </itemizedlist>
980
981       <para revision="269398">The &man.nfsd.8; server update to 4.1,
982         adding support for RFC5661, has merged from
983         &os;-CURRENT.</para>
984
985       <para revision="269432" arch="ia64">The serial terminals
986         <filename>ttyu0</filename> and <filename>ttyu1</filename> have
987         been updated to <literal>onifconsole</literal> by default in
988         &man.ttys.5;, which either can be the serial console,
989         depending on the platform.</para>
990
991       <para revision="269800">The &man.ping6.8; utility has been
992         updated to reset <literal>itimer</literal> when the maximum
993         number of packets to send have been reached.  This prevents
994         &man.ping6.8; from exiting when the interval in set to a small
995         value and a low number of packets to send has been
996         specified.</para>
997
998       <para revision="269805">The &man.jail.8; utility has been
999         updated to support extra &man.ifconfig.8; arguments for the
1000         <literal>ip4.addr</literal> and <literal>ip6.addr</literal>
1001         parameters.  This change allows &man.carp.4; interfaces to
1002         be used within the &man.jail.8;.</para>
1003
1004       <para revision="269946">Support for generating and compiling
1005         <acronym>USDT</acronym> <application>DTrace</application>
1006         probes has been improved.  <application>DTrace</application>
1007         <acronym>USDT</acronym> files are now handled similar to
1008         &man.lex.1; and &man.yacc.1; files, meaning support for
1009         handling <application>D</application> files as part of the
1010         build process is built into the <literal>SRCS</literal>
1011         &man.make.1; environment variable.</para>
1012
1013       <para revision="269968">The &man.iscsictl.8; utility has been
1014         updated to include a new flag, <literal>-M</literal>, which
1015         allows modifying the <acronym>iSCSI</acronym> session
1016         parameters without requiring the session to be removed and
1017         added back.</para>
1018
1019       <para revision="270043">The &man.mount.nfs.8; utility has been
1020         updated to support specifying the NFS version as
1021         a <literal>key=<replaceable>value</replaceable></literal> pair
1022         argument to the <literal>-o</literal> flag.  For example, to
1023         specify NFS version 4, the syntax to use is
1024         <literal>-o&nbsp;vers=4</literal>.</para>
1025
1026       <para revision="270242" contrib="sponsor"
1027         sponsor="&spectralogic;">The &man.devd.8; client socket type
1028         has been changed to <literal>SOCK_SEQPACKET</literal>,
1029         providing sequential packet support.</para>
1030
1031       <para revision="270401">Support for the <quote>account</quote>
1032         facility has been added to the &man.pam.group.8;
1033         module.</para>
1034
1035       <sect3 xml:id="rc-scripts">
1036         <title><filename>/etc/rc.d</filename> Scripts</title>
1037
1038         <para revision="264438">The <filename>network.subr</filename>
1039           &man.rc.8; script has been updated to loosen the requirement
1040           of listing network aliases in numeric order.  Previously,
1041           a network alias of
1042           <literal>_alias<replaceable>2</replaceable></literal>
1043           would not be created if
1044           <literal>_alias<replaceable>1</replaceable></literal> was
1045           not defined.</para>
1046
1047         <para revision="268098">The &man.service.8; utility has been
1048           updated to check that the &man.rc.d.8; directory exists
1049           before traversing the directory.</para>
1050       </sect3>
1051     </sect2>
1052
1053     <sect2 xml:id="contrib">
1054       <title>Contributed Software</title>
1055
1056       <para revision="263285">The &man.xz.1; utility has been updated
1057         to a post-5.0.5 snapshot.</para>
1058
1059       <para revision="264377"><application>OpenSSH</application> has
1060         been updated to version 6.6p1.</para>
1061
1062       <para revision="264911">The &man.nc.1; utility has been updated
1063         to match the version in OpenBSD 5.5.</para>
1064
1065       <para revision="266692"><application>Sendmail</application>
1066         has been updated to 8.14.9.</para>
1067
1068       <para revision="267477">The timezone database has been updated
1069         to version tzdata2014e.</para>
1070
1071       <para revision="268515">The &man.file.1; utility and
1072         &man.libmagic.3; library have been updated to 5.19.</para>
1073
1074       <para revision="268899">The &man.byacc.1; parser has been
1075         updated to version 20140422.</para>
1076
1077       <para revision="269024" contrib="sponsor"
1078         sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
1079         been updated to the r202189 snapshot.</para>
1080
1081       <para revision="269257">The &man.unbound.8; caching resolver and
1082         <literal>ldns</literal> have been updated to version
1083         1.4.22.</para>
1084
1085       <para revision="269686"><application>OpenSSL</application> has
1086         been updated to version 1.0.1i.</para>
1087
1088       <para revision="269847">The <quote>lite</quote> version of
1089         <application>Subversion</application> included in the
1090         &os;&nbsp;base system and its dependencies have been
1091         updated:</para>
1092
1093       <itemizedlist>
1094         <listitem>
1095           <para><application>apr</application> has been
1096             updated to version 1.5.1.</para>
1097         </listitem>
1098
1099         <listitem>
1100           <para><application>apr-util</application> has been
1101             updated to version 1.5.3.</para>
1102         </listitem>
1103
1104         <listitem>
1105           <para><application>serf</application> has been
1106             updated to version 1.3.7.</para>
1107         </listitem>
1108
1109         <listitem>
1110           <para><application>svnlite</application> has been
1111             updated to version 1.8.10.</para>
1112         </listitem>
1113       </itemizedlist>
1114
1115       <para revision="270026">The &man.nvi.1; editor has been
1116         update to version 2.1.2-c80f493b038.</para>
1117
1118       <para revision="270031">The &man.fparseln.3; library has
1119         been updated to version 1.7.</para>
1120
1121       <para revision="270415">The <application>lukemftpd</application>
1122         <acronym>FTP</acronym> server has been removed from the
1123         &os;&nbsp;base system.</para>
1124     </sect2>
1125
1126     <sect2 xml:id="ports">
1127       <title>Ports/Packages Collection Infrastructure</title>
1128
1129       <para>&nbsp;</para>
1130
1131     </sect2>
1132
1133     <sect2 xml:id="releng">
1134       <title>Release Engineering and Integration</title>
1135
1136       <para revision="263028">The &man.services.mkdb.8; utility has
1137         been updated to include endianness awareness, allowing the
1138         <filename>services.db</filename> database to be created as
1139         part of the release build, regardless of native- or
1140         cross-built releases.</para>
1141     </sect2>
1142
1143     <sect2 xml:id="doc">
1144       <title>Documentation</title>
1145
1146       <para>&nbsp;</para>
1147
1148     </sect2>
1149   </sect1>
1150
1151   <sect1 xml:id="upgrade">
1152     <title>Upgrading from Previous Releases of &os;</title>
1153
1154     <para arch="amd64,i386">Binary upgrades between RELEASE versions
1155       (and snapshots of the various security branches) are supported
1156       using the &man.freebsd-update.8; utility.  The binary upgrade
1157       procedure will update unmodified userland utilities, as well as
1158       unmodified GENERIC or SMP kernels distributed as a part of an
1159       official &os; release.  The &man.freebsd-update.8; utility
1160       requires that the host being upgraded have Internet
1161       connectivity.</para>
1162
1163     <para>Source-based upgrades (those based on recompiling the &os;
1164       base system from source code) from previous versions are
1165       supported, according to the instructions in
1166       <filename>/usr/src/UPDATING</filename>.</para>
1167
1168     <important>
1169       <para>Upgrading &os; should only be attempted after
1170         backing up <emphasis>all</emphasis> data and configuration
1171         files.</para>
1172     </important>
1173   </sect1>
1174 </article>