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" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
13 <title>&os; &release.current; Release Notes</title>
16 <orgname>The &os; Project</orgname>
19 <pubdate>$FreeBSD$</pubdate>
37 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
40 <legalnotice xml:id="trademarks" role="trademarks">
50 <para>The release notes for &os; &release.current; contain
51 a summary of the changes made to the &os; base system on the
52 &release.branch; development line. This document lists
53 applicable security advisories that were issued since the last
54 release, as well as significant changes to the &os; kernel and
55 userland. Some brief remarks on upgrading are also
60 <sect1 xml:id="intro">
61 <title>Introduction</title>
63 <para>This document contains the release notes for &os;
64 &release.current;. It describes recently added, changed, or
65 deleted features of &os;. It also provides some notes on
66 upgrading from previous versions of &os;.</para>
68 <para releasetype="current">The &release.type; distribution to which
69 these release notes apply represents the latest point along the
70 &release.branch; development branch since &release.branch; was
71 created. Information regarding pre-built, binary &release.type;
72 distributions along this branch can be found at <uri
73 xlink:href="&release.url;">&release.url;</uri>.</para>
75 <para releasetype="snapshot">The &release.type; distribution to
76 which these release notes apply represents a point along the
77 &release.branch; development branch between &release.prev; and the
78 future &release.next;. Information regarding pre-built, binary
79 &release.type; distributions along this branch can be found at
80 <uri xlink:href="&release.url;">&release.url;</uri>.</para>
82 <para releasetype="release">This distribution of &os;
83 &release.current; is a &release.type; distribution. It can be
84 found at <uri xlink:href="&release.url;">&release.url;</uri> or
85 any of its mirrors. More information on obtaining this (or other)
86 &release.type; distributions of &os; can be found in the <link
87 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
88 &os;</quote> appendix</link> to the <link
89 xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
91 <para>All users are encouraged to consult the release errata before
92 installing &os;. The errata document is updated with
93 <quote>late-breaking</quote> information discovered late in the
94 release cycle or after the release. Typically, it contains
95 information on known bugs, security advisories, and corrections to
96 documentation. An up-to-date copy of the errata for &os;
97 &release.current; can be found on the &os; Web site.</para>
101 <title>What's New</title>
103 <para>This section describes the most user-visible new or changed
104 features in &os; since &release.prev;.</para>
106 <para>Typical release note items document recent security advisories
107 issued after &release.prev;, new drivers or hardware support, new
108 commands or options, major bug fixes, or contributed software
109 upgrades. They may also list changes to major ports/packages or
110 release engineering practices. Clearly the release notes cannot
111 list every single change made to &os; between releases; this
112 document focuses primarily on security advisories, user-visible
113 changes, and major architectural improvements.</para>
115 <sect2 xml:id="security">
116 <title>Security Advisories</title>
122 <sect2 xml:id="kernel">
123 <title>Kernel Changes</title>
125 <para revision="260338">The <literal>vfs.zfs.zio.use_uma</literal>
126 &man.sysctl.8; has been re-enabled. On multi-CPU machines with
127 enough RAM, this can easily double &man.zfs.8; performance or
128 reduce CPU usage in half. It was originally disabled due to
129 memory and <acronym>KVA</acronym> exhaustion problem reports,
130 which should be resolved due to several change in the VM
133 <para revision="260385" contrib="sponsor" sponsor="&ix;">The
134 &man.geom.4; RAID driver has been
135 updated to support unmapped I/O.</para>
137 <para revision="260431">A new &man.sysctl.8;,
138 <literal>kern.panic_reboot_wait_time</literal>, has been added,
139 which allows controlling how long the system will wait after
140 &man.panic.9; before rebooting.</para>
142 <para revision="260857">The &man.virtio_blk.4; driver has been
143 updated to support unmapped I/O.</para>
145 <para revision="260858">The &man.virtio_scsi.4; driver has been
146 updated to support unmapped I/O.</para>
148 <para revision="262861">The &man.vt.4; driver has been merged
149 from &os;-CURRENT. To enable &man.vt.4;, enter
150 <literal>set kern.vty=vt</literal> at the &man.loader.8; prompt
151 during boot, or add <literal>kern.vty=vt</literal> to
152 &man.loader.conf.5; and reboot the system.</para>
154 <para revision="262967">Support for MegaRAID Fury cards has been
155 added to the &man.mfi.4; driver.</para>
157 <para revision="263024">The &man.aacraid.4; driver has been
158 updated to version 3.2.5.</para>
160 <para revision="263122">Support for &man.hwpmc.4; has been added
161 for &powerpc; 970 class processors.</para>
163 <para revision="263197">Support for ADT7460 and ADT7467 fan
164 controllers found in newer PowerBooks™ and
165 iBooks™ has been added to the &man.iicbus.4;
168 <para revision="263256">A panic triggered by removing
169 a &man.urtwn.4; device has been fixed.</para>
171 <para revision="263799">A potential deadlock in the &man.usb.4;
172 stack triggered by detaching USB devices that create character
173 devices has been fixed.</para>
175 <para revision="263869">Support for &amd; Family 16h sensor
176 devices has been added to &man.amdtemp.4;.</para>
178 <para revision="264522">Support for LUN-based CD changers has been
179 removed from the &man.cd.4; driver.</para>
181 <para revision="264734">Support for 9th generation HP host bus
182 adapter cards has been added to &man.ciss.4;.</para>
184 <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
185 &man.mpr.4; device has been added,
186 providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
189 <para revision="265536">The <literal>GEOM_VINUM</literal> option
190 is now able to be built both directly into the kernel or as
191 a &man.kldload.8; loadable module.</para>
193 <para revision="265610">The &man.uslcom.4; driver has been updated
194 to support 26 new devices.</para>
196 <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
197 &man.mrsas.4; driver has been added,
198 providing support for LSI MegaRAID SAS controllers. The
199 &man.mfi.4; driver will attach to the controller, by default.
200 To enable &man.mrsas.4; add
201 <literal>hw.mfi.mrsas_enable=1</literal> to
202 <filename>/boot/loader.conf</filename>, which turns off
203 &man.mfi.4; device probing.</para>
206 <para>At this time, the &man.mfiutil.8; utility and
208 <application>MegaCLI</application> and
209 <application>StorCli</application> do not work with
210 &man.mrsas.4;.</para>
213 <para revision="266165">A kernel bug that inhibited proper
214 functionality of the <literal>dev.cpu.0.freq</literal>
215 &man.sysctl.8; on &intel; processors with Turbo
216 Boost ™ enabled has been fixed.</para>
218 <sect3 xml:id="kernel-virtualization">
219 <title>Virtualization Support</title>
221 <para revision="259450">Support for µsoft; Hyper-V
222 has been added to &os;/i386 as loadable modules, however
223 not available in the <filename>GENERIC</filename> kernel
224 configuration.</para>
226 <para revision="261090">The &man.bhyve.4; hypervisor now
227 supports soft power-off functionality via the ACPI S5
231 <sect3 xml:id="kernel-arm">
232 <title>ARM Support</title>
234 <para revision="259355">The <filename>WANDBOARD</filename>
235 kernel configuration file has been added.</para>
237 <para revision="265067">Boot devices may now be specified by
238 setting a u-boot environment variable. If a boot device is
239 not specified, the probe mechanism will be used. To specify
240 the boot device, set the
241 <literal>loaderdev=<replaceable>device</replaceable></literal>
242 u-boot environment variable.</para>
245 <sect3 xml:id="boot">
246 <title>Boot Loader Changes</title>
248 <para revision="262701">A kernel selection menu has been added
249 to &man.loader.8;. If the <quote>beastie menu</quote> is
250 enabled, the kernel to boot may be selected from the kernel
251 selection menu. Additional kernels may be listed in
252 &man.loader.conf.5; as a comma- or space-separated list. By
253 default, <literal>kernel</literal> and
254 <literal>kernel.old</literal> are listed.</para>
257 <sect3 xml:id="proc">
258 <title>Hardware Support</title>
263 <title>Multimedia Support</title>
269 <sect4 xml:id="net-if">
270 <title>Network Interface Support</title>
272 <para revision="259453">Support for Ralink RT5370 and
273 RT5372 chipsets has been added to the &man.run.4;
276 <para revision="260120">Firmware for the &man.run.4; driver
277 has been updated to version 0.33.</para>
279 <para revision="261868">Support for the Ralink RT3593
280 chipset has been added to the &man.run.4; driver.</para>
282 <para revision="261972">The &man.nve.4; driver is now
283 deprecated, and the &man.nfe.4; driver should be used
286 <para revision="262137">Support for the &man.axge.4; driver
287 has been added. This driver supports the ASIX AX88178A and
288 AX88179 USB ethernet adapters. The AX88178A supports USB
289 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
291 <para revision="262363">The &man.urndis.4; driver has been
292 imported from OpenBSD.</para>
294 <para revision="264866">Support for multiple
295 transmitter/receiver queues has been added to the
296 &man.vmx.4; driver.</para>
299 <para>The &os; guest operating system must have
300 <acronym>MSIX</acronym> enabled as a prerequisite for
301 multiple queues.</para>
304 <para revision="265345">Support for the ASUS USB-N10 Nano
305 wireless card has been added to the &man.urtwn.4;
310 <sect3 xml:id="net-proto">
311 <title>Network Protocols</title>
317 <sect3 xml:id="disks">
318 <title>Disks and Storage</title>
320 <para revision="259328" contrib="sponsor"
321 sponsor="&ff;">The &man.geom.8; <literal>label</literal> class
322 is now aware of resized partitions. This corrects an issue
323 where <command>geom resize</command> would resize the
324 partition, but the label provider in <filename
325 class="directory">/dev/gptid/</filename> would not be
328 <para revision="260502">The &man.gmirror.8;
329 utility now has a <literal>resize</literal> command, making
330 it easier to resize the size of a mirror when all of its
331 components have been replaced.</para>
333 <para revision="268091">Support for the
334 <literal>disklabel64</literal> partitioning scheme has been
335 added to &man.gpart.8;.</para>
339 <title>File Systems</title>
341 <para revision="260178" contrib="vendor"
342 vendor="&netflix;">A new flag, <literal>-R</literal>,
343 has been added to the &man.fsck.ffs.8; utility. When used,
344 &man.fsck.ffs.8; will restart itself when too many critical
345 errors have been detected.</para>
347 <para revision="263407">The &man.zfs.8; filesystem has been
348 updated to implement <quote>bookmarks</quote>. See
349 &man.zfs.8; for further details.</para>
353 <sect2 xml:id="userland">
354 <title>Userland Changes</title>
356 <para revision="260177" contrib="sponsor"
357 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
358 <literal>-b</literal>, which outputs the existing buses and
359 their parents.</para>
361 <para revision="262075">The &man.newsyslog.8; utility has been
362 updated to rotate files based on the actual file size instead
363 of the blocks on disk. This matches the behavior documented in
364 &man.newsyslog.conf.5;.</para>
366 <para revision="262384">The location of the &man.rctl.8;
367 configuration file can now be overridden in &man.rc.conf.5;.
368 To use a non-default location, set <literal>rctl_rules</literal>
369 in &man.rc.conf.5; to the location of the file.</para>
371 <para revision="262855">The <application>ATF</application> test
372 suite has been updated to version 0.20.</para>
374 <para revision="263019">The <literal>libucl</literal> library
375 (Unified Configuration Library) has been merged from
378 <para revision="263020">The &man.pkg.7; bootstrapping utility has
379 been synced with the version in &os;-CURRENT.</para>
381 <para revision="263403">The &man.zfs.8; userland utility has been
382 updated to include aliases for <command>snapshot</command>,
383 which allows use of <command>zfs list -t snap</command> and
384 <command>zfs snap</command>.</para>
386 <para revision="263405">The &man.zfs.8; userland utility has been
387 updated to include a new flag to <command>zfs list</command>,
388 <literal>-p</literal>, which when specified, prints the output
389 in a parsable format.</para>
391 <para revision="263508">The &man.clang.1;/llvm suite has been
392 updated to version 3.4.</para>
394 <para revision="263783">The Blowfish password format
395 implementation updated. Support for $2b$ has
396 been added, allowing use of passwords greater than 256
397 characters long.</para>
399 <para revision="264497">The &man.iconv.3; library has been
400 updated to match NetBSD, providing several bug fixes.</para>
402 <para revision="265265">The &man.date.1; utility has been updated
403 to include a new flag, <literal>-R</literal>, which prints the
404 date and time output as specified in RFC 2822.</para>
406 <para revision="265533">The &man.bc.1; utility has been updated to
407 version 1.1, in sync with the version in OpenBSD.</para>
409 <para revision="265604" contrib="vendor"
410 vendor="&netflix;">The &man.pmcstat.8; utility has been
411 updated to include a new flag, <literal>-a</literal>, which when
412 specified, produces a full stack track on the sampled
415 <para revision="265701">The &man.netstat.8; and &man.route.8;
416 utilities have been updated to include a shorthand equivalent
417 to the <literal>-f inet</literal> and <literal>-f
418 inet6</literal> address specifiers, <literal>-4</literal> and
419 <literal>-6</literal>, respectively.</para>
421 <para revision="266279">The &man.ps.1; utility has been
422 updated to include the <literal>-J</literal> flag, used to
423 filter output by matching &man.jail.8; IDs and names.
424 Additionally, argument <literal>0</literal> can be used to
425 <literal>-J</literal> to only list processes running on the
428 <para revision="266280">The &man.top.1; utility has been updated
429 to filter by &man.jail.8; ID or name, in followup to the
430 &man.ps.1; change in <literal>r265229</literal>.</para>
432 <para revision="266890">The &man.pmcstat.8; utility has been
433 updated to include a new flag, <literal>-l</literal>, which
434 ends event collection after the specified number of
437 <para revision="267113">The default &man.newsyslog.conf.5; now
438 includes files in the
439 <filename>/etc/newsyslog.conf.d/</filename> and
440 <filename>/usr/local/etc/newsyslog.conf.d/</filename>
441 directories by default for &man.newsyslog.8;.</para>
443 <para revision="267236">A new flag, <quote>onifconsole</quote> has
444 been added to <filename>/etc/ttys</filename>. This allows the
445 system to provide a login prompt via serial console if the
446 device is an active kernel console, otherwise it is equivalent
447 to <literal>off</literal>.</para>
449 <para revision="268161">The &man.mkimg.1; utility has been merged
450 from &os;-CURRENT.</para>
452 <sect3 xml:id="rc-scripts">
453 <title><filename>/etc/rc.d</filename> Scripts</title>
455 <para revision="264438">The <filename>network.subr</filename>
456 &man.rc.8; script has been updated to loosen the requirement
457 of listing network aliases in numeric order. Previously,
459 <literal>_alias<replaceable>2</replaceable></literal>
460 would not be created if
461 <literal>_alias<replaceable>1</replaceable></literal> was
466 <sect2 xml:id="contrib">
467 <title>Contributed Software</title>
469 <para revision="263285">The &man.xz.1; utility has been updated
470 to a post-5.0.5 snapshot.</para>
472 <para revision="263369" contrib="sponsor"
473 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
474 been updated to the r196322 snapshot.</para>
476 <para revision="263906">The timezone database has been updated to
477 version tzdata2014b.</para>
479 <para revision="264377"><application>OpenSSH</application> has
480 been updated to version 6.6p1.</para>
482 <para revision="264911">The &man.nc.1; utility has been updated
483 to match the version in OpenBSD 5.5.</para>
485 <para revision="266692"><application>Sendmail</application>
486 has been updated to 8.14.9.</para>
488 <para revision="267258"><application>OpenSSL</application> has
489 been updated to version 1.0.1h.</para>
492 <sect2 xml:id="ports">
493 <title>Ports/Packages Collection Infrastructure</title>
499 <sect2 xml:id="releng">
500 <title>Release Engineering and Integration</title>
502 <para revision="263028">The &man.services.mkdb.8; utility has
503 been updated to include endianness awareness, allowing the
504 <filename>services.db</filename> database to be created as
505 part of the release build, regardless of native- or
506 cross-built releases.</para>
510 <title>Documentation</title>
517 <sect1 xml:id="upgrade">
518 <title>Upgrading from Previous Releases of &os;</title>
520 <para arch="amd64,i386">Binary upgrades between RELEASE versions
521 (and snapshots of the various security branches) are supported
522 using the &man.freebsd-update.8; utility. The binary upgrade
523 procedure will update unmodified userland utilities, as well as
524 unmodified GENERIC or SMP kernels distributed as a part of an
525 official &os; release. The &man.freebsd-update.8; utility
526 requires that the host being upgraded have Internet
529 <para>Source-based upgrades (those based on recompiling the &os;
530 base system from source code) from previous versions are
531 supported, according to the instructions in
532 <filename>/usr/src/UPDATING</filename>.</para>
535 <para>Upgrading &os; should only be attempted after
536 backing up <emphasis>all</emphasis> data and configuration