]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - release/doc/en_US.ISO8859-1/relnotes/article.xml
Mention NFS and kernel iSCSI optimizations.
[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
476         <para contrib="sponsor" sponsor="&ix;">Kernel RPC code, which is a
477           base of NFS server took multiple optimizations, that significantly
478           improved its performance and SMP scapability.</para>
479
480         <para>New kernel-based iSCSI target and initiator code took many
481           fixes and performance optimizations.</para>
482       </sect3>
483
484       <sect3 xml:id="disks">
485         <title>Disks and Storage</title>
486
487         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
488           &man.geom.4; got I/O direct dispatch support.
489           When safety requirements are met, it allows to avoid passing
490           I/O requests to GEOM g_up/g_down thread, executing them directly
491           in the caller context. That allows to avoid CPU bottlenecks in
492           g_up/g_down threads, plus avoid several context switches per I/O.
493           </para>
494
495         <para revision="260385" contrib="sponsor" sponsor="&ix;">The
496           &man.geom.4; RAID driver has been
497           updated to support unmapped I/O.</para>
498
499         <para revision="260387" contrib="sponsor" sponsor="&ix;">The
500           &man.cam.4; got finer-grained locking, direct dispatch and
501           multi-queue support.
502           Combined with &man.geom.4; direct dispatch that allows to
503           reduce lock congestion and improve SMP scalability of the
504           SCSI/ATA stack.
505           </para>
506
507         <para revision="260478">The &man.geom.8;
508           <literal>GEOM_MULTIPATH</literal> class got automatic live
509           resize support.</para>
510
511         <para revision="260857">The &man.virtio_blk.4; driver has been
512           updated to support unmapped I/O.</para>
513
514         <para revision="260858">The &man.virtio_scsi.4; driver has been
515           updated to support unmapped I/O.</para>
516
517         <para revision="264522">Support for LUN-based CD changers has
518           been removed from the &man.cd.4; driver.</para>
519
520         <para revision="264734">Support for 9th generation HP host bus
521           adapter cards has been added to &man.ciss.4;.</para>
522
523         <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
524           &man.mpr.4; device has been added,
525           providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
526           controllers.</para>
527
528         <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
529           &man.mrsas.4; driver has been added,
530           providing support for LSI MegaRAID SAS controllers.  The
531           &man.mfi.4; driver will attach to the controller, by default.
532           To enable &man.mrsas.4; add
533           <literal>hw.mfi.mrsas_enable=1</literal> to
534           <filename>/boot/loader.conf</filename>, which turns off
535           &man.mfi.4; device probing.</para>
536
537         <note>
538           <para>At this time, the &man.mfiutil.8; utility and
539             the &os; version of
540             <application>MegaCLI</application> and
541             <application>StorCli</application> do not work with
542             &man.mrsas.4;.</para>
543         </note>
544
545         <para revision="266608">Fixed accounting of BIO_FLUSH operation
546           in &man.geom.8; <literal>GEOM_DISK</literal> class</para>
547
548         <para revision="266610">The &man.gstat.8;
549           utility now has a <literal>-o</literal> option, to
550           display "other" operatins (e.g. BIO_FLUSH).</para>
551
552         <para revision="267084">The &man.mfi.4; driver has been
553           updated to include support for unmapped I/O.</para>
554
555         <para revision="267457">The &man.hpt27xx.4; driver has been
556           updated with various vendor-supplied bug fixes.</para>
557
558         <para revision="270130" contrib="sponsor"
559           sponsor="&citrix.rd;">Support for unmapped I/O has been added
560           to the &man.xen.4; <literal>blkfront</literal> driver.</para>
561
562         <para revision="259328" contrib="sponsor" sponsor="&ff;">The
563           &man.geom.8; <literal>label</literal> class is now aware of
564           resized partitions.  This corrects an issue where
565           <command>geom resize</command> would resize the partition,
566           but the label provider in <filename
567             class="directory">/dev/gptid/</filename> would not be
568           resized.</para>
569
570         <para revision="260502">The &man.gmirror.8;
571           utility now has a <literal>resize</literal> command, making
572           it easier to resize the size of a mirror when all of its
573           components have been replaced.</para>
574
575         <para revision="262967">Support for MegaRAID Fury cards has been
576           added to the &man.mfi.4; driver.</para>
577
578         <para revision="263024">The &man.aacraid.4; driver has been
579           updated to version 3.2.5.</para>
580
581         <para revision="265536">The <literal>GEOM_VINUM</literal> option
582           is now able to be built both directly into the kernel or as
583           a &man.kldload.8; loadable module.</para>
584
585         <para revision="265912">The &man.geom.8;
586           <literal>GEOM_PART</literal> class has been updated to
587           support automatic partition resizing.  Changes to the
588           partition size are not saved to disk until
589           <command>gpart commit</command> is run, and prior to saving,
590           can be reverted with <command>gpart undo</command>.</para>
591
592         <para revision="266220">The &man.geom.uncompress.4; module is
593           built by default which, similar to &man.geom.uzip.4;,
594           provides support for compressed, read-only disk
595           images.</para>
596
597         <para revision="268091">Support for the
598           <literal>disklabel64</literal> partitioning scheme has been
599           added to &man.gpart.8;.</para>
600
601         <para revision="270552">A new &man.sysctl.8; and
602           &man.loader.8; tunable,
603           <literal>kern.geom.part.mbr.enforce_chs</literal> has been
604           added to the &man.geom.8; <literal>MBR</literal> partition
605           class.  When set to a non-zero value,
606           <literal>GEOM_PART_MBR</literal> will automatically
607           recalculate the user-specified offset and size for alignment
608           with the disk geometry.</para>
609
610         <para contrib="sponsor" sponsor="&ix;">CAM Target Layer (CTL)
611          got many impromenets:</para>
612         <itemizedlist>
613           <listitem>
614             <para>Support for UNMAP, WRITE SAME, COMPARE AND WRITE, XCOPY
615                 and some other SCSI commands was added to support VMWare VAAI
616                 and Microsoft ODX storage acceleration.</para>
617           </listitem>
618           <listitem>
619             <para revision="265642">READ/WRITE size limitations were removed
620                 by supporting multiple data moves per command.</para>
621           </listitem>
622           <listitem>
623             <para revision="268556">Finer-grained per-LUN locking and
624                 multiple worker threads for better SMP scapability.</para>
625           </listitem>
626           <listitem>
627             <para revision="269297">Memory consumption reduced by several
628                 times by disabling some never used functionality.</para>
629           </listitem>
630           <listitem>
631             <para revision="269298">The maximum number of
632                 <acronym>SCSI</acronym> ports increased from 32 to 128</para>
633           </listitem>
634           <listitem>
635             <para revision="269429">Improved ZVOL integration for better
636                 performance.</para>
637           </listitem>
638         </itemizedlist>
639       </sect3>
640
641       <sect3 xml:id="fs">
642         <title>File Systems</title>
643
644         <para revision="260338">The
645           <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been
646           re-enabled.  On multi-CPU machines with enough RAM, this can
647           easily double &man.zfs.8; performance or reduce CPU usage in
648           half.  It was originally disabled due to memory and
649           <acronym>KVA</acronym> exhaustion problem reports, which
650           should be resolved due to several change in the VM
651           subsystem.</para>
652
653         <para revision="260178" contrib="vendor"
654           vendor="&netflix;">A new flag, <literal>-R</literal>,
655           has been added to the &man.fsck.ffs.8; utility.  When used,
656           &man.fsck.ffs.8; will restart itself when too many critical
657           errors have been detected.</para>
658
659         <para revision="263407">The &man.zfs.8; filesystem has been
660           updated to implement <quote>bookmarks</quote>.  See
661           &man.zfs.8; for further details.</para>
662
663         <para revision="266122">The &man.zfs.8; filesystem has been
664           updated to allow tuning the minimum <quote>ashift</quote>
665           value when creating new top-level virtual devices (vdevs).
666           To set the minimum ashift value, for example when creating
667           a &man.zpool.8; on <quote>Advanced Format</quote> drives,
668           set the <literal>vfs.zfs.min_auto_ashift</literal>
669           &man.sysctl.8; accordingly.</para>
670
671         <para revision="266612">The <literal>libzfs</literal> thread
672           pool <acronym>API</acronym> has been imported from
673           OpenSolaris, and adapted for &os;.  This change allows
674           parallel disk scanning, which can reduce &man.zpool.8;
675           overall import time in some workloads.</para>
676
677         <para revision="269651">The &man.restore.8; utility has been
678           updated to prevent assertion failures when restoring
679           a <acronym>UFS</acronym> filesystem dump to
680           a <acronym>ZFS</acronym> filesystem by writing restored
681           files in block sizes that are a multiple of 1024.</para>
682
683         <para revision="269774">Two &man.sysctl.8;s have been added
684           to the &man.zfs.8; filesystem:</para>
685
686         <itemizedlist>
687           <listitem>
688             <para>
689               <literal>vfs.zfs.mg_fragmentation_threshold</literal>:&nbsp;The
690               percentage of the metaslab group size that should be
691               considered eligible for allocation, unless all metaslab
692               groups within the metaslab class have also crossed this
693               threshold.</para>
694           </listitem>
695
696           <listitem>
697             <para>
698               <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>:&nbsp;The
699               maximum percentage of metaslab fragmentation level to
700               keep their active state</para>
701           </listitem>
702         </itemizedlist>
703
704         <para revision="269846">The default &man.zfs.8;
705           <acronym>ARC</acronym> hash table size has been increased,
706           and a new &man.loader.8; tunable,
707           <literal>vfs.zfs.arc_average_blocksize</literal>, has been
708           added.  Previously, the hash table could be too small, which
709           would lead to long hash chains and limit performance for
710           cached reads.  The
711           <literal>vfs.zfs.arc_average_blocksize</literal> tunable
712           allows overriding the default block size.  The previous
713           default was 65536, and default of the new &man.loader.8;
714           tunable is 8192.</para>
715
716         <para revision="270157">The Fast File System
717           (<acronym>FFS</acronym>) has been updated to support
718           multi-threaded soft updates.  Previously, soft updates were
719           handled by a single thread, and as of this change, now have
720           one thread per <acronym>FFS</acronym> mountpoint.</para>
721       </sect3>
722     </sect2>
723
724     <sect2 xml:id="userland">
725       <title>Userland Changes</title>
726
727       <para revision="260177" contrib="sponsor"
728         sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
729         <literal>-b</literal>, which outputs the existing buses and
730         their parents.</para>
731
732       <para revision="262075">The &man.newsyslog.8; utility has been
733         updated to rotate files based on the actual file size instead
734         of the blocks on disk.  This matches the behavior documented
735         in &man.newsyslog.conf.5;.</para>
736
737       <para revision="262384">The location of the &man.rctl.8;
738         configuration file can now be overridden in &man.rc.conf.5;.
739         To use a non-default location, set
740         <literal>rctl_rules</literal> in &man.rc.conf.5; to the
741         location of the file.</para>
742
743       <para revision="262855">The <application>ATF</application> test
744         suite has been updated to version 0.20.</para>
745
746       <para revision="263019">The <literal>libucl</literal> library
747         (Unified Configuration Library) has been merged from
748         &os;-CURRENT.</para>
749
750       <para revision="263020">The &man.pkg.7; bootstrapping utility
751         has been synced with the version in &os;-CURRENT.</para>
752
753       <para revision="263403">The &man.zfs.8; userland utility has
754         been updated to include aliases for
755         <command>snapshot</command>, which allows use of <command>zfs
756           list -t snap</command> and <command>zfs
757           snap</command>.</para>
758
759       <para revision="263405">The &man.zfs.8; userland utility has
760         been updated to include a new flag to <command>zfs
761           list</command>, <literal>-p</literal>, which when specified,
762         prints the output in a parsable format.</para>
763
764       <para revision="263783">The Blowfish password format
765         implementation updated.  Support for &dollar;2b&dollar; has
766         been added, allowing use of passwords greater than 256
767         characters long.</para>
768
769       <para revision="264497">The &man.iconv.3; library has been
770         updated to match NetBSD, providing several bug fixes.</para>
771
772       <para revision="265265">The &man.date.1; utility has been
773         updated to include a new flag, <literal>-R</literal>, which
774         prints the date and time output as specified in RFC
775         2822.</para>
776
777       <para revision="265533">The &man.bc.1; utility has been updated
778         to version 1.1, in sync with the version in OpenBSD.</para>
779
780       <para revision="265604" contrib="vendor"
781         vendor="&netflix;">The &man.pmcstat.8; utility has been
782         updated to include a new flag, <literal>-a</literal>, which
783         when specified, produces a full stack track on the sampled
784         points.</para>
785
786       <para revision="265701">The &man.netstat.8; and &man.route.8;
787         utilities have been updated to include a shorthand equivalent
788         to the <literal>-f inet</literal> and <literal>-f
789           inet6</literal> address specifiers, <literal>-4</literal>
790         and <literal>-6</literal>, respectively.</para>
791
792       <para revision="265879">The &man.crypt.3; library now defaults
793         to SHA512 for password hashing.</para>
794
795       <para revision="266014">The &man.gvinum.8; utility has been
796         updated to allow forceful configuration reset with the
797         <literal>-f</literal> flag.  Additionally, a bug that would
798         prevent <literal>-f</literal> from properly creating
799         a &man.gvinum.8; configuration has been fixed.</para>
800
801       <para revision="266029">The &man.login.conf.5; file now takes
802         precedence over the shell-specific environment files.  In
803         particular, the <literal>PATH</literal>,
804         <literal>BLOCKSIZE</literal> variables are commented from
805         <filename>/usr/share/skel/dot.profile</filename>, and the
806         <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
807         <literal>umask</literal> variables have been commented from
808         <filename>/usr/share/skel/dot.cshrc</filename>.</para>
809
810       <para revision="266272">The &man.binmiscctl.8; userland utility
811         and related image activator features have been merged from
812         &os;-CURRENT.</para>
813
814       <para revision="266279">The &man.ps.1; utility has been
815         updated to include the <literal>-J</literal> flag, used to
816         filter output by matching &man.jail.8; IDs and names.
817         Additionally, argument <literal>0</literal> can be used to
818         <literal>-J</literal> to only list processes running on the
819         host system.</para>
820
821       <para revision="266280">The &man.top.1; utility has been updated
822         to filter by &man.jail.8; ID or name, in followup to the
823         &man.ps.1; change in <literal>r265229</literal>.</para>
824
825       <para revision="266610">The &man.gstat.8; utility has been
826         updated to include a new flag, <literal>-o</literal>.  When
827         set, &man.gstat.8; will display statistics for operations
828         such as <literal>BIO_FLUSH</literal>.</para>
829
830       <para revision="266632">The &man.fetch.3; library has been
831         updated to look for root <acronym>SSL</acronym> certificates
832         in <filename class="directory">/usr/local/etc/ssl/</filename>
833         before <filename
834           class="directory">/etc/ssl/</filename>.</para>
835
836       <para revision="266715">The &man.clang.1;/llvm suite has been
837         updated to version 3.4.1.</para>
838
839       <para revision="266816">The Blowfish password format
840         has been changed to &dollar;2b&dollar; by default.</para>
841
842       <para revision="266888">The amount of data collected for
843         &man.hwpmc.4; has been updated to work with modern processors
844         and larger amounts of available memory.</para>
845
846       <para revision="266890">The &man.pmcstat.8; utility has been
847         updated to include a new flag, <literal>-l</literal>, which
848         ends event collection after the specified number of
849         seconds.</para>
850
851       <para revision="266953">The &man.mergemaster.8; utility has
852         been updated to avoid printing
853         <quote><filename>/var/tmp/temproot</filename>
854           disappeared</quote> if there is nothing to compare.</para>
855
856       <para revision="267056">The &os; installer, &man.bsdinstall.8;,
857         has been updated to include optional
858         &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
859         devices when installing onto a full &man.zfs.8; filesystem.
860         Additionally, the parent &man.zfs.8; dataset is now configured
861         with <literal>lz4</literal> compression enabled.</para>
862
863       <para revision="267113">The default &man.newsyslog.conf.5; now
864         includes files in the
865         <filename>/etc/newsyslog.conf.d/</filename> and
866         <filename>/usr/local/etc/newsyslog.conf.d/</filename>
867         directories by default for &man.newsyslog.8;.</para>
868
869       <para revision="267161">The &man.realpath.1; utility has been
870         updated to return <literal>ENOTDIR</literal> on paths
871         components <quote>.</quote> and <quote>..</quote> that are
872         not directories, such as <filename
873           class="directory">/dev/null/.</filename> or <filename
874           class="directory">/dev/null/..</filename>.</para>
875
876       <para revision="267236">A new flag, <quote>onifconsole</quote>
877         has been added to <filename>/etc/ttys</filename>.  This allows
878         the system to provide a login prompt via serial console if the
879         device is an active kernel console, otherwise it is equivalent
880         to <literal>off</literal>.</para>
881
882       <para revision="267341">Support for legacy
883         <acronym>PCI</acronym> devices has been removed from
884         &man.bhyve.8;.</para>
885
886       <para revision="267450">The &man.bhyve.8; userland utility
887         has been updated to include SMBIOS support.  A new flag has
888         been added, <literal>-U</literal>, which allows specifying the
889         UUID of the guest in the System Information structure.</para>
890
891       <para revision="267734">The &os;&nbsp;Project has migrated
892         from the <application>GNATS</application> bug tracking system
893         to <application>Bugzilla</application>.  The &man.send-pr.1;
894         utility used for submitting problem reports has been replaced
895         with a stub shell script that instructs to use the Bugzilla
896         web interface.</para>
897
898       <para revision="267747">The &man.patch.1; utility has been
899         updated to include a <literal>--dry-run</literal> flag, which
900         is equivalent to <literal>--check</literal> and
901         <literal>-C</literal>.</para>
902
903       <para revision="267878">A bug in &man.bsdgrep.1; that would
904         prevent patterns from being matched under certain conditions
905         has been fixed.</para>
906
907       <para revision="267979">The &man.procstat.1; utility has been
908         updated to include two new flags, <literal>-r</literal> and
909         <literal>-H</literal>.  When <literal>-r</literal> is
910         specified, &man.procstat.1; will print current resource usage
911         about the process(es).  When <literal>-H</literal> is
912         specified, &man.procstat.1; will print information about
913         threads rather than the process(es).</para>
914
915       <note>
916         <para>The <literal>-H</literal> flag is currently only used
917           with <literal>-r</literal> to display resource usage for
918           individual threads, rather than the entire process.</para>
919       </note>
920
921       <para revision="268019">The &man.sed.1; utility has been
922         updated to include a new flag, <literal>-u</literal>, which
923         enables unbuffered output when specified.</para>
924
925       <para revision="268161">The &man.mkimg.1; utility has been
926         merged from &os;-CURRENT.</para>
927
928       <para revision="268700" contrib="sponsor"
929         sponsor="&spectralogic;">The &man.camcontrol.8; has been
930         updated to include a new <literal>persist</literal> command,
931         which allows issuing <command>SCSI PERSISTENT RESERVE
932           IN</command> and <command>SCSI PERSISTENT RESERVE
933           OUT</command>.</para>
934
935       <para revision="268791">The &man.gstat.8; utility has been
936         updated to include a new flag, <literal>-p</literal>, which
937         displays only physical providers when specified.</para>
938
939       <para revision="268903">The &man.kldstat.8; utility has been
940         updated to allow <literal>-q</literal> to be specified when
941         also specifying <literal>-n
942           <replaceable>module.ko</replaceable></literal>.</para>
943
944       <para revision="269177">The &man.mkimg.1; utility has been
945         updated to include support for both fixed- and
946         dynamically-allocated images for the <acronym>VHD</acronym>
947         and <acronym>VMDK</acronym> formats.</para>
948
949       <para revision="269220">The &man.random.4; entropy collection
950         script, <filename>/usr/libexec/save-entropy</filename>, no
951         longer runs within &man.jail.8; environments.</para>
952
953       <para revision="269397">The &man.bhyve.8; wrapper script,
954         <filename>/usr/share/examples/bhyve/vmrun.sh</filename>,
955         has been synced with &os;-CURRENT.</para>
956
957       <para>This update includes:</para>
958
959       <itemizedlist>
960         <listitem>
961           <para>A new flag, <literal>-e</literal>, has been added,
962             which is used to set &man.loader.8; environment
963             variables.</para>
964         </listitem>
965
966         <listitem>
967           <para>A new flag, <literal>-C</literal>, has been added,
968             which is used to specify the guest console device.</para>
969         </listitem>
970
971         <listitem>
972           <para>A new flag, <literal>-H</literal>, has been added,
973             which is used to pass the host path to
974             &man.bhyveload.8;.</para>
975         </listitem>
976
977         <listitem>
978           <para>Support for multiple disk and &man.tap.4; devices
979             has been added.</para>
980         </listitem>
981
982         <listitem>
983           <para>The <literal>-I</literal> flag has been
984             removed.</para>
985         </listitem>
986       </itemizedlist>
987
988       <para revision="269398">The &man.nfsd.8; server update to 4.1,
989         adding support for RFC5661, has merged from
990         &os;-CURRENT.</para>
991
992       <para revision="269432" arch="ia64">The serial terminals
993         <filename>ttyu0</filename> and <filename>ttyu1</filename> have
994         been updated to <literal>onifconsole</literal> by default in
995         &man.ttys.5;, which either can be the serial console,
996         depending on the platform.</para>
997
998       <para revision="269800">The &man.ping6.8; utility has been
999         updated to reset <literal>itimer</literal> when the maximum
1000         number of packets to send have been reached.  This prevents
1001         &man.ping6.8; from exiting when the interval in set to a small
1002         value and a low number of packets to send has been
1003         specified.</para>
1004
1005       <para revision="269805">The &man.jail.8; utility has been
1006         updated to support extra &man.ifconfig.8; arguments for the
1007         <literal>ip4.addr</literal> and <literal>ip6.addr</literal>
1008         parameters.  This change allows &man.carp.4; interfaces to
1009         be used within the &man.jail.8;.</para>
1010
1011       <para revision="269946">Support for generating and compiling
1012         <acronym>USDT</acronym> <application>DTrace</application>
1013         probes has been improved.  <application>DTrace</application>
1014         <acronym>USDT</acronym> files are now handled similar to
1015         &man.lex.1; and &man.yacc.1; files, meaning support for
1016         handling <application>D</application> files as part of the
1017         build process is built into the <literal>SRCS</literal>
1018         &man.make.1; environment variable.</para>
1019
1020       <para revision="269968">The &man.iscsictl.8; utility has been
1021         updated to include a new flag, <literal>-M</literal>, which
1022         allows modifying the <acronym>iSCSI</acronym> session
1023         parameters without requiring the session to be removed and
1024         added back.</para>
1025
1026       <para revision="270043">The &man.mount.nfs.8; utility has been
1027         updated to support specifying the NFS version as
1028         a <literal>key=<replaceable>value</replaceable></literal> pair
1029         argument to the <literal>-o</literal> flag.  For example, to
1030         specify NFS version 4, the syntax to use is
1031         <literal>-o&nbsp;vers=4</literal>.</para>
1032
1033       <para revision="270242" contrib="sponsor"
1034         sponsor="&spectralogic;">The &man.devd.8; client socket type
1035         has been changed to <literal>SOCK_SEQPACKET</literal>,
1036         providing sequential packet support.</para>
1037
1038       <para revision="270401">Support for the <quote>account</quote>
1039         facility has been added to the &man.pam.group.8;
1040         module.</para>
1041
1042       <sect3 xml:id="rc-scripts">
1043         <title><filename>/etc/rc.d</filename> Scripts</title>
1044
1045         <para revision="264438">The <filename>network.subr</filename>
1046           &man.rc.8; script has been updated to loosen the requirement
1047           of listing network aliases in numeric order.  Previously,
1048           a network alias of
1049           <literal>_alias<replaceable>2</replaceable></literal>
1050           would not be created if
1051           <literal>_alias<replaceable>1</replaceable></literal> was
1052           not defined.</para>
1053
1054         <para revision="268098">The &man.service.8; utility has been
1055           updated to check that the &man.rc.d.8; directory exists
1056           before traversing the directory.</para>
1057       </sect3>
1058     </sect2>
1059
1060     <sect2 xml:id="contrib">
1061       <title>Contributed Software</title>
1062
1063       <para revision="263285">The &man.xz.1; utility has been updated
1064         to a post-5.0.5 snapshot.</para>
1065
1066       <para revision="264377"><application>OpenSSH</application> has
1067         been updated to version 6.6p1.</para>
1068
1069       <para revision="264911">The &man.nc.1; utility has been updated
1070         to match the version in OpenBSD 5.5.</para>
1071
1072       <para revision="266692"><application>Sendmail</application>
1073         has been updated to 8.14.9.</para>
1074
1075       <para revision="267477">The timezone database has been updated
1076         to version tzdata2014e.</para>
1077
1078       <para revision="268515">The &man.file.1; utility and
1079         &man.libmagic.3; library have been updated to 5.19.</para>
1080
1081       <para revision="268899">The &man.byacc.1; parser has been
1082         updated to version 20140422.</para>
1083
1084       <para revision="269024" contrib="sponsor"
1085         sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
1086         been updated to the r202189 snapshot.</para>
1087
1088       <para revision="269257">The &man.unbound.8; caching resolver and
1089         <literal>ldns</literal> have been updated to version
1090         1.4.22.</para>
1091
1092       <para revision="269686"><application>OpenSSL</application> has
1093         been updated to version 1.0.1i.</para>
1094
1095       <para revision="269847">The <quote>lite</quote> version of
1096         <application>Subversion</application> included in the
1097         &os;&nbsp;base system and its dependencies have been
1098         updated:</para>
1099
1100       <itemizedlist>
1101         <listitem>
1102           <para><application>apr</application> has been
1103             updated to version 1.5.1.</para>
1104         </listitem>
1105
1106         <listitem>
1107           <para><application>apr-util</application> has been
1108             updated to version 1.5.3.</para>
1109         </listitem>
1110
1111         <listitem>
1112           <para><application>serf</application> has been
1113             updated to version 1.3.7.</para>
1114         </listitem>
1115
1116         <listitem>
1117           <para><application>svnlite</application> has been
1118             updated to version 1.8.10.</para>
1119         </listitem>
1120       </itemizedlist>
1121
1122       <para revision="270026">The &man.nvi.1; editor has been
1123         update to version 2.1.2-c80f493b038.</para>
1124
1125       <para revision="270031">The &man.fparseln.3; library has
1126         been updated to version 1.7.</para>
1127
1128       <para revision="270415">The <application>lukemftpd</application>
1129         <acronym>FTP</acronym> server has been removed from the
1130         &os;&nbsp;base system.</para>
1131     </sect2>
1132
1133     <sect2 xml:id="ports">
1134       <title>Ports/Packages Collection Infrastructure</title>
1135
1136       <para>&nbsp;</para>
1137
1138     </sect2>
1139
1140     <sect2 xml:id="releng">
1141       <title>Release Engineering and Integration</title>
1142
1143       <para revision="263028">The &man.services.mkdb.8; utility has
1144         been updated to include endianness awareness, allowing the
1145         <filename>services.db</filename> database to be created as
1146         part of the release build, regardless of native- or
1147         cross-built releases.</para>
1148     </sect2>
1149
1150     <sect2 xml:id="doc">
1151       <title>Documentation</title>
1152
1153       <para>&nbsp;</para>
1154
1155     </sect2>
1156   </sect1>
1157
1158   <sect1 xml:id="upgrade">
1159     <title>Upgrading from Previous Releases of &os;</title>
1160
1161     <para arch="amd64,i386">Binary upgrades between RELEASE versions
1162       (and snapshots of the various security branches) are supported
1163       using the &man.freebsd-update.8; utility.  The binary upgrade
1164       procedure will update unmodified userland utilities, as well as
1165       unmodified GENERIC or SMP kernels distributed as a part of an
1166       official &os; release.  The &man.freebsd-update.8; utility
1167       requires that the host being upgraded have Internet
1168       connectivity.</para>
1169
1170     <para>Source-based upgrades (those based on recompiling the &os;
1171       base system from source code) from previous versions are
1172       supported, according to the instructions in
1173       <filename>/usr/src/UPDATING</filename>.</para>
1174
1175     <important>
1176       <para>Upgrading &os; should only be attempted after
1177         backing up <emphasis>all</emphasis> data and configuration
1178         files.</para>
1179     </important>
1180   </sect1>
1181 </article>