article.xml revision 278263
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 278263 2015-02-05 14:12:05Z 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      <informaltable frame="none" pgwide="1">
142	<tgroup cols="3">
143	  <colspec colwidth="40%"/>
144	  <colspec colwidth="30%"/>
145	  <colspec colwidth="30%"/>
146	  <thead>
147	    <row>
148	      <entry>Advisory</entry>
149	      <entry>Date</entry>
150	      <entry>Topic</entry>
151	    </row>
152	  </thead>
153
154	  <tbody>
155	    <row>
156	      <entry><link
157		  xlink:href="&security.url;/FreeBSD-SA-14:27.stdio.asc">FreeBSD-SA-14:27.stdio</link></entry>
158	      <entry>10&nbsp;December&nbsp;2014</entry>
159	      <entry><para>Buffer overflow in stdio</para></entry>
160	    </row>
161
162	    <row>
163	      <entry><link
164		  xlink:href="&security.url;/FreeBSD-SA-14:28.file.asc">FreeBSD-SA-14:28.file</link></entry>
165	      <entry>10&nbsp;December&nbsp;2014</entry>
166	      <entry><para>Multiple vulnerabilities in &man.file.1;
167		and &man.libmagic.3;</para></entry>
168	    </row>
169
170	    <row>
171	      <entry><link
172		  xlink:href="&security.url;/FreeBSD-SA-14:30.unbound.asc">FreeBSD-SA-14:30.unbound</link></entry>
173	      <entry>17&nbsp;December&nbsp;2014</entry>
174	      <entry><para>Remote denial of service
175		vulnerability</para></entry>
176	    </row>
177
178	    <row>
179	      <entry><link
180		  xlink:href="&security.url;/FreeBSD-SA-14:31.ntp.asc">FreeBSD-SA-14:31.ntp</link></entry>
181	      <entry>23&nbsp;December&nbsp;2014</entry>
182	      <entry><para>Multiple vulnerabilities in NTP
183		suite</para></entry>
184	    </row>
185
186	    <row>
187	      <entry><link
188		  xlink:href="&security.url;/FreeBSD-SA-15:01.openssl.asc">FreeBSD-SA-15:01.openssl</link></entry>
189	      <entry>14&nbsp;January&nbsp;2015</entry>
190	      <entry><para>Multiple vulnerabilities in
191		OpenSSL</para></entry>
192	    </row>
193
194	    <row>
195	      <entry><link
196		  xlink:href="&security.url;/FreeBSD-SA-15:02.kmem.asc">FreeBSD-SA-15:02.kmem</link></entry>
197	      <entry>27&nbsp;January&nbsp;2015</entry>
198	      <entry><para>SCTP kernel memory corruption and
199		disclosure vulnerability</para></entry>
200	    </row>
201
202	    <row>
203	      <entry><link
204		  xlink:href="&security.url;/FreeBSD-SA-15:03.sctp.asc">FreeBSD-SA-15:03.sctp</link></entry>
205	      <entry>27&nbsp;January&nbsp;2015</entry>
206	      <entry><para>SCTP stream reset
207		vulnerability</para></entry>
208	    </row>
209	  </tbody>
210	</tgroup>
211      </informaltable>
212    </sect2>
213
214    <sect2 xml:id="errata">
215      <title>Errata Notices</title>
216
217      <informaltable frame="none" pgwide="1">
218	<tgroup cols="3">
219	  <colspec colwidth="40%"/>
220	  <colspec colwidth="30%"/>
221	  <colspec colwidth="30%"/>
222	  <thead>
223	    <row>
224	      <entry>Errata</entry>
225	      <entry>Date</entry>
226	      <entry>Topic</entry>
227	    </row>
228	  </thead>
229
230	  <tbody>
231	    <row>
232	      <entry><link
233		  xlink:href="&security.url;/FreeBSD-EN-14:13.freebsd-update.asc">FreeBSD-EN-14:13.freebsd-update</link></entry>
234	      <entry>23&nbsp;December&nbsp;2014</entry>
235	      <entry><para>Fixed directory deletion issue in
236		&man.freebsd-update.8;</para></entry>
237	    </row>
238	  </tbody>
239	</tgroup>
240      </informaltable>
241    </sect2>
242  </sect1>
243
244  <sect1 xml:id="userland">
245    <title>Userland</title>
246
247    <para>This section covers changes and additions to userland
248      applications, contributed software, and system utilities.</para>
249
250    <sect2 xml:id="userland-config">
251      <title>Userland Configuration Changes</title>
252
253      <para revision="276991">The &man.termcap.5; file is installed
254	as-is from sources, instead of reordering, creating
255	<filename>/etc/termcap.db</filename> by default, providing
256	a performance improvements to applications that use the
257	&man.termcap.5; database, such as &man.vi.1; and
258	&man.ncurses.3;.</para>
259    </sect2>
260
261    <sect2 xml:id="userland-programs">
262      <title>Userland Application Changes</title>
263
264      <para revision="275040">A new utility, &man.dpv.1;, has been
265	added to the base system, providing a &man.dialog.1;-style
266	progress view from one or more input streams.  A corresponding
267	library, &man.dpv.3;, has also been added.</para>
268
269      <para revision="275945">The &man.elfdump.1; utility has been
270	updated to support capability mode provided by
271	&man.capsicum.4;.</para>
272    </sect2>
273
274    <sect2 xml:id="userland-contrib">
275      <title>Contributed Software</title>
276
277      <para revision="277597"><application>OpenSSL</application> has
278	been updated to version 1.0.1l.</para>
279    </sect2>
280
281    <sect2 xml:id="userland-installer">
282      <title>Installation and Configuration Tools</title>
283
284      <para>&nbsp;</para>
285    </sect2>
286
287    <sect2 xml:id="userland-rc">
288      <title><filename class="directory">/etc/rc.d</filename>
289	Scripts</title>
290
291      <para>&nbsp;</para>
292    </sect2>
293
294    <sect2 xml:id="userland-periodic">
295      <title><filename class="directory">/etc/periodic</filename>
296	Scripts</title>
297
298      <para>&nbsp;</para>
299    </sect2>
300
301    <sect2 xml:id="userland-libraries">
302      <title>Runtime Libraries and API</title>
303
304      <para revision="275040">A new file configuration library,
305	&man.figpar.3;, has been added to the base system.</para>
306    </sect2>
307
308    <sect2 xml:id="userland-abi">
309      <title>ABI Compatibility</title>
310
311      <para>&nbsp;</para>
312    </sect2>
313  </sect1>
314
315  <sect1 xml:id="kernel">
316    <title>Kernel</title>
317
318    <para>This section covers changes to kernel configurations, system
319      tuning, and system control parameters that are not otherwise
320      categorized.</para>
321
322    <sect2 xml:id="kernel-bugfix">
323      <title>Kernel Bug Fixes</title>
324
325      <para>&nbsp;</para>
326    </sect2>
327
328    <sect2 xml:id="kernel-config">
329      <title>Kernel Configuration</title>
330
331      <para>&nbsp;</para>
332    </sect2>
333
334    <sect2 xml:id="kernel-sysctl">
335      <title>System Tuning and Controls</title>
336
337      <para revision="276986">Throttling via <acronym>ACPI</acronym>
338	and <acronym>P4TCC</acronym> via &man.device.hints.5; have
339	been turned off by default.</para>
340    </sect2>
341  </sect1>
342
343  <sect1 xml:id="drivers">
344    <title>Devices and Drivers</title>
345
346    <para>This section covers changes and additions to devices and
347      device drivers since &release.prev;.</para>
348
349    <sect2 xml:id="drivers-device">
350      <title>Device Drivers</title>
351
352      <para>&nbsp;</para>
353    </sect2>
354
355    <sect2 xml:id="drivers-storage">
356      <title>Storage Drivers</title>
357
358      <para>&nbsp;</para>
359    </sect2>
360
361    <sect2 xml:id="drivers-network">
362      <title>Network Drivers</title>
363
364      <para>&nbsp;</para>
365    </sect2>
366  </sect1>
367
368  <sect1 xml:id="hardware">
369    <title>Hardware Support</title>
370
371    <para>This section covers general hardware support for physical
372      machines, hypervisors, and virtualization environments, as well
373      as hardware changes and updates that do not otherwise fit in
374      other sections of this document.</para>
375
376    <sect2 xml:id="hardware-support">
377      <title>Hardware Support</title>
378
379      <para>&nbsp;</para>
380    </sect2>
381
382    <sect2 xml:id="hardware-virtualization">
383      <title>Virtualization Support</title>
384
385      <para>&nbsp;</para>
386    </sect2>
387
388    <sect2 xml:id="hardware-arm">
389      <title>ARM Support</title>
390
391      <para>&nbsp;</para>
392    </sect2>
393  </sect1>
394
395  <sect1 xml:id="storage">
396    <title>Storage</title>
397
398    <para>This section covers changes and additions to file systems
399      and other storage subsystems, both local and networked.</para>
400
401    <sect2 xml:id="storage-net">
402      <title>Networked Storage</title>
403
404      <para revision="274939" contrib="sponsor" sponsor="&ix;">The
405	&man.ctld.8; utility has been updated to include support for
406	registering <acronym>iSCSI</acronym> targets and portals on
407	<acronym>iSNS</acronym> servers.  This provides a mechanism
408	which allows <acronym>iSCSI</acronym> initiators to find
409	targets and portals without requiring active
410	discovery.</para>
411    </sect2>
412
413    <sect2 xml:id="storage-zfs">
414      <title>ZFS</title>
415
416      <para revision="275490">A new tunable,
417	<literal>vfs.zfs.spa_slop_shift</literal>, has been added,
418	which controls how much space is reserved by default.</para>
419    </sect2>
420
421    <sect2 xml:id="storage-geom">
422      <title>&man.geom.4;</title>
423
424      <para revision="275891" contrib="sponsor" sponsor="&ix;">The
425	&man.ctl.4; subsystem has been updated, increasing the ports
426	limit from <literal>128</literal> to <literal>256</literal>,
427	and <acronym>LUN</acronym> limit from <literal>256</literal>
428	to <literal>1024</literal>.</para>
429    </sect2>
430  </sect1>
431
432  <sect1 xml:id="boot">
433    <title>Boot Loader Changes</title>
434
435    <para>This section covers the boot loader, boot menu, and other
436      boot-related changes.</para>
437
438    <sect2 xml:id="boot-loader">
439      <title>Boot Loader Changes</title>
440
441      <para>&nbsp;</para>
442    </sect2>
443
444    <sect2 xml:id="boot-menu">
445      <title>Boot Menu Changes</title>
446
447      <para>&nbsp;</para>
448    </sect2>
449  </sect1>
450
451  <sect1 xml:id="network">
452    <title>Networking</title>
453
454    <para>This section describes changes that affect networking in
455      &os;.</para>
456
457    <sect2 xml:id="network-protocols">
458      <title>Network Procols</title>
459
460      <para>&nbsp;</para>
461    </sect2>
462  </sect1>
463
464  <sect1 xml:id="ports">
465    <title>Ports Collection and Package Infrastructure</title>
466
467    <para>This section covers changes to the &os;&nbsp;Ports
468      Collection, package infrastructure, and package maintenance and
469      installation tools.</para>
470
471    <sect2 xml:id="ports-infrastructure">
472      <title>Infrastructure Changes</title>
473
474      <para>&nbsp;</para>
475    </sect2>
476
477    <sect2 xml:id="ports-packages ">
478      <title>Packaging Changes</title>
479
480      <para>&nbsp;</para>
481    </sect2>
482  </sect1>
483
484  <sect1 xml:id="doc">
485    <title>Documentation</title>
486
487    <para>This section covers changes to the &os;&nbsp;Documentation
488      Project sources and toolchain.</para>
489
490    <sect2 xml:id="doc-sources">
491      <title>Documentation Source Changes</title>
492
493      <para>&nbsp;</para>
494    </sect2>
495
496    <sect2 xml:id="doc-toolchain">
497      <title>Documentation Toolchain Changes</title>
498
499      <para>&nbsp;</para>
500    </sect2>
501  </sect1>
502
503  <sect1 xml:id="releng">
504    <title>Release Engineering and Integration</title>
505
506    <para>This section convers changes that are specific to the
507      &os;&nbsp;Release Engineering processes.</para>
508
509    <sect2 xml:id="releng-changes">
510      <title>Integration Changes</title>
511
512      <para>&nbsp;</para>
513    </sect2>
514  </sect1>
515</article>
516