article.xml revision 276722 
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 276722 2015-01-05 20:34:06Z 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
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>
179      </sect3>
180
181      <sect3 xml:id="fs">
182	<title>File Systems</title>
183
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>
187      </sect3>
188    </sect2>
189
190    <sect2 xml:id="userland">
191      <title>Userland Changes</title>
192
193      <para revision="275040">A new file configuration library,
194	&man.figpar.3;, has been added to the base system.</para>
195
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>
200
201      <para revision="275945">The &man.elfdump.1; utility has been
202	updated to support capability mode provided by
203	&man.capsicum.4;.</para>
204
205      <sect3 xml:id="rc-scripts">
206	<title><filename>/etc/rc.d</filename> Scripts</title>
207
208	<para>&nbsp;</para>
209      </sect3>
210    </sect2>
211
212    <sect2 xml:id="contrib">
213      <title>Contributed Software</title>
214
215      <para>&nbsp;</para>
216    </sect2>
217
218    <sect2 xml:id="ports">
219      <title>Ports/Packages Collection Infrastructure</title>
220
221      <para>&nbsp;</para>
222    </sect2>
223
224    <sect2 xml:id="releng">
225      <title>Release Engineering and Integration</title>
226
227      <para>&nbsp;</para>
228    </sect2>
229
230    <sect2 xml:id="doc">
231      <title>Documentation</title>
232
233      <para>&nbsp;</para>
234    </sect2>
235  </sect1>
236
237  <sect1 xml:id="upgrade">
238    <title>Upgrading from Previous Releases of &os;</title>
239
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
247      connectivity.</para>
248
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>
253
254    <important>
255      <para>Upgrading &os; should only be attempted after
256	backing up <emphasis>all</emphasis> data and configuration
257	files.</para>
258    </important>
259  </sect1>
260</article>
261