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>
25 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
29 <legalnotice xml:id="trademarks" role="trademarks">
39 <para>The release notes for &os; &release.current; contain
40 a summary of the changes made to the &os; base system on the
41 &release.branch; development line. This document lists
42 applicable security advisories that were issued since the last
43 release, as well as significant changes to the &os; kernel and
44 userland. Some brief remarks on upgrading are also
49 <sect1 xml:id="intro">
50 <title>Introduction</title>
52 <para>This document contains the release notes for &os;
53 &release.current;. It describes recently added, changed, or
54 deleted features of &os;. It also provides some notes on
55 upgrading from previous versions of &os;.</para>
57 <para releasetype="current">The &release.type; distribution to
58 which these release notes apply represents the latest point
59 along the &release.branch; development branch since
60 &release.branch; was created. Information regarding pre-built,
61 binary &release.type; distributions along this branch can be
63 xlink:href="&release.url;">&release.url;</uri>.</para>
65 <para releasetype="snapshot">The &release.type; distribution to
66 which these release notes apply represents a point along the
67 &release.branch; development branch between &release.prev; and
68 the future &release.next;. Information regarding pre-built,
69 binary &release.type; distributions along this branch can be
71 xlink:href="&release.url;">&release.url;</uri>.</para>
73 <para releasetype="release">This distribution of &os;
74 &release.current; is a &release.type; distribution. It can be
75 found at <uri xlink:href="&release.url;">&release.url;</uri> or
76 any of its mirrors. More information on obtaining this (or
77 other) &release.type; distributions of &os; can be found in the
79 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
80 &os;</quote> appendix</link> to the <link
81 xlink:href="&url.books.handbook;/">&os;
82 Handbook</link>.</para>
84 <para>All users are encouraged to consult the release errata
85 before installing &os;. The errata document is updated with
86 <quote>late-breaking</quote> information discovered late in the
87 release cycle or after the release. Typically, it contains
88 information on known bugs, security advisories, and corrections
89 to documentation. An up-to-date copy of the errata for &os;
90 &release.current; can be found on the &os; Web site.</para>
94 <title>What's New</title>
96 <para>This section describes the most user-visible new or changed
97 features in &os; since &release.prev;.</para>
99 <para>Typical release note items document recent security
100 advisories issued after &release.prev;, new drivers or hardware
101 support, new commands or options, major bug fixes, or
102 contributed software upgrades. They may also list changes to
103 major ports/packages or release engineering practices. Clearly
104 the release notes cannot list every single change made to &os;
105 between releases; this document focuses primarily on security
106 advisories, user-visible changes, and major architectural
109 <sect2 xml:id="security">
110 <title>Security Advisories</title>
116 <sect2 xml:id="kernel">
117 <title>Kernel Changes</title>
121 <sect3 xml:id="kernel-virtualization">
122 <title>Virtualization Support</title>
127 <sect3 xml:id="kernel-arm">
128 <title>ARM Support</title>
133 <sect3 xml:id="boot">
134 <title>Boot Loader Changes</title>
139 <sect3 xml:id="proc">
140 <title>Hardware Support</title>
145 <title>Multimedia Support</title>
150 <sect4 xml:id="net-if">
151 <title>Network Interface Support</title>
157 <sect3 xml:id="net-proto">
158 <title>Network Protocols</title>
163 <sect3 xml:id="disks">
164 <title>Disks and Storage</title>
166 <para revision="274939" contrib="sponsor" sponsor="&ix;">The
167 &man.ctld.8; utility has been updated to include support for
168 registering <acronym>iSCSI</acronym> targets and portals on
169 <acronym>iSNS</acronym> servers. This provides a mechanism
170 which allows <acronym>iSCSI</acronym> initiators to find
171 targets and portals without requiring active
174 <para revision="275891" contrib="sponsor" sponsor="&ix;">The
175 &man.ctl.4; subsystem has been updated, increasing the ports
176 limit from <literal>128</literal> to <literal>256</literal>,
177 and <acronym>LUN</acronym> limit from <literal>256</literal>
178 to <literal>1024</literal>.</para>
182 <title>File Systems</title>
184 <para revision="275490">A new tunable,
185 <literal>vfs.zfs.spa_slop_shift</literal>, has been added,
186 which controls how much space is reserved by default.</para>
190 <sect2 xml:id="userland">
191 <title>Userland Changes</title>
193 <para revision="275040">A new file configuration library,
194 &man.figpar.3;, has been added to the base system.</para>
196 <para revision="275040">A new utility, &man.dpv.1;, has been
197 added to the base system, providing a &man.dialog.1;-style
198 progress view from one or more input streams. A corresponding
199 library, &man.dpv.3;, has also been added.</para>
201 <para revision="275945">The &man.elfdump.1; utility has been
202 updated to support capability mode provided by
203 &man.capsicum.4;.</para>
205 <sect3 xml:id="rc-scripts">
206 <title><filename>/etc/rc.d</filename> Scripts</title>
212 <sect2 xml:id="contrib">
213 <title>Contributed Software</title>
218 <sect2 xml:id="ports">
219 <title>Ports/Packages Collection Infrastructure</title>
224 <sect2 xml:id="releng">
225 <title>Release Engineering and Integration</title>
231 <title>Documentation</title>
237 <sect1 xml:id="upgrade">
238 <title>Upgrading from Previous Releases of &os;</title>
240 <para arch="amd64,i386">Binary upgrades between RELEASE versions
241 (and snapshots of the various security branches) are supported
242 using the &man.freebsd-update.8; utility. The binary upgrade
243 procedure will update unmodified userland utilities, as well as
244 unmodified <filename>GENERIC</filename> kernel distributed as
245 a part of an official &os; release. The &man.freebsd-update.8;
246 utility requires that the host being upgraded have Internet
249 <para>Source-based upgrades (those based on recompiling the &os;
250 base system from source code) from previous versions are
251 supported, according to the instructions in
252 <filename>/usr/src/UPDATING</filename>.</para>
255 <para>Upgrading &os; should only be attempted after
256 backing up <emphasis>all</emphasis> data and configuration