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