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">
6 <!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
8 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
11 <article xmlns="http://docbook.org/ns/docbook"
12 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
15 <title>&os; &release.current; Release Notes</title>
18 <orgname>The &os; Project</orgname>
21 <pubdate>$FreeBSD$</pubdate>
39 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
43 <legalnotice xml:id="trademarks" role="trademarks">
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
63 <sect1 xml:id="intro">
64 <title>Introduction</title>
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>
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
77 xlink:href="&release.url;">&release.url;</uri>.</para>
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
85 xlink:href="&release.url;">&release.url;</uri>.</para>
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
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>
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>
108 <title>What's New</title>
110 <para>This section describes the most user-visible new or changed
111 features in &os; since &release.prev;.</para>
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
123 <sect2 xml:id="security">
124 <title>Security Advisories</title>
130 <sect2 xml:id="kernel">
131 <title>Kernel Changes</title>
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
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>
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>
151 <para revision="260857">The &man.virtio_blk.4; driver has been
152 updated to support unmapped I/O.</para>
154 <para revision="260858">The &man.virtio_scsi.4; driver has been
155 updated to support unmapped I/O.</para>
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>
163 <para revision="262967">Support for MegaRAID Fury cards has been
164 added to the &man.mfi.4; driver.</para>
166 <para revision="263024">The &man.aacraid.4; driver has been
167 updated to version 3.2.5.</para>
169 <para revision="263122">Support for &man.hwpmc.4; has been added
170 for &powerpc; 970 class processors.</para>
172 <para revision="263197">Support for ADT7460 and ADT7467 fan
173 controllers found in newer PowerBooks™ and
174 iBooks™ has been added to the &man.iicbus.4;
177 <para revision="263256">A panic triggered by removing
178 a &man.urtwn.4; device has been fixed.</para>
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>
184 <para revision="263869">Support for &amd; Family 16h sensor
185 devices has been added to &man.amdtemp.4;.</para>
187 <para revision="264522">Support for LUN-based CD changers has
188 been removed from the &man.cd.4; driver.</para>
190 <para revision="264734">Support for 9th generation HP host bus
191 adapter cards has been added to &man.ciss.4;.</para>
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
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>
202 <para revision="265610">The &man.uslcom.4; driver has been
203 updated to support 26 new devices.</para>
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>
215 <para>At this time, the &man.mfiutil.8; utility and
217 <application>MegaCLI</application> and
218 <application>StorCli</application> do not work with
219 &man.mrsas.4;.</para>
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 ™ enabled has been fixed.</para>
227 <sect3 xml:id="kernel-virtualization">
228 <title>Virtualization Support</title>
230 <para revision="259450">Support for µsoft; Hyper-V
231 has been added to &os;/i386 as loadable modules, however
232 not available in the <filename>GENERIC</filename> kernel
233 configuration.</para>
235 <para revision="261090">The &man.bhyve.4; hypervisor now
236 supports soft power-off functionality via the ACPI S5
240 <sect3 xml:id="kernel-arm">
241 <title>ARM Support</title>
243 <para revision="259355">The <filename>WANDBOARD</filename>
244 kernel configuration file has been added.</para>
246 <para revision="265067">Boot devices may now be specified by
247 setting a u-boot environment variable. If a boot device is
248 not specified, the probe mechanism will be used. To specify
249 the boot device, set the
250 <literal>loaderdev=<replaceable>device</replaceable></literal>
251 u-boot environment variable.</para>
254 <sect3 xml:id="boot">
255 <title>Boot Loader Changes</title>
257 <para revision="262701">A kernel selection menu has been added
258 to &man.loader.8;. If the <quote>beastie menu</quote> is
259 enabled, the kernel to boot may be selected from the kernel
260 selection menu. Additional kernels may be listed in
261 &man.loader.conf.5; as a comma- or space-separated list. By
262 default, <literal>kernel</literal> and
263 <literal>kernel.old</literal> are listed.</para>
266 <sect3 xml:id="proc">
267 <title>Hardware Support</title>
272 <title>Multimedia Support</title>
278 <sect4 xml:id="net-if">
279 <title>Network Interface Support</title>
281 <para revision="259453">Support for Ralink RT5370 and
282 RT5372 chipsets has been added to the &man.run.4;
285 <para revision="260120">Firmware for the &man.run.4; driver
286 has been updated to version 0.33.</para>
288 <para revision="261868">Support for the Ralink RT3593
289 chipset has been added to the &man.run.4; driver.</para>
291 <para revision="261972">The &man.nve.4; driver is now
292 deprecated, and the &man.nfe.4; driver should be used
295 <para revision="262137">Support for the &man.axge.4; driver
296 has been added. This driver supports the ASIX AX88178A
297 and AX88179 USB ethernet adapters. The AX88178A supports
298 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
300 <para revision="262363">The &man.urndis.4; driver has been
301 imported from OpenBSD.</para>
303 <para revision="264866">Support for multiple
304 transmitter/receiver queues has been added to the
305 &man.vmx.4; driver.</para>
308 <para>The &os; guest operating system must have
309 <acronym>MSIX</acronym> enabled as a prerequisite for
310 multiple queues.</para>
313 <para revision="265345">Support for the ASUS USB-N10 Nano
314 wireless card has been added to the &man.urtwn.4;
319 <sect3 xml:id="net-proto">
320 <title>Network Protocols</title>
326 <sect3 xml:id="disks">
327 <title>Disks and Storage</title>
329 <para revision="259328" contrib="sponsor" sponsor="&ff;">The
330 &man.geom.8; <literal>label</literal> class is now aware of
331 resized partitions. This corrects an issue where
332 <command>geom resize</command> would resize the partition,
333 but the label provider in <filename
334 class="directory">/dev/gptid/</filename> would not be
337 <para revision="260502">The &man.gmirror.8;
338 utility now has a <literal>resize</literal> command, making
339 it easier to resize the size of a mirror when all of its
340 components have been replaced.</para>
342 <para revision="268091">Support for the
343 <literal>disklabel64</literal> partitioning scheme has been
344 added to &man.gpart.8;.</para>
348 <title>File Systems</title>
350 <para revision="260178" contrib="vendor"
351 vendor="&netflix;">A new flag, <literal>-R</literal>,
352 has been added to the &man.fsck.ffs.8; utility. When used,
353 &man.fsck.ffs.8; will restart itself when too many critical
354 errors have been detected.</para>
356 <para revision="263407">The &man.zfs.8; filesystem has been
357 updated to implement <quote>bookmarks</quote>. See
358 &man.zfs.8; for further details.</para>
362 <sect2 xml:id="userland">
363 <title>Userland Changes</title>
365 <para revision="260177" contrib="sponsor"
366 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
367 <literal>-b</literal>, which outputs the existing buses and
368 their parents.</para>
370 <para revision="262075">The &man.newsyslog.8; utility has been
371 updated to rotate files based on the actual file size instead
372 of the blocks on disk. This matches the behavior documented
373 in &man.newsyslog.conf.5;.</para>
375 <para revision="262384">The location of the &man.rctl.8;
376 configuration file can now be overridden in &man.rc.conf.5;.
377 To use a non-default location, set
378 <literal>rctl_rules</literal> in &man.rc.conf.5; to the
379 location of the file.</para>
381 <para revision="262855">The <application>ATF</application> test
382 suite has been updated to version 0.20.</para>
384 <para revision="263019">The <literal>libucl</literal> library
385 (Unified Configuration Library) has been merged from
388 <para revision="263020">The &man.pkg.7; bootstrapping utility
389 has been synced with the version in &os;-CURRENT.</para>
391 <para revision="263403">The &man.zfs.8; userland utility has
392 been updated to include aliases for
393 <command>snapshot</command>, which allows use of <command>zfs
394 list -t snap</command> and <command>zfs
395 snap</command>.</para>
397 <para revision="263405">The &man.zfs.8; userland utility has
398 been updated to include a new flag to <command>zfs
399 list</command>, <literal>-p</literal>, which when specified,
400 prints the output in a parsable format.</para>
402 <para revision="263508">The &man.clang.1;/llvm suite has been
403 updated to version 3.4.</para>
405 <para revision="263783">The Blowfish password format
406 implementation updated. Support for $2b$ has
407 been added, allowing use of passwords greater than 256
408 characters long.</para>
410 <para revision="264497">The &man.iconv.3; library has been
411 updated to match NetBSD, providing several bug fixes.</para>
413 <para revision="265265">The &man.date.1; utility has been
414 updated to include a new flag, <literal>-R</literal>, which
415 prints the date and time output as specified in RFC
418 <para revision="265533">The &man.bc.1; utility has been updated
419 to version 1.1, in sync with the version in OpenBSD.</para>
421 <para revision="265604" contrib="vendor"
422 vendor="&netflix;">The &man.pmcstat.8; utility has been
423 updated to include a new flag, <literal>-a</literal>, which
424 when specified, produces a full stack track on the sampled
427 <para revision="265701">The &man.netstat.8; and &man.route.8;
428 utilities have been updated to include a shorthand equivalent
429 to the <literal>-f inet</literal> and <literal>-f
430 inet6</literal> address specifiers, <literal>-4</literal>
431 and <literal>-6</literal>, respectively.</para>
433 <para revision="266279">The &man.ps.1; utility has been
434 updated to include the <literal>-J</literal> flag, used to
435 filter output by matching &man.jail.8; IDs and names.
436 Additionally, argument <literal>0</literal> can be used to
437 <literal>-J</literal> to only list processes running on the
440 <para revision="266280">The &man.top.1; utility has been updated
441 to filter by &man.jail.8; ID or name, in followup to the
442 &man.ps.1; change in <literal>r265229</literal>.</para>
444 <para revision="266890">The &man.pmcstat.8; utility has been
445 updated to include a new flag, <literal>-l</literal>, which
446 ends event collection after the specified number of
449 <para revision="267113">The default &man.newsyslog.conf.5; now
450 includes files in the
451 <filename>/etc/newsyslog.conf.d/</filename> and
452 <filename>/usr/local/etc/newsyslog.conf.d/</filename>
453 directories by default for &man.newsyslog.8;.</para>
455 <para revision="267236">A new flag, <quote>onifconsole</quote>
456 has been added to <filename>/etc/ttys</filename>. This allows
457 the system to provide a login prompt via serial console if the
458 device is an active kernel console, otherwise it is equivalent
459 to <literal>off</literal>.</para>
461 <para revision="268161">The &man.mkimg.1; utility has been
462 merged from &os;-CURRENT.</para>
464 <sect3 xml:id="rc-scripts">
465 <title><filename>/etc/rc.d</filename> Scripts</title>
467 <para revision="264438">The <filename>network.subr</filename>
468 &man.rc.8; script has been updated to loosen the requirement
469 of listing network aliases in numeric order. Previously,
471 <literal>_alias<replaceable>2</replaceable></literal>
472 would not be created if
473 <literal>_alias<replaceable>1</replaceable></literal> was
478 <sect2 xml:id="contrib">
479 <title>Contributed Software</title>
481 <para revision="263285">The &man.xz.1; utility has been updated
482 to a post-5.0.5 snapshot.</para>
484 <para revision="263369" contrib="sponsor"
485 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
486 been updated to the r196322 snapshot.</para>
488 <para revision="263906">The timezone database has been updated
489 to version tzdata2014b.</para>
491 <para revision="264377"><application>OpenSSH</application> has
492 been updated to version 6.6p1.</para>
494 <para revision="264911">The &man.nc.1; utility has been updated
495 to match the version in OpenBSD 5.5.</para>
497 <para revision="266692"><application>Sendmail</application>
498 has been updated to 8.14.9.</para>
500 <para revision="267258"><application>OpenSSL</application> has
501 been updated to version 1.0.1h.</para>
504 <sect2 xml:id="ports">
505 <title>Ports/Packages Collection Infrastructure</title>
511 <sect2 xml:id="releng">
512 <title>Release Engineering and Integration</title>
514 <para revision="263028">The &man.services.mkdb.8; utility has
515 been updated to include endianness awareness, allowing the
516 <filename>services.db</filename> database to be created as
517 part of the release build, regardless of native- or
518 cross-built releases.</para>
522 <title>Documentation</title>
529 <sect1 xml:id="upgrade">
530 <title>Upgrading from Previous Releases of &os;</title>
532 <para arch="amd64,i386">Binary upgrades between RELEASE versions
533 (and snapshots of the various security branches) are supported
534 using the &man.freebsd-update.8; utility. The binary upgrade
535 procedure will update unmodified userland utilities, as well as
536 unmodified GENERIC or SMP kernels distributed as a part of an
537 official &os; release. The &man.freebsd-update.8; utility
538 requires that the host being upgraded have Internet
541 <para>Source-based upgrades (those based on recompiling the &os;
542 base system from source code) from previous versions are
543 supported, according to the instructions in
544 <filename>/usr/src/UPDATING</filename>.</para>
547 <para>Upgrading &os; should only be attempted after
548 backing up <emphasis>all</emphasis> data and configuration