article.xml revision 260959
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]>
7<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
8  <info><title>&os; &release.current; Release Notes</title>
9
10  <author><orgname>The &os; Project</orgname></author>
11
12  <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/relnotes/article.xml 260959 2014-01-20 23:59:32Z gjb $</pubdate>
13
14  <copyright>
15    <year>2014</year>
16    <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
17      Project</holder>
18  </copyright>
19
20  <legalnotice xml:id="trademarks" role="trademarks">
21    &tm-attrib.freebsd;
22    &tm-attrib.ibm;
23    &tm-attrib.ieee;
24    &tm-attrib.intel;
25    &tm-attrib.sparc;
26    &tm-attrib.general;
27  </legalnotice>
28
29  <abstract>
30    <para>The release notes for &os; &release.current; contain
31      a summary of the changes made to the &os; base system on the
32      &release.branch; development line.  This document lists
33      applicable security advisories that were issued since the last
34      release, as well as significant changes to the &os; kernel and
35      userland.  Some brief remarks on upgrading are also
36      presented.</para>
37  </abstract>
38</info>
39
40<sect1 xml:id="intro">
41  <title>Introduction</title>
42
43  <para>This document contains the release notes for &os;
44    &release.current;.  It describes recently added, changed, or
45    deleted features of &os;.  It also provides some notes on
46    upgrading from previous versions of &os;.</para>
47
48  <para releasetype="current">The &release.type; distribution to which
49    these release notes apply represents the latest point along the
50    &release.branch; development branch since &release.branch; was
51    created.  Information regarding pre-built, binary &release.type;
52    distributions along this branch can be found at <uri
53      xlink:href="&release.url;">&release.url;</uri>.</para>
54
55  <para releasetype="snapshot">The &release.type; distribution to
56    which these release notes apply represents a point along the
57    &release.branch; development branch between &release.prev; and the
58    future &release.next;.  Information regarding pre-built, binary
59    &release.type; distributions along this branch can be found at
60    <uri xlink:href="&release.url;">&release.url;</uri>.</para>
61
62  <para releasetype="release">This distribution of &os;
63    &release.current; is a &release.type; distribution.  It can be
64    found at <uri xlink:href="&release.url;">&release.url;</uri> or
65    any of its mirrors.  More information on obtaining this (or other)
66    &release.type; distributions of &os; can be found in the <link
67      xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
68	&os;</quote> appendix</link> to the <link
69      xlink:href="&url.books.handbook;/">&os; Handbook</link>.</para>
70
71  <para>All users are encouraged to consult the release errata before
72    installing &os;.  The errata document is updated with
73    <quote>late-breaking</quote> information discovered late in the
74    release cycle or after the release.  Typically, it contains
75    information on known bugs, security advisories, and corrections to
76    documentation.  An up-to-date copy of the errata for &os;
77    &release.current; can be found on the &os; Web site.</para>
78</sect1>
79
80<sect1 xml:id="new">
81  <title>What's New</title>
82
83  <para>This section describes the most user-visible new or changed
84    features in &os; since &release.prev;.  In general, changes
85    described here are unique to the &release.branch; branch unless
86    specifically marked as &merged; features.</para>
87
88  <para>Typical release note items document recent security advisories
89    issued after &release.prev;, new drivers or hardware support, new
90    commands or options, major bug fixes, or contributed software
91    upgrades.  They may also list changes to major ports/packages or
92    release engineering practices.  Clearly the release notes cannot
93    list every single change made to &os; between releases; this
94    document focuses primarily on security advisories, user-visible
95    changes, and major architectural improvements.</para>
96
97  <sect2 xml:id="security">
98    <title>Security Advisories</title>
99
100    <para>No advisories.</para>
101
102  </sect2>
103
104  <sect2 xml:id="kernel">
105    <title>Kernel Changes</title>
106
107    <para revision="260903">Support for GPS ports has been added to
108      &man.uhso.4;.</para>
109
110    <para revision="260888">The <filename>VT</filename> kernel
111      configuration file has been added, which enables the new
112      <literal>vt</literal> console driver.</para>
113
114    <sect3 xml:id="kernel-virtualization">
115      <title>Virtualization support</title>
116
117      <para revision="260847">The &man.virtio_random.4; driver has
118	been added to harvest entropy from the host system.</para>
119
120      <para revision="260583">Unmapped IO support has been added to
121	&man.virtio_scsi.4;.</para>
122
123      <para revision="260582">Unmapped IO support has been added to
124	&man.virtio_blk.4;.</para>
125
126      <para revision="260532">Support for <quote>Posted Interrupt
127	  Processing</quote> is enabled if supported by the CPU.  This
128	feature can be disabled by running <literal>sysctl
129	  hw.vmm.vmx.use_apic_pir=0</literal>.  Additionally, to
130	persist this setting across reboots, add
131	<literal>hw.vmm.vmx.use_apic_pir=0</literal> to
132	<filename>/etc/sysctl.conf</filename>.</para>
133
134      <para revision="260410">Support for the <quote>Virtual Interrupt
135	  Delivery</quote> feature of &intel;&nbsp;VT-x is enabled if
136	supported by the CPU.  This feature can be disabled by running
137	<literal>sysctl hw.vmm.vmx.use_apic_vid=0</literal>.
138	Additionally, to persist this setting across reboots, add
139	<literal>hw.vmm.vmx.use_apic_vid=0</literal> to
140	<filename>/etc/sysctl.conf</filename>.</para>
141    </sect3>
142
143    <sect3 xml:id="kernel-arm">
144      <title>ARM support</title>
145
146      <para revision="260921">The &man.nand.4; device is enabled for
147	ARM devices by default.</para>
148    </sect3>
149
150    <sect3 xml:id="boot">
151      <title>Boot Loader Changes</title>
152
153      <para>&nbsp;</para>
154    </sect3>
155
156    <sect3 xml:id="proc">
157      <title>Hardware Support</title>
158
159      <sect4 xml:id="mm">
160	<title>Multimedia Support</title>
161
162	<para>&nbsp;</para>
163      </sect4>
164
165      <sect4 xml:id="net-if">
166	<title>Network Interface Support</title>
167
168	<para revision="260552">Firmware for &intel;
169	  Centrino&trade; Wireless-N 105 devices has been added
170	  to the base system.</para>
171
172	<para revision="260448">Support for the &intel;
173	  Centrino&trade; Wireless-N 135 chipset has been
174	  added.</para>
175      </sect4>
176    </sect3>
177
178    <sect3 xml:id="net-proto">
179      <title>Network Protocols</title>
180
181      <para>&nbsp;</para>
182    </sect3>
183
184    <sect3 xml:id="disks">
185      <title>Disks and Storage</title>
186
187      <para>&nbsp;</para>
188    </sect3>
189
190    <sect3 xml:id="fs">
191      <title>File Systems</title>
192
193      <para>&nbsp;</para>
194
195      <sect4 xml:id="fs-zfs">
196	<title>ZFS</title>
197
198	<para>&nbsp;</para>
199      </sect4>
200    </sect3>
201  </sect2>
202
203  <sect2 xml:id="userland">
204    <title>Userland Changes</title>
205
206    <para revision="260926">Support for displaying VPD for PCI devices
207      via &man.pciconf.8; has been added.</para>
208
209    <para revision="260913">A new flag, <quote>onifconsole</quote> has
210      been added to <filename>/etc/ttys</filename>.  This allows the
211      system to provide a login prompt via serial console if the
212      device is an active kernel console, otherwise it is equivalent
213      to <literal>off</literal>.</para>
214
215    <para revision="260910">Allow &man.pciconf.8; to identify PCI
216      devices that are attached to a driver to be identified by their
217      device name instead of just the selector.  Additionally, an
218      optional device argument to the <literal>-l</literal> flag
219      to restrict the output to only listing details about a single
220      device.</para>
221
222    <para revision="260594">When unable to load a kernel module with
223      &man.kldload.8;, a message informing to view output of
224      &man.dmesg.8; is now printed, opposed to the previous output
225      <quote>Exec format error.</quote>.</para>
226
227    <sect3 xml:id="rc-scripts">
228      <title><filename>/etc/rc.d</filename> Scripts</title>
229
230      <para>&nbsp;</para>
231    </sect3>
232  </sect2>
233
234  <sect2 xml:id="contrib">
235    <title>Contributed Software</title>
236
237    <para>&nbsp;</para>
238  </sect2>
239
240  <sect2 xml:id="ports">
241    <title>Ports/Packages Collection Infrastructure</title>
242
243    <para>&nbsp;</para>
244  </sect2>
245
246  <sect2 xml:id="releng">
247    <title>Release Engineering and Integration</title>
248
249    <para>&nbsp;</para>
250  </sect2>
251
252  <sect2 xml:id="doc">
253    <title>Documentation</title>
254
255    <para>&nbsp;</para>
256  </sect2>
257</sect1>
258
259<sect1 xml:id="upgrade">
260  <title>Upgrading from previous releases of &os;</title>
261
262  <para arch="amd64,i386">Binary upgrades between RELEASE versions
263    (and snapshots of the various security branches) are supported
264    using the &man.freebsd-update.8; utility.  The binary upgrade
265    procedure will update unmodified userland utilities, as well as
266    unmodified GENERIC kernels distributed as a part of an official
267    &os; release.  The &man.freebsd-update.8; utility requires that
268    the host being upgraded have Internet connectivity.</para>
269
270  <para>Source-based upgrades (those based on recompiling the &os;
271    base system from source code) from previous versions are
272    supported, according to the instructions in
273    <filename>/usr/src/UPDATING</filename>.</para>
274
275  <important>
276    <para>Upgrading &os; should only be attempted after backing up
277      <emphasis>all</emphasis> data and configuration files.</para>
278  </important>
279</sect1>
280</article>
281