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