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
176 <title>File Systems</title>
178 <para revision="275490">A new tunable,
179 <literal>vfs.zfs.spa_slop_shift</literal>, has been added,
180 which controls how much space is reserved by default.</para>
184 <sect2 xml:id="userland">
185 <title>Userland Changes</title>
187 <para revision="275040">A new file configuration library,
188 &man.figpar.3;, has been added to the base system.</para>
190 <para revision="275040">A new utility, &man.dpv.1;, has been
191 added to the base system, providing a &man.dialog.1;-style
192 progress view from one or more input streams. A corresponding
193 library, &man.dpv.3;, has also been added.</para>
195 <sect3 xml:id="rc-scripts">
196 <title><filename>/etc/rc.d</filename> Scripts</title>
202 <sect2 xml:id="contrib">
203 <title>Contributed Software</title>
208 <sect2 xml:id="ports">
209 <title>Ports/Packages Collection Infrastructure</title>
214 <sect2 xml:id="releng">
215 <title>Release Engineering and Integration</title>
221 <title>Documentation</title>
227 <sect1 xml:id="upgrade">
228 <title>Upgrading from Previous Releases of &os;</title>
230 <para arch="amd64,i386">Binary upgrades between RELEASE versions
231 (and snapshots of the various security branches) are supported
232 using the &man.freebsd-update.8; utility. The binary upgrade
233 procedure will update unmodified userland utilities, as well as
234 unmodified <filename>GENERIC</filename> kernel distributed as
235 a part of an official &os; release. The &man.freebsd-update.8;
236 utility requires that the host being upgraded have Internet
239 <para>Source-based upgrades (those based on recompiling the &os;
240 base system from source code) from previous versions are
241 supported, according to the instructions in
242 <filename>/usr/src/UPDATING</filename>.</para>
245 <para>Upgrading &os; should only be attempted after
246 backing up <emphasis>all</emphasis> data and configuration