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">
10 <!ENTITY security SYSTEM "../../share/xml/security.xml">
11 <!ENTITY errata SYSTEM "../../share/xml/errata.xml">
13 <article xmlns="http://docbook.org/ns/docbook"
14 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
18 <title>&os; &release.current; Release Notes</title>
21 <orgname>The &os; Project</orgname>
24 <pubdate>$FreeBSD$</pubdate>
26 <!-- First rev: 285831 -->
27 <!-- Last rev: 284813 -->
31 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
35 <legalnotice xml:id="trademarks" role="trademarks">
45 <para>The release notes for &os; &release.current; contain
46 a summary of the changes made to the &os; base system on the
47 &release.branch; development line. This document lists
48 applicable security advisories that were issued since the last
49 release, as well as significant changes to the &os; kernel and
50 userland. Some brief remarks on upgrading are also
55 <sect1 xml:id="intro">
56 <title>Introduction</title>
58 <para>This document contains the release notes for &os;
59 &release.current;. It describes recently added, changed, or
60 deleted features of &os;. It also provides some notes on
61 upgrading from previous versions of &os;.</para>
63 <para releasetype="current">The &release.type; distribution to
64 which these release notes apply represents the latest point
65 along the &release.branch; development branch since
66 &release.branch; was created. Information regarding pre-built,
67 binary &release.type; distributions along this branch can be
69 xlink:href="&release.url;">&release.url;</uri>.</para>
71 <para releasetype="snapshot">The &release.type; distribution to
72 which these release notes apply represents a point along the
73 &release.branch; development branch between &release.prev; and
74 the future &release.next;. 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="release">This distribution of &os;
80 &release.current; is a &release.type; distribution. It can be
81 found at <uri xlink:href="&release.url;">&release.url;</uri> or
82 any of its mirrors. More information on obtaining this (or
83 other) &release.type; distributions of &os; can be found in the
85 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
86 &os;</quote> appendix</link> to the <link
87 xlink:href="&url.books.handbook;/">&os;
88 Handbook</link>.</para>
90 <para>All users are encouraged to consult the release errata
91 before installing &os;. The errata document is updated with
92 <quote>late-breaking</quote> information discovered late in the
93 release cycle or after the release. Typically, it contains
94 information on known bugs, security advisories, and corrections
95 to documentation. An up-to-date copy of the errata for &os;
96 &release.current; can be found on the &os; Web site.</para>
98 <para>This document describes the most user-visible new or changed
99 features in &os; since &release.prev;.</para>
101 <para>Typical release note items document recent security
102 advisories issued after &release.prev;, new drivers or hardware
103 support, new commands or options, major bug fixes, or
104 contributed software upgrades. They may also list changes to
105 major ports/packages or release engineering practices. Clearly
106 the release notes cannot list every single change made to &os;
107 between releases; this document focuses primarily on security
108 advisories, user-visible changes, and major architectural
112 <sect1 xml:id="upgrade">
113 <title>Upgrading from Previous Releases of &os;</title>
115 <para arch="amd64,i386">Binary upgrades between RELEASE versions
116 (and snapshots of the various security branches) are supported
117 using the &man.freebsd-update.8; utility. The binary upgrade
118 procedure will update unmodified userland utilities, as well as
119 unmodified <filename>GENERIC</filename> kernel distributed as
120 a part of an official &os; release. The &man.freebsd-update.8;
121 utility requires that the host being upgraded have Internet
124 <para>Source-based upgrades (those based on recompiling the &os;
125 base system from source code) from previous versions are
126 supported, according to the instructions in
127 <filename>/usr/src/UPDATING</filename>.</para>
130 <para>Upgrading &os; should only be attempted after
131 backing up <emphasis>all</emphasis> data and configuration
136 <sect1 xml:id="security-errata">
137 <title>Security and Errata</title>
139 <para>This section lists the various Security Advisories and
140 Errata Notices since &release.prev;.</para>
142 <sect2 xml:id="security">
143 <title>Security Advisories</title>
148 <sect2 xml:id="errata">
149 <title>Errata Notices</title>
155 <sect1 xml:id="userland">
156 <title>Userland</title>
158 <para>This section covers changes and additions to userland
159 applications, contributed software, and system utilities.</para>
161 <sect2 xml:id="userland-config">
162 <title>Userland Configuration Changes</title>
167 <sect2 xml:id="userland-programs">
168 <title>Userland Application Changes</title>
170 <para revision="286064">The &man.jail.8; utility has been
171 updated to include a new flag, <literal>-l</literal>, which
172 ensures a clean environment in the target jail when used.
173 Additionally, &man.jail.8; will run a shell within the target
174 jail when run no commands are specified.</para>
176 <para revision="287122">The &man.mkimg.1; utility has been
177 updated to include support for <literal>NTFS</literal>
178 filesystems in both <acronym>MBR</acronym> and
179 <acronym>GPT</acronym> partitioning schemes.</para>
181 <para revision="288202" contrib="sponsor" sponsor="&ff;">The
182 &man.ar.1; utility now enables deterministic mode
183 (<literal>-D</literal>) by default. This behavior can be
184 disabled by specifying the <literal>-U</literal> flag.</para>
186 <para revision="287746">The &man.pciconf.8; utility has been
187 updated to use the PCI ID database from the <filename
188 role="package">misc/pciids</filename> package, if present,
189 falling back to the PCI ID database in the &os; base
192 <para revision="288710" contrib="sponsor" sponsor="&gandi;">A
193 new utility, &man.sesutil.8;, has been added, which is used
194 to manage &man.ses.4; devices.</para>
196 <para revision="291774">The &man.cp.1; utility has been updated
197 to include a new flag, <literal>-s</literal>, which creates
198 a symbolic link to the specified source.</para>
200 <para revision="292231">Support for the
201 <literal>-manage-gids</literal> has been added to
202 &man.nfsd.8;. This option can be enabled at boot time by
203 adding <literal>nfs_server_managegids="YES"</literal> to
204 &man.rc.conf.5;.</para>
206 <para revision="292462" contrib="sponsor"
207 sponsor="&dellinc;">The resolver library has been updated to
208 reload <filename>/etc/resolv.conf</filename> if the
209 modification time has changed.</para>
211 <para revision="293744" contrib="sponsor" sponsor="&ff;">The
212 initial implementation of <quote>reroot</quote> support has
213 been added to the &man.shutdown.8; utility, allowing the root
214 filesystem to be mounted from a temporary source filesystem
215 without requiring a full system reboot.</para>
218 <sect2 xml:id="userland-contrib">
219 <title>Contributed Software</title>
221 <para revision="286082">The &man.libarchive.3; library has been
222 updated to properly skip a sparse file entry in a &man.tar.1;
223 file, which would previously produce errors.</para>
225 <para revision="286751">Timezone data files have been updated to
226 version 2015f.</para>
228 <para revision="290152">The &man.file.1; utility has been
229 updated to version 5.25.</para>
231 <para revision="292588">The &man.xz.1; utility has been updated
232 to version 5.2.2, which provides support for multi-threaded
235 <para revision="293650">The &man.ntpd.8; utility has been
236 updated to version 4.2.8p5.</para>
238 <para revision="294190">The &man.unbound.8; utility has been
239 updated to version 1.5.7.</para>
241 <para revision="294286">The &man.less.1; utility has been
242 updated to version v481.</para>
244 <para revision="295690">The
245 <literal>unbound-control-setup</literal> script has been
246 removed from the base system.</para>
248 <para revision="295691">The &man.unbound.8; utility has been
249 updated to enable the <literal>insecure-lan-zones</literal>
250 option in preference of listing each <acronym>AS112</acronym>
251 zone individually.</para>
253 <para revision="296317">The <application>OpenSSL</application>
254 suite has been updated to version 1.0.1s.</para>
256 <para revision="296853">The <application>OpenSSH</application>
257 suite has been updated to version 7.2p2.</para>
260 <sect2 xml:id="userland-installer">
261 <title>Installation and Configuration Tools</title>
263 <para revision="295264" contrib="sponsor"
264 sponsor="&scaleengine;">The &man.bsdinstall.8; utility has
265 been updated to support <acronym>ZFS</acronym> installation
266 on <acronym>EFI</acronym>-based systems.</para>
269 <sect2 xml:id="userland-rc">
270 <title><filename class="directory">/etc/rc.d</filename>
273 <para revision="294680">The <literal>netwait</literal>
274 &man.rc.8; script has been updated to wait for network
275 interfaces that attach late in the boot process, such as some
276 <acronym>USB</acronym> network cards.</para>
279 <sect2 xml:id="userland-periodic">
280 <title><filename class="directory">/etc/periodic</filename>
286 <sect2 xml:id="userland-libraries">
287 <title>Runtime Libraries and API</title>
292 <sect2 xml:id="userland-abi">
293 <title>ABI Compatibility</title>
299 <sect1 xml:id="kernel">
300 <title>Kernel</title>
302 <para>This section covers changes to kernel configurations, system
303 tuning, and system control parameters that are not otherwise
306 <sect2 xml:id="kernel-bugfix">
307 <title>Kernel Bug Fixes</title>
309 <para revision="288167" contrib="sponsor"
310 sponsor="&multiplay;">The &man.kqueue.2; system call has been
311 updated to handle write events to files larger than 2
315 <sect2 xml:id="kernel-config">
316 <title>Kernel Configuration</title>
321 <sect2 xml:id="kernel-sysctl">
322 <title>System Tuning and Controls</title>
324 <para revision="287037">The &man.uart.4; driver has been
325 updated to allow tuning pulses per second captured in the
326 CTS line during runtime, whereas previously only the DCD line
327 could be used without rebuilding the kernel.</para>
331 <sect1 xml:id="drivers">
332 <title>Devices and Drivers</title>
334 <para>This section covers changes and additions to devices and
335 device drivers since &release.prev;.</para>
337 <sect2 xml:id="drivers-device">
338 <title>Device Drivers</title>
343 <sect2 xml:id="drivers-storage">
344 <title>Storage Drivers</title>
346 <para revision="288732" contrib="sponsor" sponsor="&ix;">The
347 <acronym>CTL</acronym> High Availability implementation has
348 been rewritten.</para>
350 <para revision="288810">The &man.ctl.4; driver has been updated
351 to support CD-ROM and removable devices.</para>
354 <sect2 xml:id="drivers-network">
355 <title>Network Drivers</title>
357 <para revision="295524" contrib="sponsor"
358 sponsor="&limelight;, &intelcorp;">The &man.ixgbe.4; driver
359 has been updated to version 3.1.13-k.</para>
363 <sect1 xml:id="hardware">
364 <title>Hardware Support</title>
366 <para>This section covers general hardware support for physical
367 machines, hypervisors, and virtualization environments, as well
368 as hardware changes and updates that do not otherwise fit in
369 other sections of this document.</para>
371 <sect2 xml:id="hardware-support">
372 <title>Hardware Support</title>
374 <para revision="293675">The &man.ismt.4; driver has been added,
375 providing support for recent &intel; SMBus 2.0
379 <sect2 xml:id="hardware-virtualization">
380 <title>Virtualization Support</title>
382 <para revision="287802">The &man.xen.4; driver has been updated
383 to include support for <literal>blkif</literal> indirect
387 <sect2 xml:id="hardware-arm">
388 <title>ARM Support</title>
394 <sect1 xml:id="storage">
395 <title>Storage</title>
397 <para>This section covers changes and additions to file systems
398 and other storage subsystems, both local and networked.</para>
400 <sect2 xml:id="storage-general">
401 <title>General Storage</title>
406 <sect2 xml:id="storage-net">
407 <title>Networked Storage</title>
412 <sect2 xml:id="storage-zfs">
415 <para revision="287665" contrib="sponsor"
416 sponsor="&clusterhq;">The &man.zfs.8; <literal>l2arc</literal>
417 code has been updated to take <literal>ashift</literal> into
418 account when gathering buffers to be written to the
419 <literal>l2arc</literal> device.</para>
422 <sect2 xml:id="storage-geom">
423 <title>&man.geom.4;</title>
429 <sect1 xml:id="boot">
430 <title>Boot Loader Changes</title>
432 <para>This section covers the boot loader, boot menu, and other
433 boot-related changes.</para>
435 <sect2 xml:id="boot-loader">
436 <title>Boot Loader Changes</title>
438 <para revision="294445">Initial terminal emulation support has
439 been added to <filename>loader.efi</filename> for
440 <acronym>UEFI</acronym>-based systems.</para>
442 <para revision="294999" contrib="sponsor"
443 sponsor="&multiplay;">Initial <acronym>ZFS</acronym> boot
444 support has been added to the <acronym>EFI</acronym>
445 implementation.</para>
447 <para revision="295475" contrib="sponsor"
448 sponsor="&scaleengine;">The <acronym>UEFI</acronym> loader has
449 been updated to support multiple <acronym>ZFS</acronym> boot
450 environments, such as those provided by <filename
451 role="package">sysutils/beadm</filename>.</para>
454 <sect2 xml:id="boot-menu">
455 <title>Boot Menu Changes</title>
457 <para revision="294446">The <acronym>UEFI</acronym> boot menu
458 has been updated to enable the <quote>Beastie</quote> menu,
459 similiar to the traditional &man.sc.4; boot menu.</para>
463 <sect1 xml:id="network">
464 <title>Networking</title>
466 <para>This section describes changes that affect networking in
469 <sect2 xml:id="network-protocols">
470 <title>Network Protocols</title>
476 <sect1 xml:id="ports">
477 <title>Ports Collection and Package Infrastructure</title>
479 <para>This section covers changes to the &os; Ports
480 Collection, package infrastructure, and package maintenance and
481 installation tools.</para>
483 <sect2 xml:id="ports-infrastructure">
484 <title>Infrastructure Changes</title>
489 <sect2 xml:id="ports-packages ">
490 <title>Packaging Changes</title>
497 <title>Documentation</title>
499 <para>This section covers changes to the &os; Documentation
500 Project sources and toolchain.</para>
502 <sect2 xml:id="doc-sources">
503 <title>Documentation Source Changes</title>
508 <sect2 xml:id="doc-toolchain">
509 <title>Documentation Toolchain Changes</title>
515 <sect1 xml:id="releng">
516 <title>Release Engineering and Integration</title>
518 <para>This section convers changes that are specific to the
519 &os; Release Engineering processes.</para>
521 <sect2 xml:id="releng-changes">
522 <title>Integration Changes</title>