article.xml revision 276720
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">
5 %release;
6<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
7 %sponsor;
8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
9 %vendor;
10]>
11<article xmlns="http://docbook.org/ns/docbook"
12  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
13
14  <info>
15    <title>&os; &release.current; Release Notes</title>
16
17    <author>
18      <orgname>The &os; Project</orgname>
19    </author>
20
21    <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 276720 2015-01-05 20:34:00Z gjb $</pubdate>
22
23    <copyright>
24      <year>2015</year>
25      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
26	Project</holder>
27    </copyright>
28
29    <legalnotice xml:id="trademarks" role="trademarks">
30      &tm-attrib.freebsd;
31      &tm-attrib.ibm;
32      &tm-attrib.ieee;
33      &tm-attrib.intel;
34      &tm-attrib.sparc;
35      &tm-attrib.general;
36    </legalnotice>
37
38    <abstract>
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
45	presented.</para>
46    </abstract>
47  </info>
48
49  <sect1 xml:id="intro">
50    <title>Introduction</title>
51
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>
56
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
62      found at <uri
63	xlink:href="&release.url;">&release.url;</uri>.</para>
64
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
70      found at <uri
71	xlink:href="&release.url;">&release.url;</uri>.</para>
72
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
78      <link
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>
83
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>
91  </sect1>
92
93  <sect1 xml:id="new">
94    <title>What's New</title>
95
96    <para>This section describes the most user-visible new or changed
97      features in &os; since &release.prev;.</para>
98
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
107      improvements.</para>
108
109    <sect2 xml:id="security">
110      <title>Security Advisories</title>
111
112      <para>&nbsp;</para>
113
114    </sect2>
115
116    <sect2 xml:id="kernel">
117      <title>Kernel Changes</title>
118
119      <para>&nbsp;</para>
120
121      <sect3 xml:id="kernel-virtualization">
122	<title>Virtualization Support</title>
123
124	<para>&nbsp;</para>
125      </sect3>
126
127      <sect3 xml:id="kernel-arm">
128	<title>ARM Support</title>
129
130	<para>&nbsp;</para>
131      </sect3>
132
133      <sect3 xml:id="boot">
134	<title>Boot Loader Changes</title>
135
136	<para>&nbsp;</para>
137      </sect3>
138
139      <sect3 xml:id="proc">
140	<title>Hardware Support</title>
141
142	<para>&nbsp;</para>
143
144	<sect4 xml:id="mm">
145	  <title>Multimedia Support</title>
146
147	  <para>&nbsp;</para>
148	</sect4>
149
150	<sect4 xml:id="net-if">
151	  <title>Network Interface Support</title>
152
153	  <para>&nbsp;</para>
154	</sect4>
155      </sect3>
156
157      <sect3 xml:id="net-proto">
158	<title>Network Protocols</title>
159
160	<para>&nbsp;</para>
161      </sect3>
162
163      <sect3 xml:id="disks">
164	<title>Disks and Storage</title>
165
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
172	  discovery.</para>
173      </sect3>
174
175      <sect3 xml:id="fs">
176	<title>File Systems</title>
177
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>
181      </sect3>
182    </sect2>
183
184    <sect2 xml:id="userland">
185      <title>Userland Changes</title>
186
187      <para revision="275040">A new file configuration library,
188	&man.figpar.3;, has been added to the base system.</para>
189
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>
194
195      <sect3 xml:id="rc-scripts">
196	<title><filename>/etc/rc.d</filename> Scripts</title>
197
198	<para>&nbsp;</para>
199      </sect3>
200    </sect2>
201
202    <sect2 xml:id="contrib">
203      <title>Contributed Software</title>
204
205      <para>&nbsp;</para>
206    </sect2>
207
208    <sect2 xml:id="ports">
209      <title>Ports/Packages Collection Infrastructure</title>
210
211      <para>&nbsp;</para>
212    </sect2>
213
214    <sect2 xml:id="releng">
215      <title>Release Engineering and Integration</title>
216
217      <para>&nbsp;</para>
218    </sect2>
219
220    <sect2 xml:id="doc">
221      <title>Documentation</title>
222
223      <para>&nbsp;</para>
224    </sect2>
225  </sect1>
226
227  <sect1 xml:id="upgrade">
228    <title>Upgrading from Previous Releases of &os;</title>
229
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
237      connectivity.</para>
238
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>
243
244    <important>
245      <para>Upgrading &os; should only be attempted after
246	backing up <emphasis>all</emphasis> data and configuration
247	files.</para>
248    </important>
249  </sect1>
250</article>
251