article.xml revision 278258
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 278258 2015-02-05 13:07:41Z gjb $</pubdate>
22
23    <!-- Last rev: 276991 -->
24
25    <copyright>
26      <year>2015</year>
27      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
28	Project</holder>
29    </copyright>
30
31    <legalnotice xml:id="trademarks" role="trademarks">
32      &tm-attrib.freebsd;
33      &tm-attrib.ibm;
34      &tm-attrib.ieee;
35      &tm-attrib.intel;
36      &tm-attrib.sparc;
37      &tm-attrib.general;
38    </legalnotice>
39
40    <abstract>
41      <para>The release notes for &os; &release.current; contain
42	a summary of the changes made to the &os; base system on the
43	&release.branch; development line.  This document lists
44	applicable security advisories that were issued since the last
45	release, as well as significant changes to the &os; kernel and
46	userland.  Some brief remarks on upgrading are also
47	presented.</para>
48    </abstract>
49  </info>
50
51  <sect1 xml:id="intro">
52    <title>Introduction</title>
53
54    <para>This document contains the release notes for &os;
55      &release.current;.  It describes recently added, changed, or
56      deleted features of &os;.  It also provides some notes on
57      upgrading from previous versions of &os;.</para>
58
59    <para releasetype="current">The &release.type; distribution to
60      which these release notes apply represents the latest point
61      along the &release.branch; development branch since
62      &release.branch; was created.  Information regarding pre-built,
63      binary &release.type; distributions along this branch can be
64      found at <uri
65	xlink:href="&release.url;">&release.url;</uri>.</para>
66
67    <para releasetype="snapshot">The &release.type; distribution to
68      which these release notes apply represents a point along the
69      &release.branch; development branch between &release.prev; and
70      the future &release.next;.  Information regarding pre-built,
71      binary &release.type; distributions along this branch can be
72      found at <uri
73	xlink:href="&release.url;">&release.url;</uri>.</para>
74
75    <para releasetype="release">This distribution of &os;
76      &release.current; is a &release.type; distribution.  It can be
77      found at <uri xlink:href="&release.url;">&release.url;</uri> or
78      any of its mirrors.  More information on obtaining this (or
79      other) &release.type; distributions of &os; can be found in the
80      <link
81	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
82	  &os;</quote> appendix</link> to the <link
83	xlink:href="&url.books.handbook;/">&os;
84	Handbook</link>.</para>
85
86    <para>All users are encouraged to consult the release errata
87      before installing &os;.  The errata document is updated with
88      <quote>late-breaking</quote> information discovered late in the
89      release cycle or after the release.  Typically, it contains
90      information on known bugs, security advisories, and corrections
91      to documentation.  An up-to-date copy of the errata for &os;
92      &release.current; can be found on the &os; Web site.</para>
93
94    <para>This document describes the most user-visible new or changed
95      features in &os; since &release.prev;.</para>
96
97    <para>Typical release note items document recent security
98      advisories issued after &release.prev;, new drivers or hardware
99      support, new commands or options, major bug fixes, or
100      contributed software upgrades.  They may also list changes to
101      major ports/packages or release engineering practices.  Clearly
102      the release notes cannot list every single change made to &os;
103      between releases; this document focuses primarily on security
104      advisories, user-visible changes, and major architectural
105      improvements.</para>
106  </sect1>
107
108  <sect1 xml:id="upgrade">
109    <title>Upgrading from Previous Releases of &os;</title>
110
111    <para arch="amd64,i386">Binary upgrades between RELEASE versions
112      (and snapshots of the various security branches) are supported
113      using the &man.freebsd-update.8; utility.  The binary upgrade
114      procedure will update unmodified userland utilities, as well as
115      unmodified <filename>GENERIC</filename> kernel distributed as
116      a part of an official &os; release.  The &man.freebsd-update.8;
117      utility requires that the host being upgraded have Internet
118      connectivity.</para>
119
120    <para>Source-based upgrades (those based on recompiling the &os;
121      base system from source code) from previous versions are
122      supported, according to the instructions in
123      <filename>/usr/src/UPDATING</filename>.</para>
124
125    <important>
126      <para>Upgrading &os; should only be attempted after
127	backing up <emphasis>all</emphasis> data and configuration
128	files.</para>
129    </important>
130  </sect1>
131
132  <sect1 xml:id="security-errata">
133    <title>Security and Errata</title>
134
135    <para>This section lists the various Security Advisories and
136      Errata Notices since &release.prev;.</para>
137
138    <sect2 xml:id="security">
139      <title>Security Advisories</title>
140
141      <para>No advisories.</para>
142    </sect2>
143
144    <sect2 xml:id="errata">
145      <title>Errata Notices</title>
146
147      <para>No errata notices.</para>
148    </sect2>
149  </sect1>
150
151  <sect1 xml:id="userland">
152    <title>Userland</title>
153
154    <para>This section covers changes and additions to userland
155      applications, contributed software, and system utilities.</para>
156
157    <sect2 xml:id="userland-config">
158      <title>Userland Configuration Changes</title>
159
160      <para revision="276991">The &man.termcap.5; file is installed
161	as-is from sources, instead of reordering, creating
162	<filename>/etc/termcap.db</filename> by default, providing
163	a performance improvements to applications that use the
164	&man.termcap.5; database, such as &man.vi.1; and
165	&man.ncurses.3;.</para>
166    </sect2>
167
168    <sect2 xml:id="userland-programs">
169      <title>Userland Application Changes</title>
170
171      <para revision="275040">A new utility, &man.dpv.1;, has been
172	added to the base system, providing a &man.dialog.1;-style
173	progress view from one or more input streams.  A corresponding
174	library, &man.dpv.3;, has also been added.</para>
175
176      <para revision="275945">The &man.elfdump.1; utility has been
177	updated to support capability mode provided by
178	&man.capsicum.4;.</para>
179    </sect2>
180
181    <sect2 xml:id="userland-contrib">
182      <title>Contributed Software</title>
183
184      <para revision="277597"><application>OpenSSL</application> has
185	been updated to version 1.0.1l.</para>
186    </sect2>
187
188    <sect2 xml:id="userland-installer">
189      <title>Installation and Configuration Tools</title>
190
191      <para>&nbsp;</para>
192    </sect2>
193
194    <sect2 xml:id="userland-rc">
195      <title><filename class="directory">/etc/rc.d</filename>
196	Scripts</title>
197
198      <para>&nbsp;</para>
199    </sect2>
200
201    <sect2 xml:id="userland-periodic">
202      <title><filename class="directory">/etc/periodic</filename>
203	Scripts</title>
204
205      <para>&nbsp;</para>
206    </sect2>
207
208    <sect2 xml:id="userland-libraries">
209      <title>Runtime Libraries and API</title>
210
211      <para revision="275040">A new file configuration library,
212	&man.figpar.3;, has been added to the base system.</para>
213    </sect2>
214
215    <sect2 xml:id="userland-abi">
216      <title>ABI Compatibility</title>
217
218      <para>&nbsp;</para>
219    </sect2>
220  </sect1>
221
222  <sect1 xml:id="kernel">
223    <title>Kernel</title>
224
225    <para>This section covers changes to kernel configurations, system
226      tuning, and system control parameters that are not otherwise
227      categorized.</para>
228
229    <sect2 xml:id="kernel-bugfix">
230      <title>Kernel Bug Fixes</title>
231
232      <para>&nbsp;</para>
233    </sect2>
234
235    <sect2 xml:id="kernel-config">
236      <title>Kernel Configuration</title>
237
238      <para>&nbsp;</para>
239    </sect2>
240
241    <sect2 xml:id="kernel-sysctl">
242      <title>System Tuning and Controls</title>
243
244      <para revision="276986">Throttling via <acronym>ACPI</acronym>
245	and <acronym>P4TCC</acronym> via &man.device.hints.5; have
246	been turned off by default.</para>
247    </sect2>
248  </sect1>
249
250  <sect1 xml:id="drivers">
251    <title>Devices and Drivers</title>
252
253    <para>This section covers changes and additions to devices and
254      device drivers since &release.prev;.</para>
255
256    <sect2 xml:id="drivers-device">
257      <title>Device Drivers</title>
258
259      <para>&nbsp;</para>
260    </sect2>
261
262    <sect2 xml:id="drivers-storage">
263      <title>Storage Drivers</title>
264
265      <para>&nbsp;</para>
266    </sect2>
267
268    <sect2 xml:id="drivers-network">
269      <title>Network Drivers</title>
270
271      <para>&nbsp;</para>
272    </sect2>
273  </sect1>
274
275  <sect1 xml:id="hardware">
276    <title>Hardware Support</title>
277
278    <para>This section covers general hardware support for physical
279      machines, hypervisors, and virtualization environments, as well
280      as hardware changes and updates that do not otherwise fit in
281      other sections of this document.</para>
282
283    <sect2 xml:id="hardware-support">
284      <title>Hardware Support</title>
285
286      <para>&nbsp;</para>
287    </sect2>
288
289    <sect2 xml:id="hardware-virtualization">
290      <title>Virtualization Support</title>
291
292      <para>&nbsp;</para>
293    </sect2>
294
295    <sect2 xml:id="hardware-arm">
296      <title>ARM Support</title>
297
298      <para>&nbsp;</para>
299    </sect2>
300  </sect1>
301
302  <sect1 xml:id="storage">
303    <title>Storage</title>
304
305    <para>This section covers changes and additions to file systems
306      and other storage subsystems, both local and networked.</para>
307
308    <sect2 xml:id="storage-net">
309      <title>Networked Storage</title>
310
311      <para revision="274939" contrib="sponsor" sponsor="&ix;">The
312	&man.ctld.8; utility has been updated to include support for
313	registering <acronym>iSCSI</acronym> targets and portals on
314	<acronym>iSNS</acronym> servers.  This provides a mechanism
315	which allows <acronym>iSCSI</acronym> initiators to find
316	targets and portals without requiring active
317	discovery.</para>
318    </sect2>
319
320    <sect2 xml:id="storage-zfs">
321      <title>ZFS</title>
322
323      <para revision="275490">A new tunable,
324	<literal>vfs.zfs.spa_slop_shift</literal>, has been added,
325	which controls how much space is reserved by default.</para>
326    </sect2>
327
328    <sect2 xml:id="storage-geom">
329      <title>&man.geom.4;</title>
330
331      <para revision="275891" contrib="sponsor" sponsor="&ix;">The
332	&man.ctl.4; subsystem has been updated, increasing the ports
333	limit from <literal>128</literal> to <literal>256</literal>,
334	and <acronym>LUN</acronym> limit from <literal>256</literal>
335	to <literal>1024</literal>.</para>
336    </sect2>
337  </sect1>
338
339  <sect1 xml:id="boot">
340    <title>Boot Loader Changes</title>
341
342    <para>This section covers the boot loader, boot menu, and other
343      boot-related changes.</para>
344
345    <sect2 xml:id="boot-loader">
346      <title>Boot Loader Changes</title>
347
348      <para>&nbsp;</para>
349    </sect2>
350
351    <sect2 xml:id="boot-menu">
352      <title>Boot Menu Changes</title>
353
354      <para>&nbsp;</para>
355    </sect2>
356  </sect1>
357
358  <sect1 xml:id="network">
359    <title>Networking</title>
360
361    <para>This section describes changes that affect networking in
362      &os;.</para>
363
364    <sect2 xml:id="network-protocols">
365      <title>Network Procols</title>
366
367      <para>&nbsp;</para>
368    </sect2>
369  </sect1>
370
371  <sect1 xml:id="ports">
372    <title>Ports Collection and Package Infrastructure</title>
373
374    <para>This section covers changes to the &os;&nbsp;Ports
375      Collection, package infrastructure, and package maintenance and
376      installation tools.</para>
377
378    <sect2 xml:id="ports-infrastructure">
379      <title>Infrastructure Changes</title>
380
381      <para>&nbsp;</para>
382    </sect2>
383
384    <sect2 xml:id="ports-packages ">
385      <title>Packaging Changes</title>
386
387      <para>&nbsp;</para>
388    </sect2>
389  </sect1>
390
391  <sect1 xml:id="doc">
392    <title>Documentation</title>
393
394    <para>This section covers changes to the &os;&nbsp;Documentation
395      Project sources and toolchain.</para>
396
397    <sect2 xml:id="doc-sources">
398      <title>Documentation Source Changes</title>
399
400      <para>&nbsp;</para>
401    </sect2>
402
403    <sect2 xml:id="doc-toolchain">
404      <title>Documentation Toolchain Changes</title>
405
406      <para>&nbsp;</para>
407    </sect2>
408  </sect1>
409
410  <sect1 xml:id="releng">
411    <title>Release Engineering and Integration</title>
412
413    <para>This section convers changes that are specific to the
414      &os;&nbsp;Release Engineering processes.</para>
415
416    <sect2 xml:id="releng-changes">
417      <title>Integration Changes</title>
418
419      <para>&nbsp;</para>
420    </sect2>
421  </sect1>
422</article>
423