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